Mansooba

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

Demo

First run wizard

Sprint and task management

Features

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
Project overview	Open a project and see the active sprint's progress, the sprint's open tasks and recent activity at a glance; members live on their own page
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
Open source	Released under AGPL-3.0

Getting Started

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.

Every account has a unique username (used for @mentions). Accounts created before usernames existed get one from a one-off command, backfill-usernames, which docker compose up runs before the backend starts. Without Docker, run it yourself after upgrading: cd backend && go run ./cmd/backfill-usernames (safe to run repeatedly). The server refuses to start, with a message naming the command, while any account is still missing a username.

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

Documentation

Architecture


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

Feature deep-dives


Authentication & security	JWT strategy, token revocation, password reset flow
Issues	Relations, labels, and how issues connect
Sprints & board	Lifecycle states, completion migration, burndown & velocity
Project overview	What the overview shows, how each section is computed, who can see it
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
Licensing	Open source under AGPL-3.0, and how contributions and the source link work

Contributing

Bug reports, questions and ideas are always welcome — please open an issue.
Code contributions need a one-time signature of the contributor agreement,
which keeps the dual-licensing option below open; the CLA check on your pull request
walks you through it. See CONTRIBUTING.md.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only).
The owner may offer this software under separate commercial terms in the future; no such offer exists today.
See NOTICE for the copyright notice and third-party licensing information.
Every release image carries LICENSE, NOTICE and THIRD-PARTY-NOTICES.md under /licenses/.
If you run a modified version as a network service, set SOURCE_CODE_URL to where your own
source is published (see Licensing).

mansooba