diff --git a/docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md b/docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md new file mode 100644 index 00000000..95efdf0a --- /dev/null +++ b/docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md @@ -0,0 +1,450 @@ +# AeThex Ecosystem Audit & Consolidation Plan + +**Date:** January 2025 +**Status:** Current ecosystem analysis with consolidation recommendations + +--- + +## Executive Summary + +You have **100+ routes** spanning 6 "arms" (business divisions), multiple systems, and significant duplication. This audit identifies: + +1. **What exists** (complete route inventory) +2. **What's duplicated** (routes serving same purpose) +3. **What's incomplete** (routes with partial implementation) +4. **What should be removed** (legacy/dead routes) +5. **Consolidation strategy** (merge/redirect paths) + +--- + +## Current Ecosystem Structure (By Business Division) + +### **🟡 LABS** (Yellow) - Research & Development +**Landing Page:** `/labs` +**Sub-pages:** `/labs/explore-research`, `/labs/join-team`, `/labs/get-involved` +**Status:** ✅ Landing pages complete | ❌ Full system NOT built + +**Legacy/Duplicate:** +- `/research` → ResearchLabs (OLD legacy page, same as `/labs`) + +**Decision:** REMOVE `/research` route, consolidate to `/labs/*` + +--- + +### **🟢 GAMEFORGE** (Green) - Game Development Platform +**Landing Page:** `/gameforge` +**Sub-pages:** `/gameforge/start-building`, `/gameforge/view-portfolio`, `/gameforge/join-gameforge` +**System Pages:** +- `/projects` - Project management +- `/projects/new` - Create project +- `/projects/:projectId/board` - Kanban board +- `/projects/admin` - Admin tools + +**Status:** ✅ Full system COMPLETE + +**Legacy/Duplicate:** +- `/game-development` (OLD, same as `/gameforge`) + +**Decision:** REMOVE `/game-development` route + +--- + +### **🔴 FOUNDATION** (Red) - Education & Community +**Landing Page:** `/foundation` +**Sub-pages:** `/foundation/contribute`, `/foundation/learn-more`, `/foundation/get-involved` + +**Community Section (overlapping):** +- `/community` - Main community/social feed +- `/community/teams` - FoundationTeams +- `/community/about` - FoundationAbout +- `/community/mentorship` - MentorshipRequest +- `/community/mentorship/apply` - MentorApply +- `/community/mentor/:username` - MentorProfile +- `/community/groups/ethos` - EthosGuild +- `/community/:tabId` - Dynamic tabs (legacy) + +**Status:** ✅ Landing pages complete | ⏳ System partially built (mentorship DB done, UI incomplete) + +**CRITICAL ISSUE:** `/foundation/*` and `/community/*` are DUPLICATING the same content! + +**Decision:** +- `/community` should BECOME `/foundation` +- `/community/mentorship` → `/foundation/mentorship` +- `/community/mentor/:username` → `/foundation/mentors/:username` +- REMOVE duplicate routes + +--- + +### **🟠 ETHOS GUILD** (Orange/Red) - Music & Audio Marketplace +**Routes:** +- `/community/groups/ethos` - Guild landing +- `/ethos/library` - Track library +- `/ethos/artists/:userId` - Artist profile +- `/ethos/settings` - Artist settings +- `/ethos/licensing` - Licensing dashboard + +**Status:** ✅ Full system COMPLETE (Supabase tables: ethos_tracks, ethos_artist_profiles) + +**Decision:** CLEAN UP - Move Ethos Guild pages to organized `/ethos/*` path +- `/community/groups/ethos` → `/ethos` (landing) +- Rest are fine + +--- + +### **🔵 CORP** (Blue) - Enterprise Consulting +**Landing Page:** `/corp` +**Sub-pages:** `/corp/schedule-consultation`, `/corp/view-case-studies`, `/corp/contact-us` + +**Legacy/Duplicate:** +- `/consulting` (OLD DevelopmentConsulting page) +- `/services` - Services page (overlapping with Corp) +- `/engage` (Pricing, navigates to `/pricing`) +- `/pricing` → Redirects to `/engage` +- `/wix` - Wix-related pages (legacy, overlapping with Corp info) + +**Status:** ✅ Landing pages complete | ❌ Client portal `/hub/client` NOT built + +**Decision:** +- REMOVE `/consulting`, `/services` (consolidate to `/corp`) +- REMOVE `/wix` and `/wix/*` routes (legacy) +- REMOVE `/engage` and `/pricing` (consolidate, decide on one pricing page) +- ADD `/hub/client` (client portal, new system needed) + +--- + +### **🟣 NEXUS** (Purple) - Talent Marketplace +**Landing Page:** `/nexus` + +**Creator Network Routes (ALREADY EXIST):** +- `/creators` - CreatorDirectory +- `/creators/:username` - CreatorProfile +- `/opportunities` - OpportunitiesHub +- `/opportunities/:id` - OpportunityDetail +- `/profile/applications` - MyApplications + +**Status:** ✅ Database complete | ⏳ UI partially built (basic directory exists, needs enhancement) + +**Decision:** +- These routes are ALREADY WIRED correctly +- Need to ENHANCE with Nexus features (messaging, contracts, payments, 20% commission) +- NO changes to routes needed + +--- + +### **💜 STAFF** (Purple/Internal) - Employee Portal +**Landing Page:** `/staff` +**Auth:** `/staff/login` +**Dashboard:** +- `/staff/dashboard` - Operations dashboard +- `/staff/directory` - Team directory +- `/staff/admin` - Admin tools +- `/staff/chat` - Internal chat +- `/staff/docs` - Internal documentation +- `/staff/achievements` - Achievement tracking +- `/staff/announcements` +- `/staff/expense-reports` +- `/staff/marketplace` - Internal marketplace +- `/staff/knowledge-base` +- `/staff/learning-portal` +- `/staff/performance-reviews` +- `/staff/project-tracking` +- `/staff/team-handbook` + +**Status:** ✅ Full system COMPLETE + +**Decision:** All routes properly organized, no changes needed + +--- + +### **🔷 DEV-LINK** (Cyan) - External Roblox Platform +**Routes:** +- `/dev-link` - Landing page +- `/dev-link/waitlist` - Embedded iframe to dev-link.me + +**Status:** ✅ Landing page complete (external platform) + +**Decision:** No changes needed + +--- + +## Documentation & Learning + +**Routes:** +- `/docs` (nested) - Main docs hub with sub-routes + - `/docs/getting-started` + - `/docs/platform` + - `/docs/api` + - `/docs/cli` + - `/docs/tutorials` + - `/docs/curriculum` + - `/docs/examples` + - `/docs/integrations` + +**Legacy/Duplicate:** +- `/tutorials` (separate Tutorials page, overlaps with `/docs/tutorials`) + +**Status:** ✅ Docs complete with nested routing + +**Decision:** REMOVE `/tutorials` route, consolidate to `/docs/tutorials` + +--- + +## User Profiles & Passport + +**Routes:** +- `/profile` - User profile/settings +- `/profile/me` - User profile (same as `/profile`) +- `/profile/applications` - Job applications +- `/profile/link-discord` - Discord linking +- `/passport/me` - User passport/achievements +- `/passport/:username` - Other user passport + +**Legacy/Duplicate:** +- `/developers` - DevelopersDirectory (overlaps with `/creators`) +- `/developers/:id` (redirects to LegacyPassportRedirect) +- `/profiles` (redirects to `/developers`) +- `/profiles/:id` (redirects to LegacyPassportRedirect) + +**Status:** ✅ Wired correctly but with legacy redirects + +**Decision:** +- REMOVE legacy `/developers` and `/profiles` routes +- KEEP `/passport/*` for public profiles +- KEEP `/profile` for personal settings +- These are correct and non-overlapping + +--- + +## Community & Social + +**Routes:** +- `/community` - Main social feed +- `/community/:tabId` - Dynamic tabs (legacy pattern) +- `/feed` - Alternative feed +- `/directory` - People directory +- `/squads` - Teams/groups +- `/teams` - Teams (overlaps with `/squads`) +- `/mentee-hub` - Mentorship hub + +**Status:** ⏳ Partially built + +**Decision:** +- CONSOLIDATE `/teams` → `/squads` (keep only `/squads`) +- KEEP `/mentee-hub` (will become `/foundation/mentorship` per FOUNDATION consolidation) +- CLEAN UP `/community/:tabId` (use explicit routes instead) + +--- + +## Discord Integration + +**Routes:** +- `/login` - Login page (has Discord OAuth button) +- `/profile/link-discord` - Discord linking +- `/discord-verify` - Discord verification code +- `/activity` - Discord Activity SPA + +**API Endpoints (NOT routes, but important):** +- `/api/discord/oauth/start` +- `/api/discord/oauth/callback` +- `/api/discord/activity-auth` +- `/api/discord/link` +- `/api/discord/verify-code` + +**Status:** ✅ Complete + +**Decision:** No changes needed + +--- + +## Admin & Internal + +**Routes:** +- `/admin` - Main admin dashboard +- `/admin/docs-sync` - Gitbook sync tool +- `/staff/*` - Staff portal (see STAFF section above) + +**Status:** ✅ Complete + +**Decision:** No changes needed + +--- + +## Informational & Legal + +**Routes:** +- `/about` - About page +- `/contact` - Contact page +- `/get-started` - Getting started +- `/explore` - Explore/discover +- `/careers` - Careers +- `/support` - Support +- `/status` - System status +- `/changelog` - Changelog +- `/press` - Press kit +- `/trust` - Trust/security +- `/investors` - Investor relations +- `/roadmap` - Product roadmap +- `/privacy` - Privacy policy +- `/terms` - Terms of service + +**Legacy/Duplicate:** +- `/wix/*` pages (legacy, overlaps with Corp info) + +**Status:** ✅ Complete + +**Decision:** REMOVE `/wix`, `/wix/case-studies`, `/wix/faq` (legacy) + +--- + +## Internal Docs (Notion-based) + +**Routes:** +- `/internal-docs/*` - 18 pages for internal governance, ops, finance, etc. + +**Status:** ✅ Complete + +**Decision:** Keep as-is (internal documentation) + +--- + +## Onboarding & Auth + +**Routes:** +- `/onboarding` - Signup flow +- `/login` - Login +- `/signup` - Signup redirect +- `/reset-password` - Password reset +- `/roblox-callback` - Roblox OAuth callback +- `/web3-callback` - Web3 OAuth callback + +**Status:** ✅ Complete + +**Decision:** No changes needed + +--- + +## CONSOLIDATION SUMMARY + +### 🗑️ **Routes to REMOVE** (15 routes): +1. `/research` → Merge into `/labs` +2. `/game-development` → Merge into `/gameforge` +3. `/consulting` → Merge into `/corp` +4. `/services` → Merge into `/corp` +5. `/engage` → Decide on `/pricing` consolidation +6. `/pricing` → Redirect to pricing structure +7. `/wix` → Remove (legacy) +8. `/wix/case-studies` → Remove +9. `/wix/faq` → Remove +10. `/tutorials` → Merge into `/docs/tutorials` +11. `/developers` → Consolidate to `/creators` +12. `/developers/:id` (redirect) → Remove +13. `/profiles` (redirect) → Remove +14. `/profiles/:id` (redirect) → Remove +15. `/teams` → Merge into `/squads` + +### 🔄 **Routes to RENAME/REORGANIZE** (8 changes): +1. `/community` → `/foundation` +2. `/community/teams` → `/foundation/teams` +3. `/community/about` → `/foundation/about` +4. `/community/mentorship` → `/foundation/mentorship` +5. `/community/mentorship/apply` → `/foundation/mentorship/apply` +6. `/community/mentor/:username` → `/foundation/mentors/:username` +7. `/community/groups/ethos` → `/ethos` +8. `/community/:tabId` → Remove (use explicit routes) + +### ✅ **Routes to ADD** (3 new): +1. `/hub/client` - Corp client portal (new system) +2. `/foundation/curriculum` - Public courses (Foundation system) +3. `/opportunities/new` - Post opportunity form (Nexus system) + +### 🟢 **Routes to KEEP** (100+ routes): +All properly structured routes remain as-is + +--- + +## Result After Consolidation + +``` +/ (root) +├─ auth/ +│ ├─ login +│ ├─ signup +│ ├─ reset-password +│ ├─ roblox-callback +│ └─ web3-callback +├─ onboarding +├─ dashboard +├─ profile/* +├─ passport/* +├─ arms/ +│ ├─ labs/* +│ ├─ gameforge/* +│ ├─ corp/* +│ ├─ foundation/* +│ ├─ ethos/* +│ ├─ dev-link/* +│ └─ nexus/ +├─ creator-network/ +│ ├─ creators +│ ├─ creators/:username +│ ├─ opportunities +│ ├─ opportunities/:id +│ └─ opportunities/new +├─ admin/* +├─ staff/* +├─ docs/* +├─ blog/* +├─ internal-docs/* +├─ support/* +├─ legal/ (privacy, terms) +├─ meta/ (about, contact, careers, etc.) +└─ activity (Discord) +``` + +--- + +## Implementation Priority + +### **Phase 1: Quick Wins (1-2 hours)** +1. Remove legacy routes (Wix, consulting, game-development, research) +2. Add 301 redirects where needed +3. Update navigation links + +### **Phase 2: Consolidation (4-6 hours)** +1. Rename `/community` → `/foundation` +2. Update all internal links +3. Verify all child routes work + +### **Phase 3: New Systems (P1 Priority)** +1. Add `/hub/client` (Corp portal) +2. Add `/foundation/curriculum` (Foundation courses) +3. Add `/opportunities/new` (Nexus job posting) +4. Enhance Nexus UI with messaging, contracts, payments + +### **Phase 4: Documentation** +1. Update docs with new route structure +2. Update internal reference docs + +--- + +## Recommendations + +1. **Immediate:** Clean up legacy routes to reduce confusion +2. **Strategic:** Merge `/community` → `/foundation` to align with business division naming +3. **Nexus Priority:** Enhance existing `/creators` and `/opportunities` routes with new features (vs. creating new routes) +4. **Corp Portal:** Build `/hub/client` as new authenticated dashboard +5. **Navigation:** Update header/footer to reflect consolidated routes + +--- + +## Files That Need Updates After Consolidation + +- `code/client/App.tsx` - Remove ~15 routes, reorganize +- `code/client/components/Layout.tsx` - Update navigation links +- `code/client/components/ArmSwitcher.tsx` - Update paths +- `code/client/pages/*` - Remove legacy pages +- All internal navigation references + +--- + +**End of Audit Report**