Recuperar feature de registro de horas / cobro por tiempo (RegistroHoras)

La cotización UJ2606AG777 (aprobada, "Agentes IA") se cobra por hora bajo
demanda, pero la rama desplegada (main) no incluía la feature de registro de
horas que sí existía en desarrollo (rama master): el cargo de horas de junio no
se veía en la web y los proyectos por tiempo no mostraban sus cobros en el panel
individual.

Se porta la feature de forma quirúrgica (sin arrastrar cambios no relacionados):

- Modelo RegistroHoras + columnas Cotizacion.incluirIva, Cliente.rfc,
  ServicioCotizado.beneficios (migración idempotente para la web).
- calculators.ts: modelo de cobro "demanda", helpers de horas
  (calcularHorasRango, agrupación por día/semana/mes, notas de pago).
- RegistroHorasPanel: panel para registrar/editar/borrar horas y previsualizar
  la nota de pago con branding. Solo aparece en cotizaciones aprobadas con cobro
  por tiempo (horas/retainer/demanda).
- PreciosEditables: los servicios "demanda" muestran la tarifa/hr en vez de $0.
- API /api/cotizaciones/[id]/horas (+ /[registroId]) para el CRUD de registros.
- Handlers de cotizaciones: persisten incluirIva/rfc/beneficios, "demanda" nunca
  suma al total, y fast-path para el cambio de estado (arregla CambiarEstado que
  fallaba la validación al enviar solo { estado }).
- .megaignore para evitar que MegaSync corrompa node_modules/.next.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

src/app/api/cotizaciones/[id]/horas/route.ts

@@ -0,0 +1,104 @@
+import { NextRequest, NextResponse } from "next/server";
+import { prisma } from "@/lib/db";
+import { registroHorasSchema } from "@/lib/schemas";
+import {
+  calcularHorasRango,
+  esCotizacionPorTiempo,
+  fechaRegistroDesdeISO,
+  tarifaHoraSugerida,
+} from "@/lib/calculators";
+
+// GET /api/cotizaciones/:id/horas?from=YYYY-MM-DD&to=YYYY-MM-DD
+// Lista los registros de horas de la cotizacion (orden cronologico). Filtros from/to
+// opcionales para acotar el periodo de una nota de pago.
+export async function GET(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const sp = request.nextUrl.searchParams;
+    const from = sp.get("from");
+    const to = sp.get("to");
+
+    const fechaFilter: { gte?: Date; lte?: Date } = {};
+    if (from && /^\d{4}-\d{2}-\d{2}$/.test(from)) fechaFilter.gte = fechaRegistroDesdeISO(from);
+    if (to && /^\d{4}-\d{2}-\d{2}$/.test(to)) fechaFilter.lte = fechaRegistroDesdeISO(to);
+
+    const registros = await prisma.registroHoras.findMany({
+      where: {
+        cotizacionId: id,
+        ...(Object.keys(fechaFilter).length > 0 && { fecha: fechaFilter }),
+      },
+      orderBy: [{ fecha: "asc" }, { horaInicio: "asc" }],
+    });
+
+    return NextResponse.json(registros);
+  } catch (error: unknown) {
+    const msg = error instanceof Error ? error.message : "Error interno";
+    return NextResponse.json({ error: msg }, { status: 500 });
+  }
+}
+
+// POST /api/cotizaciones/:id/horas
+// Crea un registro de horas. Solo para cotizaciones con cobro por tiempo. `horas` se
+// calcula del rango en el servidor; si la tarifa no viene, se usa la sugerida.
+export async function POST(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  try {
+    const { id } = await params;
+    const body = await request.json();
+
+    const parsed = registroHorasSchema.safeParse(body);
+    if (!parsed.success) {
+      return NextResponse.json(
+        { error: parsed.error.issues.map((i) => i.message).join(", ") },
+        { status: 400 }
+      );
+    }
+    const { fecha, horaInicio, horaFin, descripcion, tarifaHora } = parsed.data;
+
+    const horas = calcularHorasRango(horaInicio, horaFin);
+    if (horas <= 0) {
+      return NextResponse.json(
+        { error: "El rango de horas es invalido (la hora fin debe ser mayor a la de inicio)" },
+        { status: 400 }
+      );
+    }
+
+    const cot = await prisma.cotizacion.findUnique({
+      where: { id },
+      include: { servicios: true },
+    });
+    if (!cot) {
+      return NextResponse.json({ error: "Cotizacion no encontrada" }, { status: 404 });
+    }
+    if (!esCotizacionPorTiempo(cot.servicios)) {
+      return NextResponse.json(
+        { error: "Esta cotizacion no se cobra por tiempo; no admite registro de horas" },
+        { status: 400 }
+      );
+    }
+
+    const tarifa = tarifaHora ?? tarifaHoraSugerida(cot.servicios);
+
+    const registro = await prisma.registroHoras.create({
+      data: {
+        cotizacionId: id,
+        fecha: fechaRegistroDesdeISO(fecha),
+        horaInicio,
+        horaFin,
+        horas,
+        tarifaHora: tarifa,
+        descripcion: descripcion.trim(),
+      },
+    });
+
+    return NextResponse.json(registro, { status: 201 });
+  } catch (error: unknown) {
+    const msg = error instanceof Error ? error.message : "Error interno";
+    return NextResponse.json({ error: msg }, { status: 500 });
+  }
+}