feat(tenancies-p7): 4 module-gated dashboard widgets

- tenancy-reports.service.ts: 4 read-only query functions backing the
  widgets. Heatmap uses a months×areas SQL grid with date-range overlap;
  renewals-at-risk filters active tenancies whose end_date is inside a
  90d window with NO successor pending/active row already minted on the
  same berth; revenue forecast buckets active tenancies by their
  end-date quarter; tenure breakdown is a simple GROUP BY status='active'.
- 4 new API routes under /api/v1/dashboard/tenancy-*:
  - tenancy-occupancy (heatmap)
  - tenancy-renewals (at-risk list)
  - tenancy-revenue (forecast)
  - tenancy-tenure (breakdown)
  Each prepended with assertTenanciesModuleEnabled so a port without
  the module gets 404 instead of an empty payload.
- 4 widget components:
  - TenancyOccupancyHeatmapWidget — areas × months table with shaded
    cells (5-tier emerald ramp by occupancy %)
  - TenancyRenewalsAtRiskWidget — top-10 list, 30-day urgency badge
  - TenancyRevenueForecastWidget — horizontal bar list by quarter,
    currency-formatted totals
  - TenancyByTenureTypeWidget — proportional bars, color-coded per
    tenure type
- WidgetIntegration union extended with 'tenancies_module'; the
  useDashboardIntegrations hook reads it off PortProvider (no extra
  fetch). All four widgets register with selfGates=true +
  requires='tenancies_module' so the picker AND render path filter
  them out when the module is off.

Verified: tsc clean, 1493/1493 vitest.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/app/api/v1/dashboard/tenancy-occupancy/route.ts

@@ -0,0 +1,21 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { getOccupancyHeatmap } from '@/lib/services/tenancy-reports.service';
+import { assertTenanciesModuleEnabled } from '@/lib/services/tenancies-module.service';
+
+export const GET = withAuth(
+  withPermission('reports', 'view_dashboard', async (req: NextRequest, ctx) => {
+    await assertTenanciesModuleEnabled(ctx.portId);
+    const url = new URL(req.url);
+    const from = url.searchParams.get('from');
+    const to = url.searchParams.get('to');
+    const now = new Date();
+    const range = {
+      from: from ? new Date(from) : new Date(now.getFullYear(), now.getMonth() - 11, 1),
+      to: to ? new Date(to) : now,
+    };
+    const data = await getOccupancyHeatmap(ctx.portId, range);
+    return NextResponse.json({ data });
+  }),
+);

src/app/api/v1/dashboard/tenancy-renewals/route.ts

@@ -0,0 +1,15 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { getRenewalsAtRisk } from '@/lib/services/tenancy-reports.service';
+import { assertTenanciesModuleEnabled } from '@/lib/services/tenancies-module.service';
+
+export const GET = withAuth(
+  withPermission('reports', 'view_dashboard', async (req: NextRequest, ctx) => {
+    await assertTenanciesModuleEnabled(ctx.portId);
+    const url = new URL(req.url);
+    const windowDays = Number(url.searchParams.get('windowDays') ?? 90);
+    const data = await getRenewalsAtRisk(ctx.portId, { windowDays });
+    return NextResponse.json({ data });
+  }),
+);

src/app/api/v1/dashboard/tenancy-revenue/route.ts

@@ -0,0 +1,15 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { getRevenueForecast } from '@/lib/services/tenancy-reports.service';
+import { assertTenanciesModuleEnabled } from '@/lib/services/tenancies-module.service';
+
+export const GET = withAuth(
+  withPermission('reports', 'view_dashboard', async (req: NextRequest, ctx) => {
+    await assertTenanciesModuleEnabled(ctx.portId);
+    const url = new URL(req.url);
+    const horizonQuarters = Number(url.searchParams.get('horizonQuarters') ?? 8);
+    const data = await getRevenueForecast(ctx.portId, { horizonQuarters });
+    return NextResponse.json({ data });
+  }),
+);

src/app/api/v1/dashboard/tenancy-tenure/route.ts

@@ -0,0 +1,13 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+import { withAuth, withPermission } from '@/lib/api/helpers';
+import { getTenureTypeBreakdown } from '@/lib/services/tenancy-reports.service';
+import { assertTenanciesModuleEnabled } from '@/lib/services/tenancies-module.service';
+
+export const GET = withAuth(
+  withPermission('reports', 'view_dashboard', async (_req: NextRequest, ctx) => {
+    await assertTenanciesModuleEnabled(ctx.portId);
+    const data = await getTenureTypeBreakdown(ctx.portId);
+    return NextResponse.json({ data });
+  }),
+);