Project Reports Dashboard
An editor-only governance dashboard providing report types that analyse the workspace via the Intent Graph, with signal-based parallel execution, 6 headline metrics, ECharts visualisations, guided fix navigation, and PDF export with verification.
Project Reports is an editor-only governance dashboard that analyses the entire workspace through the Intent Graph. Accessed via Reports > Project Reports, the dashboard runs distinct report types in parallel using a signal-based analysis engine. Reports regenerate automatically when the workspace changes, providing a continuously up-to-date view of project health across API coverage, schema integrity, governance compliance, entity lifecycle, lineage, data model quality, and documentation completeness.
Headline Metrics
The dashboard opens with a bar of 6 headline metric cards summarising the current state of the workspace at a glance.
| Metric | Description |
|---|---|
| Field Coverage | Percentage of schema fields mapped to database columns or graph properties via lineage |
| Broken Lineage | Count of lineage entries that reference deleted or renamed targets |
| Orphan Elements | Count of columns, properties, and model properties with no inbound references |
| API Completeness | Aggregate completeness score across all REST API endpoints |
| Schema Issues | Total count of schema health issues (circular inheritance, orphan schemas, type mismatches, etc.) |
| Endpoints | Total number of REST API endpoints in the workspace |
Report Tabs
Below the headline bar, tabs provide detailed reports. Each tab analyses a specific aspect of the workspace using Intent Graph edges and the workspace file index. Every issue includes a clickable file link that navigates directly to the relevant editor.
API and Data Reports
Schema and Cross-API Reports
Model and Coverage Reports
Governance Reports
Lifecycle Reports
Documentation Health
Data Model Quality
Analysis Engine
The analysis engine uses Angular signals to run all reports in parallel. When the explorer index rebuilds (after file saves, renames, or deletions), a 500ms debounce triggers re-analysis. Each report computes independently, so a slow report does not block others from displaying results. This means fixing an issue and saving the file immediately updates the relevant report tab, creating a tight identify-fix-verify feedback loop.
Visualisations
Reports include interactive charts rendered via ECharts (Apache 2.0), with a ResizeObserver-based deferred rendering system that handles charts in hidden tabs.
| Chart Type | Used In |
|---|---|
| Radial bar (multi-track) | Field coverage percentage, API completeness scores per API |
| Donut | Orphan element breakdown, schema health issues by type, broken lineage by severity, broken links by source |
| Heatmap | Cross-API shared schema matrix, API-to-database table matrix |
| Stacked bar | Covered vs orphan elements per table/node |
| Polar area | API completeness issue types, transition impact by resource category |
| Coverage bars | Governance compliance per rule, governance coverage per rule, model entity coverage |
PDF Export
The entire report dashboard can be exported as a professional PDF document. The export pipeline renders each report section individually using a print-optimised layout (sequential, no tabs), then merges them with post-processing: cover page, table of contents, page numbers, headers/footers, watermarks, bookmarks, and a verification page with SHA-256 content hash and git context. Individual report sections can be included or excluded via the section picker in the export dialog. The raw report JSON is attached as a file for independent verification. Password protection is available if configured.
Intent Graph Integration
Project Reports relies on these Intent Graph edge types to power its analysis.
| Edge Type | Used By |
|---|---|
| maps-to | API-to-Database Coverage, Broken Lineage, Orphan Elements, Safe-to-Delete (schema map count) |
| depends-on | Schema Health (inheritance chains), Cross-API Analysis (shared schemas) |
| references | Model Coverage, Broken Links (page/form references) |
| governs | Governance Compliance, Unlinked Entity Blocks, Governance Coverage, Safe-to-Delete (governs count) |
| replaced-by | Deprecation Impact (replacement suggestions), Safe-to-Delete (replacement availability) |
| evolved-from | Model Health (planned without derivation) |
| view-of | Safe-to-Delete (view count) |