From e6eee35544f1a24b6f865de0084c4f15d3105f0c Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Sat, 28 Feb 2026 03:06:44 -0800
Subject: [PATCH] docs: fix stale references to consolidated services and
 migrated dashboards

---
 AGENTS.md    | 12 ++++++------
 MANUAL_CI.md | 10 ++++++----
 README.md    | 23 ++++++++++++-----------
 3 files changed, 24 insertions(+), 21 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 87d24d80..3e2a8d12 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -146,13 +146,13 @@ learning_ai_common_plat/
 
 ### Dashboard Consumers (via `file:` refs)
 
-The following dashboards in `../learning_voice_ai_agent/` consume `@bytelyst/*` packages:
+The following dashboards consume `@bytelyst/*` packages:
 
-| Dashboard               | Packages Used                                                |
-| ----------------------- | ------------------------------------------------------------ |
-| `admin-dashboard-web`   | api-client, auth, config, cosmos, errors, logger, react-auth |
-| `user-dashboard-web`    | api-client, auth, config, cosmos, errors, logger, react-auth |
-| `tracker-dashboard-web` | api-client, config, cosmos, errors                           |
+| Dashboard                          | Location                                | Packages Used                                                |
+| ---------------------------------- | --------------------------------------- | ------------------------------------------------------------ |
+| `admin-web`                        | `dashboards/admin-web/` (this repo)     | api-client, auth, config, cosmos, errors, logger, react-auth |
+| `user-dashboard-web`               | `../learning_voice_ai_agent/`           | api-client, auth, config, cosmos, errors, logger, react-auth |
+| `tracker-web`                      | `dashboards/tracker-web/` (this repo)   | api-client, config, cosmos, errors                           |
 
 **Prerequisite:** Run `pnpm build` in this repo before running `npm install` in any dashboard.
 
diff --git a/MANUAL_CI.md b/MANUAL_CI.md
index d8143dc9..f7347858 100644
--- a/MANUAL_CI.md
+++ b/MANUAL_CI.md
@@ -53,10 +53,12 @@ pnpm typecheck && pnpm lint && pnpm format:check && pnpm test && pnpm audit
 ```bash
 cd /path/to/learning_voice_ai_agent
 
-# Dashboards
-cd admin-dashboard-web && npm run typecheck && npm run lint && npm test
-cd ../user-dashboard-web && npm run typecheck && npm run lint && npm test
-cd ../tracker-dashboard-web && npm run typecheck && npm run lint && npm test
+# User dashboard (only one remaining in this repo)
+cd user-dashboard-web && npm run typecheck && npm run lint && npm test
+
+# Admin + Tracker dashboards now in learning_ai_common_plat/dashboards/
+cd /path/to/learning_ai_common_plat/dashboards/admin-web && npm run typecheck && npm run lint && npm test
+cd ../tracker-web && npm run typecheck && npm run lint && npm test
 
 # Python
 make lint && python -m pytest tests/ backend/tests/
diff --git a/README.md b/README.md
index 745c77b2..1e691859 100644
--- a/README.md
+++ b/README.md
@@ -43,11 +43,12 @@ learning_ai_common_plat/
 │   ├── api-client/              # Configurable fetch wrapper
 │   ├── react-auth/              # React auth context factory
 │   └── design-tokens/           # Cross-platform tokens (JSON → CSS/TS/Kotlin/Swift)
+├── dashboards/                  # Product-agnostic web dashboards (Next.js)
+│   ├── admin-web/               # Platform admin console (port 3001)
+│   └── tracker-web/             # Issue tracker + public roadmap (port 3003)
 ├── services/                    # Product-agnostic microservices
-│   ├── platform-service/        # Auth, audit, flags, notifications, blob (port 4003)
-│   ├── billing-service/         # Subscriptions, Stripe, usage, licenses (port 4002)
-│   ├── growth-service/          # Invitations, referrals, promos (port 4001)
-│   ├── tracker-service/         # Items, comments, votes, public roadmap (port 4004)
+│   ├── platform-service/        # Consolidated: auth, audit, flags, billing, growth, tracker (port 4003)
+│   ├── extraction-service/      # LangExtract text extraction + Python sidecar (port 4005)
 │   └── monitoring/              # Loki + Grafana config, health-check
 └── docs/                        # Architecture docs, roadmap, analysis
 ```
@@ -72,13 +73,13 @@ learning_ai_common_plat/
 
 ## Shared Services
 
-| Service            | Port | Description                                                     | Tests |
-| ------------------ | ---- | --------------------------------------------------------------- | ----- |
-| `platform-service` | 4003 | Auth, audit, feature flags, notifications, blob storage         | 55    |
-| `billing-service`  | 4002 | Subscriptions, Stripe webhooks, usage tracking, licenses, plans | 32    |
-| `growth-service`   | 4001 | Invitations, referrals, promo codes                             | 33    |
-| `tracker-service`  | 4004 | Feature requests, bugs, tasks, public roadmap                   | 45    |
-| `monitoring`       | —    | Loki + Grafana dashboards, health-check script                  | —     |
+| Service              | Port | Description                                                                    | Tests  |
+| -------------------- | ---- | ------------------------------------------------------------------------------ | ------ |
+| `platform-service`   | 4003 | Consolidated: auth, audit, flags, billing, growth, tracker, telemetry, etc.    | 1,029  |
+| `extraction-service` | 4005 | LangExtract text extraction + Python sidecar                                   | 46     |
+| `monitoring`         | —    | Loki + Grafana dashboards, health-check script                                 | —      |
+
+> Note: billing-service (4002), growth-service (4001), and tracker-service (4004) were consolidated into platform-service (Feb 2026).
 
 All services are **product-agnostic** — every Cosmos document includes a `productId` field, so a single deployment serves LysnrAI, MindLyst, or any future product.