How abuomar121/sair-server works
SAIR is a Dart Frog backend for accident reporting. Citizens register or log in, create reports with location details, attach media, and track reports; officers or admins change report status, which generates notifications. Admins can also list users. The README documents the HTTP routes, domain/application separation, JWT authentication, and JSON persistence, but no source excerpts were provided, so internal call relationships are omitted where the README does not establish them.
Main entry points: _middleware.dart Auth middleware · report_repository_impl.dart Report repository · auth Auth endpoints · reports Report endpoints
Components 24
HTTP API
- Auth endpoints
routes/auth - User context
routes/me.dart - Report endpoints
routes/reports - Report media
routes/reports/[id]/media.dart - Status update
routes/reports/[id]/status.dart - Notifications endpoint
routes/notifications/index.dart - Admin users
routes/admin/users.dart
Identity and access
- Auth middleware
routes/_middleware.dart - Authentication
lib/src/features/auth/auth_service.dart - JWT service
lib/src/security/jwt_service.dart
Report workflow
- Create report use case
lib/src/application/usecases/create_report.dart - Report repository
lib/src/features/reports/report_repository_impl.dart - Notification service
lib/src/features/notifications/notification_service.dart - Image service
lib/src/features/common/image_service.dart
Domain and persistence
- Report model
lib/src/domain/entities/report.dart - User model
lib/src/domain/entities/app_user.dart - Notification model
lib/src/domain/entities/app_notification.dart - Status lifecycle
lib/src/domain/constants/report_status.dart - Report contract
lib/src/domain/repositories/report_repository.dart - JSON backend
lib/src/persistence/json_backend.dart - JSON database
lib/src/persistence/json_db.dart - Firestore adapter
lib/src/persistence/firestore_backend.dart
Other components
- Citizen
- Officer / admin
Connections 15
- Citizen → Auth endpoints: registers / logs in
README.md - Citizen → Report endpoints: creates / tracks
README.md - Citizen → Report media: attaches media
README.md - Citizen → Notifications endpoint: checks updates
README.md - Officer / admin → Status update: updates status
README.md - Officer / admin → Admin users: lists users
README.md - Auth endpoints → Authentication: handles auth
- Auth middleware → JWT service: verifies token
README.md - Auth middleware → User context: resolves identity
README.md - Report endpoints → Create report use case: creates report
- Status update → Notification service: generates notification
README.md - Report media → Image service: handles media
- Report repository → JSON backend: uses JSON storage
- JSON backend → JSON database: persists data
- Report repository → Firestore adapter: adapter alternative
README.md