TeamForge

Align teams. Record decisions. Ship with clarity.

TeamForge is a portfolio-grade engineering leadership platform for Tech Leads, Engineering Leads, Developers, and Product partners. It focuses on engineering execution, technical decisions, project health, risks, auditability, and team alignment rather than generic task tracking.

Why TeamForge?

Software delivery is not only a list of tickets. A technical leader needs to know what the team is building, what is blocked, which priorities changed, which risks are open, and why architectural decisions were made. TeamForge connects planning, backlog, sprint execution, ADRs, and risk management in one modular monolith.

Product Capabilities

• Organization-based multi-tenancy.
• RBAC for ADMIN, TECH_LEAD, DEVELOPER, and PRODUCT.
• Teams, members, projects, project health, and ownership.
• Backlog with status lifecycle, priority, business value, technical complexity, and a priority matrix.
• Sprint lifecycle with one active sprint per project.
• Technical decisions and ADR-style lifecycle: proposed, accepted, rejected, superseded.
• Risk scoring using probability x impact.
• Comments on backlog items, decisions, and risks.
• Audit log for relevant leadership actions.
• Health, readiness, structured logs, OpenAPI, and Prometheus-compatible metrics.

Architecture

flowchart TD
  Browser --> React[Vite React Console]
  React --> Fastify[Fastify API]
  Fastify --> Prisma[Prisma ORM]
  Prisma --> PostgreSQL[(PostgreSQL)]

Loading

flowchart LR
  Organization --> Teams
  Teams --> Projects
  Projects --> Backlog
  Projects --> Sprints
  Projects --> Decisions
  Projects --> Risks
  Backlog --> Comments
  Decisions --> Comments
  Risks --> Comments
  Actions --> AuditLogs

Loading

The backend is a modular monolith. Redis is intentionally not included because there is no demonstrated need for shared caching or distributed rate limiting in the current scope.

Tech Stack

• Backend: Node.js, TypeScript, Fastify, Prisma, PostgreSQL, Vitest, Swagger/OpenAPI.
• Frontend: React, TypeScript, Vite, React Router, TanStack Query, CSS.
• Infra: Docker, Docker Compose, Nginx, GitHub Actions.
• Observability: Pino, request IDs, /health, /ready, /metrics, OpenTelemetry API base.

Getting Started

npm install
cp .env.example .env
npm run db:generate
npm run db:validate
npm run db:migrate
npm run db:seed
npm run dev:api
npm run dev:web

Local URLs:

• Web: http://localhost:5173
• API: http://localhost:3333
• Swagger: http://localhost:3333/docs
• Metrics: http://localhost:3333/metrics

Docker

docker compose up --build

Container URLs:

• Web: http://localhost:18080
• API: http://localhost:18033

Demo Credentials

• admin@teamforge.local / demo-password
• techlead@teamforge.local / demo-password
• developer@teamforge.local / demo-password
• product@teamforge.local / demo-password

Demo Flow

1. Log in as techlead@teamforge.local.
2. Open the Dashboard.
3. Open Customer Platform Modernization.
4. Inspect Sprint 12.
5. Find the blocked tech debt item.
6. Change a backlog priority.
7. Open Adopt Redis for application caching.
8. Review context, alternatives, and consequences.
9. Accept the decision.
10. Create Redis adoption may increase operational complexity.
11. Add the mitigation plan.
12. Update risk status.
13. Open Audit Log and confirm the recorded actions.

API

The API is versioned under /api/v1.

• Auth: register, login, refresh, logout, me.
• Users: list, create, role update.
• Teams: CRUD-lite plus membership.
• Projects: list, detail, update, overview.
• Backlog: create, list, detail, update, delete, assign, status, priority.
• Sprints: create, list, detail, update, start, complete.
• Decisions: create, list, detail, update, accept, reject, supersede.
• Risks: create, list, detail, update, status.
• Comments: create and list by resource.
• Dashboard and Audit.
• System: /health, /ready, /metrics.

Screenshots Placeholder

• Dashboard
• Project Overview
• Backlog
• Decision Detail
• Risk Management

Testing

npm run lint
npm run typecheck
npm run test
npm run build

Roadmap

• richer audit filters;
• deeper project health recommendations;
• optional Redis-backed rate limiting after measurable need;
• exportable ADRs;
• team-level workload views.