feat(reports): hours by client (CSV + UI), company contracted hours, UI to manage companies; adjust ticket list spacing

src/app/api/admin/companies/[id]/route.ts

@@ -16,6 +16,10 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ id
     if (key in body) updates[key] = body[key] ?? null
   }
   if ("isAvulso" in body) updates.isAvulso = Boolean(body.isAvulso)
+  if ("contractedHoursPerMonth" in body) {
+    const raw = body.contractedHoursPerMonth
+    updates.contractedHoursPerMonth = typeof raw === "number" ? raw : raw ? Number(raw) : null
+  }
 
   try {
     const company = await prisma.company.update({ where: { id }, data: updates as any })

src/app/api/admin/companies/route.ts

@@ -20,7 +20,7 @@ export async function POST(request: Request) {
   if (!session) return NextResponse.json({ error: "Não autorizado" }, { status: 401 })
 
   const body = await request.json()
-  const { name, slug, isAvulso, cnpj, domain, phone, description, address } = body ?? {}
+  const { name, slug, isAvulso, cnpj, domain, phone, description, address, contractedHoursPerMonth } = body ?? {}
   if (!name || !slug) {
     return NextResponse.json({ error: "Nome e slug são obrigatórios" }, { status: 400 })
   }
@@ -32,6 +32,7 @@ export async function POST(request: Request) {
         name: String(name),
         slug: String(slug),
         isAvulso: Boolean(isAvulso ?? false),
+        contractedHoursPerMonth: typeof contractedHoursPerMonth === "number" ? contractedHoursPerMonth : contractedHoursPerMonth ? Number(contractedHoursPerMonth) : null,
         cnpj: cnpj ? String(cnpj) : null,
         domain: domain ? String(domain) : null,
         phone: phone ? String(phone) : null,

src/app/api/reports/hours-by-client.csv/route.ts

@@ -0,0 +1,83 @@
+import { NextResponse } from "next/server"
+import { ConvexHttpClient } from "convex/browser"
+
+import { api } from "@/convex/_generated/api"
+import type { Id } from "@/convex/_generated/dataModel"
+import { env } from "@/lib/env"
+import { assertAuthenticatedSession } from "@/lib/auth-server"
+import { DEFAULT_TENANT_ID } from "@/lib/constants"
+
+export const runtime = "nodejs"
+
+function csvEscape(value: unknown): string {
+  const s = value == null ? "" : String(value)
+  if (/[",\n]/.test(s)) return '"' + s.replace(/"/g, '""') + '"'
+  return s
+}
+function rowsToCsv(rows: Array<Array<unknown>>): string {
+  return rows.map((row) => row.map(csvEscape).join(",")).join("\n") + "\n"
+}
+function msToHours(ms: number) {
+  return (ms / 3600000).toFixed(2)
+}
+
+export async function GET(request: Request) {
+  const session = await assertAuthenticatedSession()
+  if (!session) return NextResponse.json({ error: "Não autorizado" }, { status: 401 })
+  const convexUrl = env.NEXT_PUBLIC_CONVEX_URL
+  if (!convexUrl) return NextResponse.json({ error: "Convex não configurado" }, { status: 500 })
+
+  const { searchParams } = new URL(request.url)
+  const range = searchParams.get("range") ?? undefined
+
+  const client = new ConvexHttpClient(convexUrl)
+  const tenantId = session.user.tenantId ?? DEFAULT_TENANT_ID
+
+  let viewerId: string | null = null
+  try {
+    const ensuredUser = await client.mutation(api.users.ensureUser, {
+      tenantId,
+      name: session.user.name ?? session.user.email,
+      email: session.user.email,
+      avatarUrl: session.user.avatarUrl ?? undefined,
+      role: session.user.role.toUpperCase(),
+    })
+    viewerId = ensuredUser?._id ?? null
+  } catch (error) {
+    return NextResponse.json({ error: "Falha ao sincronizar usuário com Convex" }, { status: 500 })
+  }
+  if (!viewerId) return NextResponse.json({ error: "Usuário não encontrado no Convex" }, { status: 403 })
+
+  try {
+    const report = await client.query(api.reports.hoursByClient, {
+      tenantId,
+      viewerId: viewerId as unknown as Id<"users">,
+      range,
+    })
+
+    const rows: Array<Array<unknown>> = []
+    rows.push(["Relatório", "Horas por cliente"]) 
+    rows.push(["Período", report.rangeDays ? `Últimos ${report.rangeDays} dias` : (range ?? '90d')])
+    rows.push([])
+    rows.push(["Cliente", "Avulso", "Horas internas", "Horas externas", "Horas totais", "Horas contratadas/mês", "% uso"])
+    for (const item of report.items) {
+      const internalH = msToHours(item.internalMs)
+      const externalH = msToHours(item.externalMs)
+      const totalH = msToHours(item.totalMs)
+      const contracted = item.contractedHoursPerMonth ?? "—"
+      const pct = item.contractedHoursPerMonth ? ((item.totalMs / 3600000) / item.contractedHoursPerMonth * 100).toFixed(1) + "%" : "—"
+      rows.push([item.name, item.isAvulso ? "Sim" : "Não", internalH, externalH, totalH, contracted, pct])
+    }
+    const csv = rowsToCsv(rows)
+    return new NextResponse(csv, {
+      headers: {
+        "Content-Type": "text/csv; charset=UTF-8",
+        "Content-Disposition": `attachment; filename="hours-by-client-${tenantId}-${report.rangeDays ?? '90'}d.csv"`,
+        "Cache-Control": "no-store",
+      },
+    })
+  } catch (error) {
+    return NextResponse.json({ error: "Falha ao gerar CSV de horas por cliente" }, { status: 500 })
+  }
+}
+