How srisaa-aegis/noc21 works
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: applications.ts PostgreSQL · app.routes.ts Role portals · api-endpoints.ts REST API catalogue · application.routes.ts Application routes
Components 21
Angular portals
- Role portals
frontend/src/app/app.routes.ts - Citizen lifecycle
frontend/src/app/features/citizen/wizard/wizard.ts - Department workspace
frontend/src/app/features/dept/application-view.ts - Admin console
frontend/src/app/features/admin/applications.ts - REST API catalogue
frontend/src/app/core/api/api-endpoints.ts
Backend services
- Fastify API
backend/src/app.ts - Application routes
backend/src/routes/application.routes.ts - Identity service
backend/src/services/auth.service.ts - Citizen service
backend/src/services/citizen.service.ts - Application reads
backend/src/services/application.service.ts - Department processing
backend/src/services/dept.service.ts - Administration
backend/src/services/admin.service.ts - Application serializer
backend/src/serializers/application.serializer.ts - Reports, escalations, jobs
backend/src/jobs/scheduler.ts
Business engines
- Fire-NOC domain
packages/noc-domain/src/decision-preview.ts - Rules engine
packages/rules-engine/src/engine.ts - Workflow engine
packages/workflow-engine/src/engine.ts
Persistence and operations
- Application repository
backend/src/repositories/application.repo.ts - PostgreSQL
backend/src/db/schema/applications.ts - Document storage
backend/src/storage/storage.ts
Other components
- Portal users
Connections 24
- Portal users → Role portals: use role portal
- Role portals → Citizen lifecycle: offers citizen flow
frontend/src/app/app.routes.ts - Role portals → Department workspace: offers staff flow
frontend/src/app/app.routes.ts - Role portals → Admin console: offers admin flow
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
backend/src/app.ts - Application routes → Citizen service: creates and saves
backend/src/routes/application.routes.ts - Application routes → Application reads: reads applications
backend/src/routes/application.routes.ts - Application reads → Application repository: loads aggregates
backend/src/services/application.service.ts - Application reads → Application serializer: serializes results
backend/src/services/application.service.ts - Application serializer → Fire-NOC domain: maps domain shapes
backend/src/serializers/application.serializer.ts - Identity service → PostgreSQL: reads identity state
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