How shathuryaparamanathan/taskflow-platform works
TaskFlow is a PostgreSQL-backed task-management API, accompanied by AWS infrastructure and host-configuration code. The main user workflow is HTTP requests through the Express server and task routes to PostgreSQL, with results returned as JSON. The repository also includes Terraform infrastructure modules, Ansible configuration, and ECS vertical-scaling automation. The README documents deployment and scaling capabilities, but most infrastructure and Ansible implementation files were not sampled; those relationships are shown only where documented, and uncertain wiring is omitted.
Main entry points: main.tf Infrastructure config · server.js HTTP server · ci-db-setup.cjs Migration setup · task.routes.js Task routes
Components 19
Task API
- HTTP server
app/src/server.js - Task routes
app/src/routes/task.routes.js - API specification
app/openapi.yaml
Persistence
- Database pool
app/src/db.js - PostgreSQL
- Migration setup
app/ci-db-setup.cjs - Task schema
app/migrations/001_create_tasks.sql
AWS Infrastructure
- Infrastructure config
terraform/main.tf - Network resources
terraform/modules/network - Security resources
terraform/modules/security - Cloud database
terraform/modules/database - Compute resources
terraform/modules/compute - Scaling configuration
terraform/modules/compute/vertical_scaling.tf - Vertical scaler
terraform/modules/compute/vertical_scaler.py
Operations
- Host configuration
ansible/playbooks/configure-ec2.yml - Configuration roles
ansible/roles
Other components
- API client
- Platform operator
- AWS ECS
Connections 18
- API client → HTTP server: sends requests
README.md - HTTP server → Task routes: routes tasks
app/src/server.js - HTTP server → API specification: loads specification
app/src/server.js - Task routes → Database pool: queries
app/src/routes/task.routes.js - Database pool → PostgreSQL: reads and writes
README.md - Platform operator → Migration setup: runs setup
README.md - Migration setup → Task schema: loads migration
app/ci-db-setup.cjs - Migration setup → PostgreSQL: applies schema
app/ci-db-setup.cjs - Platform operator → Infrastructure config: configures deployment
README.md - Infrastructure config → Network resources: configures resources
- Infrastructure config → Security resources: configures resources
- Infrastructure config → Cloud database: configures resources
- Infrastructure config → Compute resources: configures resources
- Compute resources → Scaling configuration: includes scaling
- Scaling configuration → Vertical scaler: configures automation
README.md - Vertical scaler → AWS ECS: updates service
terraform/modules/compute/vertical_scaler.py - Platform operator → Host configuration: runs configuration
README.md - Host configuration → Configuration roles: uses roles