How the-ai-rishi/theairishi works
The AI Rishi is a public technology-learning platform centered on a published, 120-day DevOps program. Learners enter through the homepage or /learn, choose a published lesson, read its content, and use lesson navigation and progress features to continue. Separate surfaces expose guides, projects, topics, and channel media; search and shared visibility rules support discovery. The README describes content as JSON and Markdown-driven and compiled for production. Several subsystem links below rely on SOURCE INDEX references or README statements; unsampled implementation details are not inferred.
Main entry points: catalog.ts Live Catalog · page.tsx Lesson Route · content.ts Content Service · programs.ts Program Service
Components 29
Discovery & Shell
- Homepage
app/page.tsx - Home Sections
components/product/ProductHome.tsx - Page Shell
components/brand/PageShell.tsx - Navigation Header
components/layout/Header.tsx - Search Endpoint
app/api/search/route.ts - Search Interface
components/search/SearchModal.tsx
Learning Journey
- Program Catalog
app/learn/page.tsx - Program Overview
components/learning/ProgramOverview.tsx - Lesson Route
app/learn/[slug]/page.tsx - Lesson Content
components/learning/LessonContent.tsx - Lesson Controls
components/learning/LessonNavigation.tsx
Content Surfaces
- Guides
app/guides/page.tsx - Guide Detail
app/guides/[slug]/page.tsx - Projects
app/projects/page.tsx - Project Detail
app/projects/[slug]/page.tsx - Topic Pages
app/topics/[topic]/page.tsx - Channel Media
app/[channel]/page.tsx
Content Runtime
- Content Service
lib/content.ts - Guide Service
lib/guides.ts - Lesson Service
lib/lessons.ts - Program Service
lib/programs.ts - Live Catalog
lib/catalog.ts - Visibility Rules
lib/visibility-core.js - Platform Config
lib/config.ts - Search Service
lib/search.ts
Learner State
- Progress UI
components/learning/useLessonProgress.ts - Progress Runtime
lib/learner-progress.js - Progress Repository
lib/progress-repository.ts
Other components
- Learner
Connections 41
- Learner → Homepage: opens
README.md - Homepage → Home Sections: renders
app/page.tsx - Homepage → Page Shell: wraps
app/page.tsx - Page Shell → Navigation Header: renders
components/brand/PageShell.tsx - Navigation Header → Search Interface: opens
components/layout/Header.tsx - Search Interface → Search Endpoint: queries
- Search Endpoint → Search Service: calls
app/api/search/route.ts - Learner → Program Catalog: browses
README.md - Program Catalog → Program Overview: renders
app/learn/page.tsx - Program Overview → Program Service: reads program
components/learning/ProgramOverview.tsx - Learner → Lesson Route: opens lesson
README.md - Lesson Route → Lesson Service: loads lesson
app/learn/[slug]/page.tsx - Lesson Route → Lesson Content: renders
app/learn/[slug]/page.tsx - Lesson Route → Lesson Controls: renders
app/learn/[slug]/page.tsx - Lesson Route → Program Service: loads context
app/learn/[slug]/page.tsx - Lesson Controls → Lesson Route: navigates
app/learn/[slug]/page.tsx - Progress UI → Progress Runtime: uses
components/learning/useLessonProgress.ts - Progress Repository → Progress Runtime: wraps
lib/progress-repository.ts - Learner → Guides: browses
README.md - Guides → Guide Service: loads guides
app/guides/page.tsx - Guide Detail → Guide Service: loads guide
app/guides/[slug]/page.tsx - Learner → Projects: browses
- Projects → Project Detail: opens project
- Projects → Content Service: loads projects
lib/content.ts - Topic Pages → Content Service: loads topic content
app/topics/[topic]/page.tsx - Topic Pages → Live Catalog: checks route
app/topics/[topic]/page.tsx - Channel Media → Live Catalog: checks route
app/[channel]/page.tsx - Content Service → Guide Service: uses
lib/content.ts - Content Service → Lesson Service: uses
lib/content.ts - Content Service → Platform Config: reads
lib/content.ts - Live Catalog → Content Service: collects published content
lib/catalog.ts - Live Catalog → Lesson Service: counts courses
lib/catalog.ts - Live Catalog → Program Service: loads program
lib/catalog.ts - Live Catalog → Platform Config: reads config
lib/catalog.ts - Live Catalog → Visibility Rules: builds visibility inputs
lib/catalog.ts - Program Service → Lesson Service: hydrates days
lib/programs.ts - Program Service → Visibility Rules: normalizes status
lib/programs.ts - Search Service → Live Catalog: uses catalog
lib/search.ts - Search Service → Visibility Rules: filters results
lib/search.ts - Search Service → Platform Config: reads config
lib/search.ts - Visibility Rules → Platform Config: evaluates config
lib/config.ts