About this project

Mansooba (Urdu for "plan" or "project") is a full-featured project management application aimed at teams. It is built with a Go + Echo v4 backend using GORM with SQLite or PostgreSQL, and a Nuxt 4 frontend using Pinia, Tailwind CSS v4, and DaisyUI. DevOps tooling includes Docker, GitHub Actions CI/CD, Terraform, AWS services (EC2, RDS, S3, IAM, SES), and Grafana Loki. Core capabilities include authentication with email password reset, profile and avatar management; projects with teammate invitations and permission control; issue tracking for tasks, bugs, stories, and epics with labels, priorities, and related-issue links; file attachments stored in S3 with per-project access control; time-boxed sprints with a kanban board, burndown chart, and velocity chart; a backlog for triaging unscheduled work; collaboration through comments, @mentions, and per-issue activity feeds; a "My Desk" view for assigned issues, notifications, and pinned projects; reports visualizing sprint velocity; system administration for users, platform settings, onboarding, and a Grafana Loki-backed audit trail; and a six-step first-run setup wizard. The project can be started with `docker compose up --build`, exposing the app at localhost:3000, the API at localhost:8080, and a development email interface at localhost:8025. Alternative deployment paths documented in the repository include Docker with PostgreSQL or hot-reload dev mode, pre-built GHCR images, running from source with Go and Node, AWS deployment via console-only steps, AWS deployment with Terraform, and post-deployment troubleshooting. Documentation covers architecture (overview, backend, frontend, API reference) and feature deep-dives on authentication and security, issues, sprints and board, reports, collaboration, system admin, system logs, and the setup wizard. The README describes a spec-driven engineering process and includes demo recordings for the first-run wizard and sprint/task management.