Files
pn-new-crm/src/app/api/v1/dashboard/tenancy-occupancy/route.ts

22 lines
864 B
TypeScript
Raw Normal View History

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>
2026-05-25 15:34:43 +02:00
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 });
}),
);