How biranchikulesika/netram works
Netram is a government-institution monitoring platform. Authorities use the web workspaces to review projects, inspections, grievances, funding, and live signals; inspectors capture field evidence in the mobile app, including offline. The API is the authoritative workflow layer for permissions and lifecycle changes, backed by shared persistence and object storage. CCTV streaming, advisory anomaly review, and authorized realtime delivery are major complementary capabilities. Relationships below follow README-documented flows and the supplied source excerpts; unsampled domain internals are represented by their existing module directories.
Main entry points: app.ts REST API · dashboard Web workspaces · inspections Inspection lifecycle · server.ts Realtime hub
Components 22
User applications
- Web workspaces
apps/web/app/dashboard - Inspector app
apps/inspector-mobile/app
Operational workflows
- Project registry
services/api/src/modules/projects - Inspection lifecycle
services/api/src/modules/inspections - Corrective actions
services/api/src/modules/corrective-actions - Grievances
services/api/src/modules/complaints - Evidence capture
services/api/src/modules/evidence - Attendance reconciliation
services/api/src/modules/attendance - Funds and expenses
services/api/src/modules/funds
Core platform
- REST API
services/api/src/app.ts - Auth and access
services/api/src/modules/authorization/application/authorization-service.ts
Monitoring signals
- Financial risk
services/api/src/modules/financial-risk - Advisory AI
services/ai/app/main.py - CCTV controls
services/api/src/modules/cctv - CCTV gateway
services/cctv-gateway/src/server.ts - Realtime hub
services/realtime/src/server.ts
Shared infrastructure
- PostgreSQL
packages/data/src/db/schema.ts - Object storage
services/api/src/infrastructure/object-storage.ts - Shared contracts
packages/types/src
Other components
- Public authorities
- Field inspectors
- MediaMTX
Connections 23
- Public authorities → Web workspaces: review workflows
README.md - Field inspectors → Inspector app: capture inspections
README.md - Web workspaces → REST API: request operations
- Inspector app → REST API: sync operations
README.md - REST API → Auth and access: enforce access
README.md - REST API → Project registry: route project operations
services/api/src/modules/projects/http/routes.ts - REST API → Attendance reconciliation: route attendance operations
services/api/src/modules/attendance/http/routes.ts - REST API → Funds and expenses: route fund operations
services/api/src/modules/funds/http/routes.ts - REST API → CCTV controls: route camera operations
services/api/src/modules/cctv/http/routes.ts - REST API → Inspection lifecycle: manage lifecycle
README.md - Inspection lifecycle → Corrective actions: raise corrective actions
README.md - Inspection lifecycle → Evidence capture: record evidence
README.md - REST API → Grievances: manage grievances
README.md - REST API → Financial risk: evaluate financial signals
README.md - Attendance reconciliation → Advisory AI: provide anomaly inputs
README.md - CCTV controls → CCTV gateway: request stream control
README.md - CCTV gateway → MediaMTX: provision media paths
- REST API → PostgreSQL: persist authoritative state
README.md - REST API → Object storage: store evidence objects
README.md - Realtime hub → PostgreSQL: poll outbox
services/realtime/src/server.ts - Realtime hub → Web workspaces: deliver authorized events
README.md - REST API → Shared contracts: use domain contracts
README.md - Financial risk → Web workspaces: surface review signals
README.md