How rishisinhasly7/citypulse works
CityPulse is a civic-issue reporting and agency-management web app. The main workflow is citizen intake, issue registration in Firestore, public map/list monitoring, agency review and status updates, then citizen confirmation, dispute/appeal oversight, and performance reporting. App.tsx is the sampled coordinator for intake, role verification, and some resolution handling; AgencyPortal provides agency operations. Other major capabilities are represented from the source index and README-adjacent source excerpts, but unsampled wiring is not inferred.
Main entry points: App.tsx Portal Coordinator · db.ts Issue And Profile Data · LanguageContext.tsx Language Context · ReportIssueModal.tsx Issue Intake
Components 15
Application Coordination
- Portal Coordinator
src/App.tsx
Citizen Reporting
- Issue Intake
src/components/ReportIssueModal.tsx - Manual Location
src/components/ManualLocationPicker.tsx - Issue Card
src/components/IssueCard.tsx - Civic Map
src/components/CivicMapAnimation.tsx
Agency Operations
- Agency Workspace
src/components/AgencyPortal.tsx
Oversight And Insights
- Agency Scorecard
src/components/StatsDashboard.tsx
Shared Platform
- Issue And Profile Data
src/utils/db.ts - Firestore
- Firebase Setup
src/firebase.ts - Sample Issue Records
src/initialData.ts - Civic Domain Types
src/types.ts - Language Context
src/components/LanguageContext.tsx - English And Hindi Text
src/utils/translation.ts
Other components
- Portal User
Connections 23
- Portal User → Portal Coordinator: uses portal
- Portal Coordinator → Issue Intake: opens intake
src/App.tsx - Issue Intake → Portal Coordinator: submits report
src/App.tsx - Portal Coordinator → Issue And Profile Data: registers issue
src/App.tsx - Issue And Profile Data → Firestore: reads and writes
src/utils/db.ts - Issue And Profile Data → Firebase Setup: uses database setup
src/utils/db.ts - Firebase Setup → Firestore: initializes
src/firebase.ts - Issue And Profile Data → Sample Issue Records: seeds empty store
src/utils/db.ts - Portal Coordinator → Agency Workspace: shows workspace
src/App.tsx - Agency Workspace → Firestore: updates complaints
- Portal Coordinator → Firestore: confirms resolution
src/App.tsx - Portal Coordinator → Civic Map: shows issue map
src/App.tsx - Portal Coordinator → Issue Card: shows issue details
src/App.tsx - Portal Coordinator → Agency Scorecard: shows scorecard
src/App.tsx - Portal Coordinator → Manual Location: offers manual location
src/App.tsx - Portal Coordinator → Issue And Profile Data: verifies profile
src/App.tsx - Issue Intake → Language Context: reads translations
src/components/ReportIssueModal.tsx - Issue Card → Language Context: reads translations
src/components/IssueCard.tsx - Civic Map → Language Context: reads translations
src/components/CivicMapAnimation.tsx - Language Context → English And Hindi Text: selects language text
src/components/LanguageContext.tsx - Issue And Profile Data → Civic Domain Types: uses domain records
src/utils/db.ts - Portal Coordinator → Civic Domain Types: uses issue records
src/App.tsx - Agency Workspace → Civic Domain Types: uses issue records
src/components/AgencyPortal.tsx