How anandrajjee981-max/urbanshield-ai works
UrbanShield AI is a civic-issue platform spanning citizen reporting, administrator review, AI-assisted task planning, and authority work through resolution. The graph combines the documented product workflow with source-indexed backend and frontend entry points. Several workflow and analytics capabilities are documented but their implementing code was not sampled, so those subsystem paths and links are limited to exact directories or documented relationships; the graph does not imply that unsampled internals were inspected.
Main entry points: authority.dao.ts Authority data access · App.tsx Web application · app.ts API application · issue.dao.ts Issue data access
Components 34
Frontend application
- Web application
frontend/src/App.tsx - Issue reporting
frontend/src/pages/Reports.tsx - Admin review
frontend/src/pages/AdminReview.tsx - Authority tasks
frontend/src/pages/AuthorityTasks.tsx - Workflow state
frontend/src/store/slices/workflowSlice.ts - API client
frontend/src/services/api.ts - City insights
frontend/src/pages/MapPage.tsx - Weather forecasts
frontend/src/pages/WeatherPage.tsx - Weather service
frontend/src/services/weatherService.ts - Map service
frontend/src/services/mapService.ts
Backend API
- Issue endpoints
backend/src/routes/issue.routes.ts - Admin issue endpoints
backend/src/routes/admin-issue.routes.ts - Authority issue endpoints
backend/src/routes/authority-issue.routes.ts - Authentication
backend/src/routes/auth.routes.ts - API application
backend/src/app.ts - ImageKit storage
backend/src/service/image.service.ts
Issue and workforce workflow
- Issue review
backend/src/service/authority-issue.service.ts - Issue submission
backend/src/controller/issue.controller.ts - Admin task planning
backend/src/service/admin-issue.service.ts - Authority management
backend/src/service/authority.service.ts - Authority applications
backend/src/service/admin-authority.service.ts - AI assignment support
backend/src/service
Data and shared infrastructure
- Database configuration
backend/src/config/db.ts - Issue data access
backend/src/dao/issue.dao.ts - Authority data access
backend/src/dao/authority.dao.ts - Domain models
backend/src/models/issue.model.ts - Authentication middleware
backend/src/middleware/auth.middleware.ts - Request validation
backend/src/middleware/validate.middleware.ts - Domain types
backend/src/types/issue.types.ts - API utilities
backend/src/utils/api-response.ts
Other components
- Citizens
- Administrators
- Authorities
- ImageKit
Connections 38
- Citizens → Web application: use
- Administrators → Web application: use
- Authorities → Web application: use
- Web application → Admin review: routes to
frontend/src/App.tsx - Web application → Authority tasks: routes to
frontend/src/App.tsx - Citizens → Issue reporting: submit reports
- Administrators → Admin review: review issues
- Authorities → Authority tasks: update work
- Admin review → Workflow state: dispatches
frontend/src/pages/AdminReview.tsx - Authority tasks → Workflow state: dispatches
frontend/src/pages/AuthorityTasks.tsx - Workflow state → API client: requests data
- Issue reporting → API client: requests data
- City insights → Map service: uses
- Weather forecasts → Weather service: loads forecasts
- API application → Issue endpoints: mounts
backend/src/app.ts - API application → Admin issue endpoints: mounts
backend/src/app.ts - API application → Authority issue endpoints: mounts
backend/src/app.ts - API application → Authentication: mounts
backend/src/app.ts - Issue submission → Issue data access: reads and writes
backend/src/controller/issue.controller.ts - Issue review → Issue data access: reads and writes
backend/src/service/authority-issue.service.ts - Admin task planning → Authority data access: uses workforce data
- Authority applications → Authority data access: reads and writes
backend/src/service/admin-authority.service.ts - Authority management → Authority data access: reads and writes
backend/src/service/authority.service.ts - Administrators → AI assignment support: review recommendations
- Issue review → Admin task planning: verified issues enter planning
- Admin task planning → AI assignment support: requests analysis
- AI assignment support → Authorities: recommends assignment
- Authorities → Issue review: complete assigned work
- Issue submission → ImageKit storage: stores evidence
- ImageKit storage → ImageKit: uploads images
- Issue data access → Database configuration: uses database
backend/src/dao/issue.dao.ts - Authority data access → Database configuration: uses database
backend/src/dao/authority.dao.ts - Authority data access → Domain models: uses model
backend/src/dao/authority.dao.ts - Issue data access → Domain models: uses model
backend/src/dao/issue.dao.ts - Authority issue endpoints → Authentication middleware: requires authentication
backend/src/routes/authority-issue.routes.ts - Authority issue endpoints → Request validation: validates requests
backend/src/routes/authority-issue.routes.ts - Issue submission → API utilities: formats responses
backend/src/controller/issue.controller.ts - Authority applications → Authority data access: loads audit records
backend/src/service/admin-authority.service.ts