How hmimotech/gsa works
GSA is a web platform for tracking work orders and associated purchases, linked to projects, contract periods, and ManageEngine ServiceDesk Plus. Users sign in, work with purchase dossiers through approval, quotation, delivery, and installation stages, and manage related files; administrators handle approvals and oversight. The frontend calls a FastAPI backend, whose route handlers use shared workflow, audit, notification, and SQLite layers. The README documents exports and Word attachment generation. Some subsystem links below rely on README descriptions or SOURCE INDEX references because their implementations were not excerpted.
Main entry points: main.py FastAPI application · contrats_route.py Contract periods · database.py SQLite database · auth_route.py Login routes
Components 20
Web client
- Purchase workspace
frontend/app.js - Project workspace
frontend/projects.js - API client
frontend/api.js
API and access
- FastAPI application
backend/main.py - Authentication
backend/auth.py - Login routes
backend/routes/auth_route.py
Purchasing workflow
- Purchase dossiers
backend/routes/dir_route.py - State transitions
backend/workflow.py - File handling
backend/routes/files_route.py - Quote management
backend/routes/devis_route.py
Projects and contracts
- Project management
backend/routes/projects_route.py - Contract periods
backend/routes/contrats_route.py - Contract helpers
backend/contrats.py - Word attachments
backend/documents.py
Shared services
- ServiceDesk proxy
backend/routes/proxy_route.py - Notifications
backend/notifications.py - Audit logging
backend/audit.py - SQLite database
backend/database.py - Oversight routes
backend/routes/stats_route.py
Other components
- Staff and admins
Connections 30
- Staff and admins → Purchase workspace: uses
README.md - Purchase workspace → API client: calls
README.md - Project workspace → API client: calls
README.md - API client → FastAPI application: sends requests
README.md - FastAPI application → Login routes: registers
backend/main.py - FastAPI application → Purchase dossiers: registers
backend/main.py - FastAPI application → File handling: registers
backend/main.py - FastAPI application → Quote management: registers
backend/main.py - FastAPI application → Project management: registers
backend/main.py - FastAPI application → Contract periods: registers
backend/main.py - FastAPI application → ServiceDesk proxy: registers
backend/main.py - Login routes → Authentication: verifies identity
backend/routes/auth_route.py - Purchase dossiers → State transitions: uses transitions
backend/routes/dir_route.py - Quote management → State transitions: uses transitions
backend/routes/devis_route.py - Contract periods → Contract helpers: uses helpers
backend/routes/contrats_route.py - Contract periods → Word attachments: generates documents
backend/routes/contrats_route.py - Purchase dossiers → ServiceDesk proxy: fetches ticket data
backend/routes/dir_route.py - Purchase dossiers → SQLite database: reads and writes
backend/routes/dir_route.py - Quote management → SQLite database: reads and writes
backend/routes/devis_route.py - File handling → SQLite database: records file metadata
backend/routes/files_route.py - Project management → SQLite database: reads and writes
backend/routes/projects_route.py - Contract periods → SQLite database: reads and writes
backend/routes/contrats_route.py - Login routes → SQLite database: reads accounts
backend/routes/auth_route.py - Login routes → Audit logging: records login events
backend/routes/auth_route.py - Quote management → Audit logging: records actions
backend/routes/devis_route.py - Project management → Audit logging: records actions
backend/routes/projects_route.py - Contract periods → Audit logging: records actions
backend/routes/contrats_route.py - Oversight routes → SQLite database: queries reporting data
backend/routes/stats_route.py - Contract periods → Notifications: sends notifications
- File handling → Notifications: sends notifications
backend/routes/files_route.py