AeThex-OS/temp-forge-extract/aethex-forge-main/docs/ECOSYSTEM_AUDIT_AND_CONSOLIDATION.md
MrPiglr b3c308b2c8 Add functional marketplace modules, bottom nav bar, root terminal, arcade games
- ModuleManager: Central tracking for installed marketplace modules
- DataAnalyzerWidget: Real-time CPU/RAM/Battery/Storage widget (unlocked by Data Analyzer module)
- BottomNavBar: Navigation bar for Projects/Chat/Marketplace/Settings
- RootShell: Real root command execution utility
- TerminalActivity: Full root shell with neofetch, sysinfo, real Linux commands
- Terminal Pro module: Adds aliases (ll, la, h), command history
- ArcadeActivity + SnakeGame: Pixel Arcade module unlocks retro games
- fade_in/fade_out animations for smooth transitions
2026-02-18 22:03:50 -07:00

13 KiB

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


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


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