Mansooba (منصوبہ) - Urdu for "plan" or "project"
A full-featured project management app for teams: plan sprints, track and triage issues, and collaborate through comments, mentions, and activity feeds - all built with a spec-driven engineering process.
Backend: Go + Echo v4 · GORM · SQLite / PostgreSQL
Frontend: Nuxt 4 · Pinia · Tailwind CSS v4 · DaisyUI
DevOps: Docker · GitHub Actions CI/CD · Terraform · AWS (EC2, RDS, S3, IAM, SES) · Grafana Loki
| Feature | What you can do |
|---|---|
| Authentication | Sign in, reset your password by email, change it from your profile, manage your profile and avatar |
| Projects | Create projects, invite teammates, and control who can manage them |
| Issues | Track tasks, bugs, stories, and epics with labels, priorities, and related-issue links |
| Attachments | Attach files to issues, stored in S3 and access-controlled per project |
| Sprints | Plan and run time-boxed sprints with a kanban board, burndown chart, and velocity chart |
| Backlog | Triage unscheduled work and pull it into upcoming sprints |
| Collaboration | Comment on issues, @mention teammates, and follow per-issue activity feeds |
| My Desk | See your assigned issues, notifications, and pinned projects at a glance |
| Reports | Visualise sprint velocity across your project history |
| System Admin | Manage users, configure platform settings, onboard new team members, and review the Grafana Loki-backed audit trail |
| First-Run Wizard | Six-step guided setup gets a fresh install ready in minutes |
docker compose up --build| What | URL |
|---|---|
| App | http://localhost:3000 |
| API | http://localhost:8080 |
| Email (dev) | http://localhost:8025 |
On first visit the setup wizard walks you through creating the admin account.
Other ways to run:
- Docker with PostgreSQL or hot-reload dev mode
- Pre-built GHCR images - no Go toolchain needed
- From source - Go + Node, no Docker
- Deploy to AWS (beginner, console-only) - no Terraform, no CLI
- Deploy to AWS (Terraform) - Infrastructure-as-Code, ~20 min hands-on
- Post-deployment troubleshooting - diagnosing an already-running deployment
| Overview | Tech stack, project structure, CI/CD pipeline |
| Backend | Layers, entities, services |
| Frontend | Pages, stores, components, routing |
| API reference | All endpoints with methods and descriptions |
| Authentication & security | JWT strategy, token revocation, password reset flow |
| Issues | Relations, labels, and how issues connect |
| Sprints & board | Lifecycle states, completion migration, burndown & velocity |
| Reports | Velocity chart data source and rendering approach |
| Collaboration | @mention parsing, notification model, activity feeds |
| System admin | User management, platform settings, and safety guardrails |
| System logs | Grafana Loki-backed audit trail for auth, admin actions, settings changes, and DB lifecycle events |
| Setup wizard | First-run wizard flow, sample data import, and seed CLI |
| First-run wizard guide | Step-by-step wizard reference with DEMO conflict, retry behaviour, and CLI output |