How ch1n7u/bcnp works
Bharat Cyber Nyay Portal is a multi-role cybercrime reporting and case-tracking application. Citizens register or sign in, file reports, submit evidence, and track case progress; administrators assign cases and investigators update status and notes. The portal also documents anonymous reporting and analytics capabilities. The map follows the frontend-to-API boundary and sampled backend calls; some feature connections are documented in the README rather than verified in sampled implementation. The database is Supabase-backed, with evidence files handled through Supabase Storage.
Main entry points: index.js Route Registry · app Portal Pages · db.js Supabase Database · authController.js Identity Operations
Components 32
Citizen Portal
- Portal Pages
frontend/src/app - Authentication UI
frontend/src/components/AuthForm.jsx - Report Submission
frontend/src/components/ReportForm.jsx - Case Dashboards
frontend/src/components/AdminCaseAssignment.jsx - Case Tracking UI
frontend/src/components/CaseTracker.jsx - Auth Context
frontend/src/context/AuthContext.js - API Client
frontend/src/lib/api.js
API and Access
- Express App
backend/src/app.js - Route Registry
backend/src/routes/index.js - Auth Routes
backend/src/routes/authRoutes.js - Case Routes
backend/src/routes/caseRoutes.js - Admin Routes
backend/src/routes/adminRoutes.js - Report Routes
backend/src/routes/reportRoutes.js - Evidence Routes
backend/src/routes/evidenceRoutes.js - Analytics Routes
backend/src/routes/analyticsRoutes.js - Identity Operations
backend/src/controllers/authController.js
Case Operations
- Case Management
backend/src/controllers/caseController.js - Administration
backend/src/controllers/adminController.js - Report Intake
backend/src/controllers/reportController.js - Evidence Handling
backend/src/controllers/evidenceController.js - Public Tracking
backend/src/controllers/trackingController.js - Portal Analytics
backend/src/controllers/analyticsController.js
Data and Services
- Supabase Database
backend/src/config/db.js - User Model
backend/src/models/userModel.js - Case Timeline
backend/src/services/caseTimelineService.js - Audit Logging
backend/src/services/auditLogger.js - Email Delivery
backend/src/utils/mailer.js - Evidence File Storage
backend/src/controllers/evidenceController.js
Other components
- Citizen
- Investigator
- Administrator
- Supabase Service
Connections 40
- Citizen → Portal Pages: uses
- Investigator → Portal Pages: uses
- Administrator → Portal Pages: uses
- Portal Pages → Authentication UI: offers sign-in
- Portal Pages → Report Submission: offers reporting
- Portal Pages → Case Dashboards: offers case tools
- Portal Pages → Case Tracking UI: offers tracking
- Authentication UI → Auth Context: updates
frontend/src/components/AuthForm.jsx - Authentication UI → API Client: calls
frontend/src/components/AuthForm.jsx - Report Submission → API Client: submits reports
- Case Tracking UI → API Client: requests status
- API Client → Express App: sends API requests
- Express App → Route Registry: mounts
backend/src/app.js - Route Registry → Auth Routes: registers
backend/src/routes/index.js - Route Registry → Case Routes: registers
backend/src/routes/index.js - Route Registry → Admin Routes: registers
backend/src/routes/index.js - Route Registry → Report Routes: registers
backend/src/routes/index.js - Route Registry → Evidence Routes: registers
backend/src/routes/index.js - Route Registry → Analytics Routes: registers
backend/src/routes/index.js - Auth Routes → Identity Operations: dispatches
backend/src/routes/authRoutes.js - Case Routes → Case Management: dispatches
backend/src/routes/caseRoutes.js - Admin Routes → Administration: dispatches
backend/src/routes/adminRoutes.js - Report Routes → Report Intake: dispatches
- Evidence Routes → Evidence Handling: dispatches
- Analytics Routes → Portal Analytics: dispatches
- Identity Operations → User Model: looks up users
backend/src/controllers/authController.js - User Model → Supabase Database: queries
backend/src/models/userModel.js - Identity Operations → Supabase Database: reads and writes
backend/src/controllers/authController.js - Identity Operations → Email Delivery: sends welcome email
backend/src/controllers/authController.js - Identity Operations → Audit Logging: records events
backend/src/controllers/authController.js - Case Management → Supabase Database: reads and writes
backend/src/controllers/caseController.js - Case Management → Case Timeline: records case events
backend/src/controllers/caseController.js - Case Management → Audit Logging: records actions
backend/src/controllers/caseController.js - Case Timeline → Supabase Database: persists timeline
backend/src/services/caseTimelineService.js - Evidence Handling → Supabase Database: stores evidence metadata
backend/src/controllers/evidenceController.js - Evidence Handling → Evidence File Storage: uploads and downloads
backend/src/controllers/evidenceController.js - Evidence Handling → Case Timeline: records uploads
backend/src/controllers/evidenceController.js - Evidence Handling → Audit Logging: records uploads
backend/src/controllers/evidenceController.js - Supabase Database → Supabase Service: connects to
backend/src/config/db.js - Evidence File Storage → Supabase Service: uses file storage
backend/src/controllers/evidenceController.js