Complete AeThex Ecosystem Audit & Consolidation Plan
cgen-9b2fd78299b14f7ba399a01163a82e76
This commit is contained in:
Builder.io
parent
170b5747bd
commit
fc4811cad4
1 changed files with 450 additions and 0 deletions
450
docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md
Normal file
450
docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md
Normal file
|
|
@ -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**
|
||||
Loading…
Reference in a new issue