How chaithumoorpa/svvd-thorur works
SVVD Thorur is a temple-management platform combining a multilingual public site, online seva booking, and staff administration. The principal workflow is a devotee browsing sevas and booking one; the backend validates the selected seva, creates a ticket, and records related operational data. Staff then manage tickets, donations, finance, and temple content through role-protected admin workflows. The map includes the documented auth, notifications, and storage capabilities. Some feature modules are represented by their exact tree paths; their internal wiring is not expanded where source excerpts were unavailable.
Main entry points: repositories Repositories · api.py API routes · seva_ticket_service.py Ticket service · donor_service.py Donations service
Components 23
Web experience
- Public pages
frontend/app/[locale]/(public) - Admin pages
frontend/app/admin - Seva booking UI
frontend/components/public/BookSeva.tsx - API client
frontend/lib/api.ts
API and access
- FastAPI app
backend/app/main.py - API routes
backend/app/api/v1/api.py - Auth routes
backend/app/api/v1/auth.py - Auth service
backend/app/services/auth_service.py - Seva ticket API
backend/app/api/v1/seva_tickets.py - Donor API
backend/app/api/v1/donors.py
Temple operations
- Ticket service
backend/app/services/seva_ticket_service.py - Donations service
backend/app/services/donor_service.py - Content services
backend/app/services - Finance services
backend/app/services/finance_service.py - Email notifications
backend/app/services/email_service.py
Persistence and integrations
- Domain models
backend/app/models - Repositories
backend/app/repositories - SQL database
backend/app/core/database.py - Object storage
backend/app/services/storage_service.py
Other components
- Devotee
- Temple staff
- AWS S3
- AWS SES
Connections 27
- Devotee → Public pages: browses
- Devotee → Seva booking UI: books seva
- Temple staff → Admin pages: manages
- Seva booking UI → API client: submits booking
- Public pages → API client: requests data
- Admin pages → API client: requests operations
- API client → FastAPI app: calls API
- FastAPI app → API routes: dispatches
- API routes → Auth routes: routes auth
- Auth routes → Auth service: invokes
- Auth service → Repositories: reads and writes
- API routes → Seva ticket API: routes tickets
- Seva ticket API → Ticket service: invokes
- Ticket service → Repositories: reads and writes
- API routes → Donor API: routes donations
- Donor API → Donations service: invokes
- Donations service → Repositories: reads and writes
- Ticket service → Finance services: records income
- Donations service → Finance services: syncs ledger
- Repositories → Domain models: queries
- Repositories → SQL database: persists
- Content services → Repositories: uses repositories
- Ticket service → Object storage: archives ticket
- Donations service → Object storage: archives receipt
- Object storage → AWS S3: uploads
- Auth routes → Email notifications: sends account email
- Email notifications → AWS SES: sends email