Matt
db14056018
- 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>
22 lines
864 B
TypeScript
22 lines
864 B
TypeScript
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 });
|
|
}),
|
|
);
|