learning_ai_common_plat/dashboards/tracker-web
root 930f97ff63 docs(tracker): move ROADMAP to docs/ + scaffold NoteLett-style structure
Reorganises tracker-web docs to match the NoteLett + FlowMonk sibling-repo
convention. Old root ROADMAP.md replaced by full docs/ scaffold:

  docs/
  ├── ROADMAP.md                              (master phase tracker, v3)
  ├── PRD.md                                  (product requirements doc)
  ├── PRODUCTION_READINESS_HANDOFF_ROADMAP.md (adapted from NoteLett)
  ├── IMPLEMENTATION_TRACKER.md               (per-slice tracker w/ commit SHAs)
  └── roadmaps/
      ├── 00_MASTER_EXECUTION_PLAN.md
      └── 01_FOUNDATIONS_AND_DECISIONS.md

Incorporates production-readiness learnings from recent work in sibling
repos (May 22-23, 2026):

From learning_ai_notes:
- UI primitives migration via Primitives.tsx adapter (UI5-UI8 pattern)
- UI drift ratchet CI gate (one-way enforcement, hard-zero categories)
- Docker hardening: NEXT_PUBLIC bake-time, standalone static-chunks fix,
  corp-proxy build args, tarball-based docker-prep.sh
- Cosmos emulator smoke job for partition-key path coverage
- Live shared-service smoke (pnpm smoke:local)
- MEK rotation + secret-management runbooks
- React+React-DOM pnpm.overrides pin
- Backend domain events emission (item.created, status_changed, etc.)
- Workspace-path canonicalization

From learning_ai_flowmonk:
- @axe-core/playwright accessibility tests in CI
- E2E cleanup traps (prevent orphan resource accumulation)
- Playwright deployed-stack support (BASE_URL switch)
- IPv4 healthcheck (127.0.0.1, not localhost)
- Mobile palette centralization (theme/colors.ts)
- Release guards CI workflow
- Runtime replay preview pattern (for webhook event replay)

Adds 5 new bugs to known-issues table (B-019..B-023) for hardcoded
colors, direct ui imports, NEXT_PUBLIC runtime hardcoding, no mobile
layout, no i18n.

New Phase 6 expanded to cover mobile + a11y + i18n + theming.
Phase 4 expanded with cross-product routing + import wizard.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-25 11:28:55 +00:00
..
docs docs(tracker): move ROADMAP to docs/ + scaffold NoteLett-style structure 2026-05-25 11:28:55 +00:00
e2e feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
public feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
src feat(scripts+ui): Tier 2 complete \u2014 common_plat 0 hex findings (was 59) 2026-05-23 14:37:51 -07:00
.bundlesizerc.json feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
.env.example feat(auth): SmartAuth tracker-web — OAuth proxy, MFA verify, login page with Google Sign-In 2026-03-12 11:15:44 -07:00
.env.local.example feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
.gitignore feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
.nvmrc feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
Dockerfile fix(dashboards): restore runtime and expose internal ops health 2026-03-31 07:26:43 +00:00
eslint.config.mjs feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
next.config.ts fix(tracker-web): replace broken webpack alias with transpilePackages — build now succeeds 2026-02-28 12:11:37 -08:00
package-lock.json feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
package.json fix(dashboards): add typecheck script, remove stale engines.node 20.x 2026-03-24 08:39:58 -07:00
playwright.config.ts feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
postcss.config.mjs feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
README.md feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
tsconfig.json feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
vercel.json feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00
vitest.config.ts feat(dashboards): migrate admin + tracker dashboards to common-plat as product-agnostic 2026-02-28 02:17:35 -08:00

Tracker Dashboard

Web dashboard for the Tracker Service — manage feature requests, bugs, and tasks. Built with Next.js + Tailwind CSS + React.

Port

3003 (configurable in package.json scripts)

Pages

Route Description
/login Login via platform-service credentials
/dashboard Overview with stats by type, status, priority
/dashboard/items Items list with filtering, search, create, delete
/dashboard/board Kanban board with drag-free status transitions
/dashboard/items/[id] Item detail with edit, status/priority change, comments, votes

API Proxy Routes

Route Proxies to
/api/auth/login platform-service POST /api/auth/login
/api/auth/me platform-service GET /api/auth/me
/api/tracker/* tracker-service /api/*

Setup

cp .env.local.example .env.local   # fill in values
npm install
npm run dev                       # starts on port 3003

Environment Variables

See .env.local.example for required variables:

  • PLATFORM_API_URL — Platform service URL (default http://localhost:4003)
  • JWT_SECRET — Shared JWT secret
  • PRODUCT_ID — Product scope (e.g., lysnrai, chronomind, nomgap)