How gauravagrawal11/schedulesync works
ScheduleSync connects field progress reports to project schedules, matching observations to baseline activities and supporting planner review and schedule analytics. Supervisors submit text, files or voice; reports are extracted and matched, then accepted progress updates feed sequence checks, forecasting and planner views. The README documents offline capture and safety triage, while source-index references clarify several backend handoffs. Some frontend and backend routes were not sampled, so those connections are shown only where documented; the README’s broader AI and offline descriptions are product-level evidence, not confirmation of every implementation detail.
Main entry points: ingestion/router.py Report ingestion · review/router.py Planner review · client.ts API client · analytics/router.py Schedule analytics
Components 25
Field capture
- Supervisor app
frontend/src/supervisor/LogProgress.tsx - Offline queue
frontend/src/supervisor/offline/queue.ts - Offline sync
frontend/src/supervisor/offline/syncManager.ts - Voice handling
backend/app/voice/router.py
Ingestion and matching
- Report ingestion
backend/app/ingestion/router.py - Document parsing
backend/app/parsing/service.py - Entity extraction
backend/app/extraction/service.py - HSE tagging
backend/app/extraction/hse.py - Hybrid matching
backend/app/matching/service.py - Progress linking
backend/app/linking/service.py
Schedule operations
- Schedule baseline
backend/app/schedule/service.py - Supervisor assignment
backend/app/assignment/engine.py - Schedule analytics
backend/app/analytics/router.py - Sequence checks
backend/app/analytics/sequence.py - Duration forecasting
backend/app/analytics/forecasting.py
Review and safety
- Planner review
backend/app/review/router.py - Safety concerns
backend/app/complaints/router.py - Live notifications
backend/app/notifications/service.py - Planner cockpit
frontend/src/planner/ReviewQueue.tsx
Application platform
- API client
frontend/src/api/client.ts - Workflow sockets
backend/app/workflow/connection_manager.py - Relational database
backend/app/core/database.py - Authentication
backend/app/auth/dependencies.py - FastAPI application
backend/app/main.py
Other components
- Field supervisor
Connections 31
- Field supervisor → Supervisor app: submits reports
README.md - Supervisor app → Offline queue: queues offline
README.md - Offline queue → Offline sync: flushes queue
frontend/src/supervisor/offline/syncManager.ts - Offline sync → API client: sends reports
frontend/src/supervisor/offline/syncManager.ts - Supervisor app → API client: posts reports
README.md - API client → Report ingestion: calls API
README.md - Report ingestion → Document parsing: parses uploads
backend/app/ingestion/router.py - Report ingestion → Entity extraction: extracts entities
backend/app/ingestion/router.py - Report ingestion → Hybrid matching: requests matches
backend/app/ingestion/router.py - Report ingestion → HSE tagging: scans safety
backend/app/ingestion/router.py - API client → Voice handling: uploads audio
README.md - Document parsing → Voice handling: handles audio
backend/app/parsing/service.py - Hybrid matching → Progress linking: links accepted matches
backend/app/matching/service.py - Progress linking → Sequence checks: checks sequence
backend/app/linking/service.py - Report ingestion → Schedule baseline: ingests schedules
README.md - Sequence checks → Workflow sockets: broadcasts updates
backend/app/analytics/sequence.py - Planner review → Progress linking: applies decisions
backend/app/review/router.py - Planner review → Live notifications: triggers notifications
backend/app/review/router.py - Planner review → Sequence checks: checks approved work
backend/app/review/router.py - HSE tagging → Safety concerns: logs safety tickets
README.md - Schedule analytics → Sequence checks: reports violations
backend/app/analytics/router.py - Schedule analytics → Duration forecasting: computes risk
backend/app/analytics/router.py - Schedule analytics → Schedule baseline: reads baseline
README.md - Supervisor assignment → Schedule baseline: allocates activities
backend/app/assignment/engine.py - Planner cockpit → API client: loads review data
frontend/src/planner/ReviewQueue.tsx - FastAPI application → Report ingestion: registers routes
backend/app/main.py - FastAPI application → Planner review: registers routes
backend/app/main.py - FastAPI application → Schedule analytics: registers routes
backend/app/main.py - Report ingestion → Relational database: persists reports
backend/app/ingestion/router.py - Planner review → Relational database: reads review records
backend/app/review/router.py - Authentication → Relational database: loads accounts
backend/app/auth/dependencies.py