Skip to main content

System Overview

Runtime components​

  • Frontend: React + Vite app (:3000)
  • Backend: Node.js + Express API (:4000)
  • Database: SQLite (backend/data/data.sqlite)
  • Email sandbox: Mailpit (:8025 UI)

Backend modules​

  • Routes: auth, tickets, dev-tasks, projects, users, settings.
  • Middleware: auth, RBAC, validation, rate limiting, uploads.
  • Services: tickets, task sync, telemetry, domain events, outbox worker, settings, email, capabilities.

Data flow​

  1. UI calls API with JWT bearer token.
  2. Middleware enforces auth/RBAC/validation.
  3. Services execute domain logic and persistence.
  4. Domain events are appended to outbox.
  5. Optional outbox worker processes pending events.