How freefiremax/paithan-digital-platform works
Paithan Digital Platform combines municipal information and administration, citizen services, heritage and tourism content, and a bilingual AI assistant. A principal citizen workflow is submitting a grievance, which the API validates, verifies, stores with a tracking number, and makes available for later tracking. Administrators manage civic content through protected APIs. Relationships below are grounded in the README or shown source references and excerpts; unsampled feature implementations are represented at their existing route directories, and their internal wiring is not inferred.
Main entry points: guard.ts Role and access checks · db.ts Prisma data store · grievances/route.ts Grievance intake · chatbot/route.ts Chatbot API
Components 30
Public information
- Public portal
app/[locale]/(public)/page.tsx - Council information
app/[locale]/(public)/nagar-parishad - Heritage exhibits
app/[locale]/(public)/heritage - Tourism guides
app/[locale]/(public)/tourism - Ward map
components/home/PaithanWardMap.tsx - Search interface
app/[locale]/search/SearchClient.tsx - Search API
app/api/search/route.ts
Civic services
- Grievance submission
app/[locale]/grievances/new/GrievanceForm.tsx - Grievance intake
app/api/grievances/route.ts - Ticket tracking
app/api/grievances/track/route.ts - Contact intake
app/api/contact/route.ts
Admin governance
- Governance CMS
app/[locale]/admin - Civic management API
app/api/admin - Sector management
app/api/sectors/[sector]/route.ts - Authenticated uploads
app/api/upload/route.ts
AI assistant
- Local knowledge base
lib/rag.ts - Chatbot API
app/api/chatbot/route.ts - Chat interface
components/chatbot/ChatInterface.tsx
Platform foundations
- Authentication
lib/auth/auth.ts - Role and access checks
lib/auth/guard.ts - Role permissions
lib/auth/permissions.ts - Prisma data store
lib/db.ts - Audit logging
lib/audit.ts - Rate limiting
lib/rate-limit.ts - Turnstile verification
lib/turnstile.ts - Security gate
components/security/CloudflareSecurityGate.tsx - Client providers
components/providers/ClientProviders.tsx - Media storage integration
lib/cloudinary.ts
Other components
- Citizen or visitor
- Google Gemini
Connections 33
- Citizen or visitor → Public portal: visits
- Public portal → Ward map: renders
app/[locale]/(public)/page.tsx - Citizen or visitor → Council information: explores
- Citizen or visitor → Heritage exhibits: explores
- Citizen or visitor → Tourism guides: explores
- Citizen or visitor → Search interface: searches
- Search interface → Search API: requests results
- Search API → Prisma data store: queries
app/api/search/route.ts - Citizen or visitor → Grievance submission: submits issue
- Grievance submission → Grievance intake: posts details
- Grievance intake → Turnstile verification: verifies token
app/api/grievances/route.ts - Grievance intake → Prisma data store: stores ticket
app/api/grievances/route.ts - Citizen or visitor → Ticket tracking: tracks ticket
- Citizen or visitor → Contact intake: sends message
- Governance CMS → Civic management API: manages records
- Civic management API → Role and access checks: checks access
app/api/admin/facilities/route.ts - Sector management → Role and access checks: checks access
app/api/sectors/[sector]/route.ts - Role and access checks → Authentication: reads session
lib/auth/guard.ts - Role and access checks → Role permissions: checks roles
lib/auth/guard.ts - Role and access checks → Prisma data store: loads user
lib/auth/guard.ts - Authentication → Prisma data store: uses adapter
lib/auth/auth.ts - Sector management → Prisma data store: reads and updates
app/api/sectors/[sector]/route.ts - Sector management → Audit logging: records change
app/api/sectors/[sector]/route.ts - Audit logging → Prisma data store: writes log
lib/audit.ts - Chat interface → Chatbot API: sends query
- Chatbot API → Local knowledge base: retrieves context
app/api/chatbot/route.ts - Chatbot API → Google Gemini: requests generation
app/api/chatbot/route.ts - Chatbot API → Rate limiting: checks quota
app/api/chatbot/route.ts - Grievance intake → Rate limiting: checks quota
app/api/grievances/route.ts - Client providers → Security gate: renders
components/providers/ClientProviders.tsx - Authenticated uploads → Role and access checks: requires login
app/api/upload/route.ts - Authenticated uploads → Media storage integration: uploads media
app/api/upload/route.ts - Authenticated uploads → Rate limiting: checks quota
app/api/upload/route.ts