Dev vs Main Branch Comparison - Train5D Documentation

Train5D Platform Documentation

Last Updated: 2026-03-01

Dev vs Main Branch Comparison

Documentation Update Requirements

Generated: March 1, 2026
Comparison: main → dev branch
Last Architecture Doc Update: December 2-13, 2025

Executive Summary

The dev branch has 122 new pages and components that are not documented in the current architecture documentation. The last architecture documentation update was December 2-13, 2025, meaning approximately 3 months of development is undocumented.

Critical Documentation Needing Updates:

  1. ✅ docs/architecture/APPLICATION_ARCHITECTURE.md (Last updated: Dec 2, 2025)
  2. ✅ docs/design-planning/PAGE_INVENTORY.md (Last updated: Dec 2, 2025)
  3. ✅ docs/architecture/ARCHITECTURE.md (Last updated: Dec 13, 2025)
  4. ✅ docs/architecture/FIVE_PILLARS_INTEGRATION.md (Last updated: Dec 2, 2025)
  5. ⚠️ API documentation (needs creation - currently missing)

New Pages Summary

Total Additions: 45 Pages

Category Count Status
Admin Pages 17 ❌ Not Documented
API Routes 18 ❌ Not Documented
Learn/Anatomy Pages 4 ❌ Not Documented
Assessment Pages 2 ❌ Not Documented
Workout/Tool Pages 2 ❌ Not Documented
Dev/Testing Pages 3 ❌ Not Documented

Detailed Breakdown

1. New Learn Pages (Anatomy Detail Pages) - 4 Pages

These pages represent a major expansion of the Anatomy/Posture pillar (Pillar 3):

app/pages/learn/anatomy/movement-patterns/[id].tsx
app/pages/learn/anatomy/movement-systems/[id].tsx
app/pages/learn/anatomy/organ-systems/[id].tsx
app/pages/learn/anatomy/skeletal-system/[id].tsx

Impact: These 4 pages indicate complete implementation of anatomy detail views, expanding beyond what was documented in December. This is a major pillar expansion.

Documentation Updates Needed: - APPLICATION_ARCHITECTURE.md: Update “Posture (Pillar 3)” section - PAGE_INVENTORY.md: Add entire “Learn/Anatomy” section - FIVE_PILLARS_INTEGRATION.md: Document anatomy-exercise integration patterns

2. New Assessment Pages - 2 Pages

app/pages/assessments/chat/[id].tsx    ← NEW: AI-powered chat assessments
app/pages/assessments/index.tsx        ← NEW: Assessment library landing

Impact: Introduction of AI-powered conversational assessments - a major new feature not mentioned in any architecture docs.

Documentation Updates Needed: - APPLICATION_ARCHITECTURE.md: Add “AI Assessment Chat System” section - PAGE_INVENTORY.md: Update assessment pages section - New API endpoint documentation needed for /api/assessments/chat

3. New Workout/Tool Pages - 2 Pages

app/pages/workout-builder/index.tsx    ← Major new tool
app/pages/workout/active.tsx           ← Active workout tracking

Impact: Workout Builder is a completely new major tool, and Active Workout Tracking represents real-time workout execution functionality.

Documentation Updates Needed: - APPLICATION_ARCHITECTURE.md: Add “Workout Builder System” section - APPLICATION_ARCHITECTURE.md: Add “Active Workout Tracking” section - PAGE_INVENTORY.md: Add workout-builder and workout pages - Component documentation for workout builder components

4. New Admin Pages - 17 Pages

Exercise Management (6 pages):

app/pages/admin/exercise/checkpoints/[id]/edit.tsx
app/pages/admin/exercise/checkpoints/new.tsx
app/pages/admin/exercise/equipment/[id]/edit.tsx
app/pages/admin/exercise/equipment/new.tsx
app/pages/admin/exercise/progressions/[id]/edit.tsx
app/pages/admin/exercise/progressions/new.tsx

Nutrition Management (4 pages):

app/pages/admin/nutrition/healing-foods/[id]/edit.tsx
app/pages/admin/nutrition/healing-foods/new.tsx
app/pages/admin/nutrition/herbs-spices/[id]/edit.tsx
app/pages/admin/nutrition/herbs-spices/new.tsx

Tagging System (4 pages):

app/pages/admin/nutrition/tags.tsx
app/pages/admin/tags.tsx
app/pages/admin/tags/[id]/edit.tsx
app/pages/admin/tags/new.tsx

Swimming Activities (2 pages):

app/pages/admin/swimming-activities/[id]/edit.tsx
app/pages/admin/swimming-activities/new.tsx

User Management (1 page):

app/pages/admin/users/new.tsx

Impact: Massive expansion of admin capabilities including: - Complete tagging system (cross-pillar feature) - Healing foods & herbs/spices management (nutrition expansion) - Swimming-specific activities (exercise sub-category) - Enhanced user management

Documentation Updates Needed: - APPLICATION_ARCHITECTURE.md: Update “Exercise Management System” section - APPLICATION_ARCHITECTURE.md: Update “Nutrition Management System” section - APPLICATION_ARCHITECTURE.md: Add “Tagging System” section - APPLICATION_ARCHITECTURE.md: Add “Swimming Activities” sub-section - PAGE_INVENTORY.md: Add all 17 admin pages

5. New API Routes - 18 Endpoints

Assessment APIs (1):

/api/assessments/chat                  ← AI chat assessment endpoint

Authentication/Session (1):

/api/auth/app-signout                  ← Enhanced signout

Dashboard (1):

/api/dashboard/picked-for-you          ← Personalized recommendations

Homepage Preview APIs (4):

/api/homepage/anatomy-preview
/api/homepage/exercise-preview
/api/homepage/mindset-preview
/api/homepage/nutrition-preview

Nutrition APIs (5):

/api/pillars/nutrition/active-compounds
/api/pillars/nutrition/food-subgroups
/api/pillars/nutrition/foods-mini
/api/pillars/nutrition/healing-properties
/api/pillars/nutrition/phytonutrients

User/Workout APIs (3):

/api/user/timezone
/api/user/update-timezone
/api/user/workout-plans/[id]

Tagging System (1):

/api/tags/[id]

Workout Session (1):

/api/workout/session                   ← Active workout tracking

Debug (1):

/api/debug/check-nutrient-schema

Impact: 18 new API endpoints represent: - Homepage system with pillar previews (4 endpoints) - Enhanced nutrition APIs (5 endpoints) - major data layer expansion - Workout session tracking - real-time workout support - AI assessment chat - new AI integration - Personalized recommendations - ML/algorithm-driven content - Tagging system - cross-pillar organization

Documentation Updates Needed: - Create NEW: docs/architecture/API_REFERENCE.md with all endpoints - APPLICATION_ARCHITECTURE.md: Add “API Architecture” section - FIVE_PILLARS_INTEGRATION.md: Document cross-pillar API patterns

6. Dev/Testing Pages - 3 Pages

app/pages/dev/integration-storyboard.tsx
app/pages/dev/integration-visuals.tsx
app/pages/dev/toast-test.tsx

Impact: Development pages for testing integration flows and UI components.

Documentation Updates Needed: - PAGE_INVENTORY.md: Add dev/testing section (optional)

New Components - 20+ Major Additions

Homepage Components (5):

components/homepage/HeroSection.tsx
components/homepage/IntegrationConversation.tsx
components/homepage/IntegrationStoryboard.tsx
components/homepage/IntegrationVisual.tsx
components/homepage/PhilosophySection.tsx

Impact: Complete homepage system with integration visualizations.

Admin Components (5):

components/admin/StatCard.tsx
components/admin/anatomy/MuscleGroupFormImages.tsx
components/admin/anatomy/OrganSystemFormImages.tsx
components/admin/anatomy/SkeletalSystemFormImages.tsx
components/admin/exercise/EquipmentFormImages.tsx

Dashboard Components (1):

components/dashboard/PickedForYouSection.tsx  ← Personalized recommendations

Shared/Common Components (4):

components/common/CustomSelect.tsx
components/shared/Badge.tsx
components/shared/Loading.tsx
components/shared/PageHero.tsx

Nutrition Components (1):

components/nutrition/HealingPathwayFlow.tsx   ← Visualization component

Documentation Updates Needed: - APPLICATION_ARCHITECTURE.md: Add “Homepage System” section - APPLICATION_ARCHITECTURE.md: Update component architecture sections - CURRENT_DESIGN_PATTERNS.md: Document new patterns (Badge, Loading, PageHero)

Architecture Documentation Update Checklist

1. docs/architecture/APPLICATION_ARCHITECTURE.md

Sections to Add: - [ ] AI Assessment Chat System - New conversational assessment feature - [ ] Workout Builder System - Complete workout creation tool - [ ] Active Workout Tracking - Real-time workout execution - [ ] Homepage System - Landing page with pillar previews - [ ] Tagging System - Cross-pillar content organization - [ ] Personalized Recommendations - “Picked For You” algorithm - [ ] Swimming Activities - Exercise sub-category - [ ] API Architecture - Overview of 18 new endpoints

Sections to Update: - [ ] Posture (Pillar 3) - Add 4 new anatomy detail pages - [ ] Exercise Management System - Add checkpoints, progressions, equipment CRUD - [ ] Nutrition Management System - Add healing foods, herbs/spices, enhanced APIs - [ ] Assessment System - Add chat assessments - [ ] Directory Structure - Update with new page routes - [ ] Technology Stack - Confirm any new tech (AI integration?)

2. docs/design-planning/PAGE_INVENTORY.md

Sections to Add: - [ ] Learn/Anatomy Pages (4 pages) - Movement Patterns Detail - Movement Systems Detail - Organ Systems Detail - Skeletal System Detail - [ ] Assessment Pages (2 pages) - Chat Assessment - Assessment Library Index - [ ] Workout Pages (2 pages) - Workout Builder - Active Workout - [ ] Admin Exercise Pages (6 pages) - [ ] Admin Nutrition Pages (4 pages) - [ ] Admin Tagging Pages (4 pages) - [ ] Admin Swimming Pages (2 pages) - [ ] Admin User Pages (1 page) - [ ] Dev/Testing Pages (3 pages - optional)

Sections to Update: - [ ] API Routes - Add all 18 new endpoints - [ ] Component Dependencies - Add new homepage, dashboard, shared components

3. docs/architecture/FIVE_PILLARS_INTEGRATION.md

Sections to Add: - [ ] Tagging System Integration - How tags connect pillars - [ ] Homepage Pillar Previews - Cross-pillar content discovery - [ ] Healing Pathways - Nutrition-Anatomy-Exercise integration - [ ] Personalized Recommendations - Cross-pillar ML algorithm

Sections to Update: - [ ] Exercise-Anatomy Integration - Movement patterns + systems connections - [ ] Nutrition-Anatomy Integration - Healing foods + organ systems

4. docs/architecture/ARCHITECTURE.md

Sections to Update: - [ ] Routing Structure - Add new page routes - [ ] Component Hierarchy - Add homepage, workout builder components - [ ] State Management - Document any new patterns for workout tracking

5. NEW FILE NEEDED: docs/architecture/API_REFERENCE.md

Create comprehensive API documentation: - [ ] Assessment APIs - Chat, responses, public assessments - [ ] Homepage APIs - Pillar previews (anatomy, exercise, mindset, nutrition) - [ ] Nutrition APIs - Active compounds, food subgroups, healing properties, phytonutrients - [ ] Workout APIs - Session tracking, workout plans - [ ] User APIs - Timezone management - [ ] Tagging APIs - Tag CRUD operations - [ ] Dashboard APIs - Picked-for-you recommendations - [ ] Authentication APIs - App signout

Key Feature Additions Not Documented

1. AI-Powered Assessment Chat 🤖

2. Workout Builder 🏋️

3. Active Workout Tracking ⏱️

4. Personalized Recommendations 🎯

5. Tagging System 🏷️

6. Homepage System 🏠

7. Anatomy Detail Pages 🧘

8. Enhanced Nutrition APIs 🥗

9. Swimming Activities 🏊

10. Healing Foods & Herbs/Spices 🌿

Priority 1: Critical Architecture Updates

  1. APPLICATION_ARCHITECTURE.md
    • Add major new systems (Workout Builder, AI Chat, Homepage)
    • Update pillar sections (Exercise, Nutrition, Posture)
    • Add API architecture overview
  2. Create API_REFERENCE.md
    • Document all 18 new endpoints
    • Include request/response schemas
    • Authentication requirements

Priority 2: Page Inventory

  1. PAGE_INVENTORY.md
    • Add all 45 new pages
    • Update route table
    • Document component dependencies

Priority 3: Integration Patterns

  1. FIVE_PILLARS_INTEGRATION.md
    • Document tagging system
    • Homepage pillar previews
    • Healing pathway integrations

Priority 4: Design Patterns

  1. CURRENT_DESIGN_PATTERNS.md
    • New shared components (Badge, Loading, PageHero)
    • Homepage component patterns
    • Form image upload patterns

Statistics

Documentation Gap Analysis

Metric Count Status
Days Since Last Doc Update ~88 days ⚠️ Critical
New Pages Undocumented 45 ❌ Not Documented
New Components Undocumented 20+ ❌ Not Documented
New API Endpoints Undocumented 18 ❌ Not Documented
Major Features Undocumented 10 ❌ Not Documented
Estimated Documentation Effort 8-12 hours 📝 Required

Next Steps

  1. Review this comparison document to understand scope
  2. Prioritize documentation updates based on recommendations above
  3. Update APPLICATION_ARCHITECTURE.md first (covers major systems)
  4. Create API_REFERENCE.md (new file needed)
  5. Update PAGE_INVENTORY.md (comprehensive page list)
  6. Update FIVE_PILLARS_INTEGRATION.md (cross-pillar patterns)
  7. Update CURRENT_DESIGN_PATTERNS.md (new component patterns)

Conclusion

The dev branch represents significant platform evolution with 10 major new features, 45 new pages, and 18 new API endpoints. The current architecture documentation is approximately 3 months out of date and requires comprehensive updates to reflect:

Estimated Time to Update All Documentation: 8-12 hours

Recommended Approach: Incremental updates starting with APPLICATION_ARCHITECTURE.md, then API_REFERENCE.md (new), then PAGE_INVENTORY.md.