How keshavghatia/govflow-ai works
GovFlow AI is an API-first government-request orchestration product: a citizen’s request becomes a tailored departmental workflow, advances through departmental systems, and is tracked for citizens and officers under an audit trail. The graph shows the documented workflow and major product surfaces. Some subsystems are documented but unsampled, so their internal links are omitted rather than inferred.
Main entry points: intake.py Case intake · executor.py Workflow execution · webhooks.py Workflow callbacks · audit.py Audit trail
Components 29
User experience
- Citizen experience
frontend/js/citizen.js - Application form
frontend/js/apply.js - Orchestration demo
frontend/js/demo.js - Officer dashboard
frontend/js/officer.js - API client
frontend/js/api.js
API and intake
- Cases API
backend/app/api/cases.py - Intake form API
backend/app/api/intake_form.py - Officer API
backend/app/api/officer.py - Workflow callbacks
backend/app/api/webhooks.py - Response presenters
backend/app/api/presenters.py
Workflow intelligence
- Case intake
backend/app/services/intake.py - Intent understanding
backend/app/services/intent.py - Dynamic composition
backend/app/services/composer.py - Workflow execution
backend/app/services/executor.py - Document processing
backend/app/services/documents.py - Workflow automation
backend/app/services/automation.py - Next best action
backend/app/services/nba.py - Risk assessment
backend/app/services/risk.py
Governance and state
- SLA tracking
backend/app/services/sla.py - Audit trail
backend/app/services/audit.py - Analytics
backend/app/services/analytics.py - Case and workflow state
backend/app/models/__init__.py - Application database
backend/app/core/db.py
External systems
- Department adapters
backend/app/adapters/__init__.py - Department services A–G
mock-departments/app/main.py - Workflow engine
- Optional LLM service
Other components
- Citizen
- Officer
Connections 32
- Citizen → Citizen experience: submits request
README.md - Citizen → Application form: enters application
README.md - Citizen → Orchestration demo: runs demo
README.md - Officer → Officer dashboard: reviews queue
README.md - Citizen experience → API client: requests data
frontend/js/citizen.js - Officer dashboard → API client: requests data
frontend/js/officer.js - API client → Cases API: calls API
README.md - Application form → Intake form API: submits form
README.md - Orchestration demo → Cases API: drives journey
README.md - Cases API → Case intake: creates cases
backend/app/api/cases.py - Intake form API → Case intake: creates cases
backend/app/api/intake_form.py - Officer API → Workflow execution: advances steps
backend/app/api/officer.py - Workflow callbacks → Intent understanding: classifies requests
backend/app/api/webhooks.py - Workflow callbacks → Workflow execution: advances workflow
backend/app/api/webhooks.py - Workflow callbacks → Risk assessment: scores risk
backend/app/api/webhooks.py - Case intake → Intent understanding: understands goal
backend/app/services/intake.py - Case intake → Dynamic composition: composes chain
backend/app/services/intake.py - Intent understanding → Optional LLM service: uses when enabled
backend/app/services/intent.py - Dynamic composition → Department adapters: fetches requirements
backend/app/services/composer.py - Workflow execution → Department adapters: calls departments
backend/app/services/executor.py - Department adapters → Department services A–G: connects over HTTP
README.md - Workflow execution → Audit trail: records events
backend/app/services/executor.py - Workflow execution → SLA tracking: reads clocks
backend/app/services/executor.py - Workflow automation → Workflow engine: dispatches events
backend/app/services/automation.py - Workflow engine → Workflow callbacks: calls callbacks
backend/app/api/webhooks.py - Case intake → Audit trail: records consent and case
backend/app/services/intake.py - Response presenters → Next best action: presents actions
backend/app/api/presenters.py - Response presenters → SLA tracking: presents clock state
backend/app/api/presenters.py - Audit trail → Case and workflow state: writes audit entries
backend/app/services/audit.py - Case intake → Case and workflow state: creates workflow state
backend/app/services/intake.py - Case and workflow state → Application database: persists state
- Document processing → Audit trail: records document events
backend/app/services/documents.py