# srisaa-aegis/noc21 architecture

> Architecture diagram of the GitHub repository srisaa-aegis/noc21, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/srisaa-aegis/noc21
- Repository: https://github.com/srisaa-aegis/noc21

## Overview

NOC Portal is a Fire Department No-Objection Certificate system for citizens/builders, department staff, and administrators. Citizens authenticate, create and submit applications with supporting documents, then track decisions and receive certificates; staff process applications through configurable workflows, while admins manage accounts, rules, workflows, and service levels. The Angular portals use a REST catalogue to reach the Fastify backend, which applies domain logic and persists data in PostgreSQL. The README documents reports, escalations, and jobs, but their detailed runtime wiring was not sampled; those links are therefore omitted or marked unverified.

Main entry points: [`backend/src/db/schema/applications.ts`](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/db/schema/applications.ts) (PostgreSQL), [`frontend/src/app/app.routes.ts`](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/app.routes.ts) (Role portals), [`frontend/src/app/core/api/api-endpoints.ts`](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/core/api/api-endpoints.ts) (REST API catalogue), [`backend/src/routes/application.routes.ts`](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/routes/application.routes.ts) (Application routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular portals"]
  node_portal["Role portals<br/>[app.routes.ts]"]
  node_citizen["Citizen lifecycle<br/>[wizard.ts]"]
  node_department["Department workspace"]
  node_administration["Admin console<br/>[applications.ts]"]
  node_api_client["REST API catalogue<br/>[api-endpoints.ts]"]
end

subgraph group_api["Backend services"]
  node_server["Fastify API<br/>[app.ts]"]
  node_application_routes["Application routes"]
  node_auth["Identity service<br/>[auth.service.ts]"]
  node_citizen_service["Citizen service<br/>[citizen.service.ts]"]
  node_application_service["Application reads"]
  node_department_service["Department processing<br/>[dept.service.ts]"]
  node_admin_service["Administration<br/>[admin.service.ts]"]
  node_serializer["Application serializer"]
  node_operations["Reports, escalations, jobs<br/>[scheduler.ts]"]
end

subgraph group_domain["Business engines"]
  node_noc_domain["Fire-NOC domain"]
  node_rules_engine["Rules engine<br/>[engine.ts]"]
  node_workflow_engine["Workflow engine<br/>[engine.ts]"]
end

subgraph group_state["Persistence and operations"]
  node_repository["Application repository"]
  node_database[("PostgreSQL<br/>[applications.ts]")]
  node_storage["Document storage<br/>[storage.ts]"]
end

node_users(("Portal users"))

node_users -->|"use role portal"| node_portal
node_portal -->|"offers citizen flow"| node_citizen
node_portal -->|"offers staff flow"| node_department
node_portal -->|"offers admin flow"| node_administration
node_citizen -->|"request operations"| node_api_client
node_department -->|"request operations"| node_api_client
node_administration -->|"request operations"| node_api_client
node_api_client -->|"calls REST API"| node_server
node_server -->|"registers routes"| node_application_routes
node_application_routes -->|"creates and saves"| node_citizen_service
node_application_routes -->|"reads applications"| node_application_service
node_application_service -->|"loads aggregates"| node_repository
node_application_service -->|"serializes results"| node_serializer
node_serializer -->|"maps domain shapes"| node_noc_domain
node_auth -->|"reads identity state"| node_database
node_repository -.->|"queries application data"| node_database
node_citizen_service -.->|"writes lifecycle data"| node_database
node_department_service -.->|"applies workflow"| node_workflow_engine
node_department_service -.->|"persists processing"| node_database
node_admin_service -.->|"manages portal data"| node_database
node_noc_domain -.->|"uses business rules"| node_rules_engine
node_noc_domain -.->|"binds workflows"| node_workflow_engine
node_citizen_service -.->|"stores documents"| node_storage
node_operations -.->|"runs scheduled work"| node_database

click node_portal "https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/app.routes.ts"
click node_citizen "https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/citizen/wizard/wizard.ts"
click node_department "https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/dept/application-view.ts"
click node_administration "https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/admin/applications.ts"
click node_api_client "https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/core/api/api-endpoints.ts"
click node_server "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/app.ts"
click node_application_routes "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/routes/application.routes.ts"
click node_auth "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/auth.service.ts"
click node_citizen_service "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/citizen.service.ts"
click node_application_service "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/application.service.ts"
click node_department_service "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/dept.service.ts"
click node_admin_service "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/admin.service.ts"
click node_repository "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/repositories/application.repo.ts"
click node_serializer "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/serializers/application.serializer.ts"
click node_noc_domain "https://github.com/srisaa-aegis/noc21/blob/main/packages/noc-domain/src/decision-preview.ts"
click node_rules_engine "https://github.com/srisaa-aegis/noc21/blob/main/packages/rules-engine/src/engine.ts"
click node_workflow_engine "https://github.com/srisaa-aegis/noc21/blob/main/packages/workflow-engine/src/engine.ts"
click node_database "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/db/schema/applications.ts"
click node_storage "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/storage/storage.ts"
click node_operations "https://github.com/srisaa-aegis/noc21/blob/main/backend/src/jobs/scheduler.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_portal,node_citizen,node_department,node_administration,node_api_client,node_users toneBlue
class node_server,node_application_routes,node_auth,node_citizen_service,node_application_service,node_department_service,node_admin_service,node_serializer,node_operations toneAmber
class node_noc_domain,node_rules_engine,node_workflow_engine toneMint
class node_repository,node_database,node_storage toneRose
```

## Components

### Angular portals

- [Role portals](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Citizen lifecycle](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/citizen/wizard/wizard.ts): `frontend/src/app/features/citizen/wizard/wizard.ts`
- [Department workspace](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/dept/application-view.ts): `frontend/src/app/features/dept/application-view.ts`
- [Admin console](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/features/admin/applications.ts): `frontend/src/app/features/admin/applications.ts`
- [REST API catalogue](https://github.com/srisaa-aegis/noc21/blob/main/frontend/src/app/core/api/api-endpoints.ts): `frontend/src/app/core/api/api-endpoints.ts`

### Backend services

- [Fastify API](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Application routes](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/routes/application.routes.ts): `backend/src/routes/application.routes.ts`
- [Identity service](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Citizen service](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/citizen.service.ts): `backend/src/services/citizen.service.ts`
- [Application reads](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/application.service.ts): `backend/src/services/application.service.ts`
- [Department processing](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/dept.service.ts): `backend/src/services/dept.service.ts`
- [Administration](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/services/admin.service.ts): `backend/src/services/admin.service.ts`
- [Application serializer](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/serializers/application.serializer.ts): `backend/src/serializers/application.serializer.ts`
- [Reports, escalations, jobs](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/jobs/scheduler.ts): `backend/src/jobs/scheduler.ts`

### Business engines

- [Fire-NOC domain](https://github.com/srisaa-aegis/noc21/blob/main/packages/noc-domain/src/decision-preview.ts): `packages/noc-domain/src/decision-preview.ts`
- [Rules engine](https://github.com/srisaa-aegis/noc21/blob/main/packages/rules-engine/src/engine.ts): `packages/rules-engine/src/engine.ts`
- [Workflow engine](https://github.com/srisaa-aegis/noc21/blob/main/packages/workflow-engine/src/engine.ts): `packages/workflow-engine/src/engine.ts`

### Persistence and operations

- [Application repository](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/repositories/application.repo.ts): `backend/src/repositories/application.repo.ts`
- [PostgreSQL](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/db/schema/applications.ts): `backend/src/db/schema/applications.ts`
- [Document storage](https://github.com/srisaa-aegis/noc21/blob/main/backend/src/storage/storage.ts): `backend/src/storage/storage.ts`

### Other components

- **Portal users**

## Connections

- Portal users → Role portals: use role portal
- Role portals → Citizen lifecycle: offers citizen flow (evidence: `frontend/src/app/app.routes.ts`)
- Role portals → Department workspace: offers staff flow (evidence: `frontend/src/app/app.routes.ts`)
- Role portals → Admin console: offers admin flow (evidence: `frontend/src/app/app.routes.ts`)
- Citizen lifecycle → REST API catalogue: request operations
- Department workspace → REST API catalogue: request operations
- Admin console → REST API catalogue: request operations
- REST API catalogue → Fastify API: calls REST API
- Fastify API → Application routes: registers routes (evidence: `backend/src/app.ts`)
- Application routes → Citizen service: creates and saves (evidence: `backend/src/routes/application.routes.ts`)
- Application routes → Application reads: reads applications (evidence: `backend/src/routes/application.routes.ts`)
- Application reads → Application repository: loads aggregates (evidence: `backend/src/services/application.service.ts`)
- Application reads → Application serializer: serializes results (evidence: `backend/src/services/application.service.ts`)
- Application serializer → Fire-NOC domain: maps domain shapes (evidence: `backend/src/serializers/application.serializer.ts`)
- Identity service → PostgreSQL: reads identity state (evidence: `backend/src/services/auth.service.ts`)
- Application repository → PostgreSQL: queries application data
- Citizen service → PostgreSQL: writes lifecycle data
- Department processing → Workflow engine: applies workflow
- Department processing → PostgreSQL: persists processing
- Administration → PostgreSQL: manages portal data
- Fire-NOC domain → Rules engine: uses business rules
- Fire-NOC domain → Workflow engine: binds workflows
- Citizen service → Document storage: stores documents
- Reports, escalations, jobs → PostgreSQL: runs scheduled work
