How lesa-shanmuganathan/maintenance_scheduling_tool works
The Maintenance Scheduling Tool lets staff manage equipment by environment, plan recurring maintenance, record completions and documents, and review equipment extracted from uploaded documents. The main workflow runs from the React screens through the Axios API to Flask endpoints and SQLAlchemy models; document imports add asynchronous AI classification and human verification. The README also documents calendar overrides, overdue handling, maintenance logs, and synthesis filters. Backend internals are only partly excerpted, so links for documented but unsampled capabilities are cited to the README.
Main entry points: MainPage.jsx Equipment and logs · app.py Flask API and scheduling · App.jsx Application shell · api.js HTTP API client
Components 15
Maintenance UI
- Application shell
frontend/src/App.jsx - Equipment and logs
frontend/src/pages/MainPage.jsx - Synthesis dashboard
frontend/src/pages/SynthesisDashboard.jsx - Schedule calendar
frontend/src/components/CalendarModal.jsx - Equipment form
frontend/src/components/EquipmentModal.jsx - Import dialog
frontend/src/components/ImportDocumentModal.jsx - Pending review page
frontend/src/pages/PendingReviewPage.jsx - Classification review
frontend/src/components/VerificationTable.jsx
Application services
- HTTP API client
frontend/src/api.js - Flask API and scheduling
backend/app.py
Maintenance data
- Domain models
backend/models.py - Application database
Document intake
- Uploaded documents
backend/uploads
Other components
- Maintenance staff
- AI classification service
Connections 21
- Maintenance staff → Application shell: uses
README.md - Application shell → Equipment and logs: routes to
frontend/src/App.jsx - Application shell → Synthesis dashboard: routes to
frontend/src/App.jsx - Application shell → Pending review page: routes to
frontend/src/App.jsx - Application shell → Pending review page: loads count
frontend/src/App.jsx - Equipment and logs → HTTP API client: requests data
frontend/src/pages/MainPage.jsx - Equipment and logs → Equipment form: opens form
frontend/src/pages/MainPage.jsx - Equipment and logs → Schedule calendar: opens schedule
README.md - Equipment and logs → Import dialog: imports documents
README.md - Equipment and logs → Classification review: reviews results
frontend/src/pages/MainPage.jsx - Synthesis dashboard → HTTP API client: requests tasks
frontend/src/pages/SynthesisDashboard.jsx - Schedule calendar → Flask API and scheduling: reads and overrides
frontend/src/components/CalendarModal.jsx - Pending review page → Classification review: renders review
frontend/src/pages/PendingReviewPage.jsx - Classification review → HTTP API client: submits decisions
frontend/src/components/VerificationTable.jsx - Import dialog → HTTP API client: uploads and polls
frontend/src/components/ImportDocumentModal.jsx - HTTP API client → Flask API and scheduling: HTTP requests
frontend/src/api.js - Flask API and scheduling → Domain models: queries and updates
backend/app.py - Domain models → Application database: persists records
- Flask API and scheduling → Uploaded documents: stores documents
- Flask API and scheduling → AI classification service: requests classification
- AI classification service → Flask API and scheduling: returns predictions