How mudybluez/ai-transcription-platform works
ZenScribe is a microservices platform that turns uploaded files or YouTube links into multilingual transcripts and AI study materials. Users enter through the React client, submit media, and receive processed reports, mind maps, and notifications; account, billing, search, and administration provide supporting capabilities. The README documents the service boundaries and major features; source-index references and excerpts establish several internal calls, while some gateway routing and integrations are documented rather than shown in sampled code.
Main entry points: App.jsx React application · src/index.js API gateway · Dashboard.jsx Dashboard · src/index.js User service
Components 31
Web client
- React application
frontend/src/App.jsx - Login
frontend/src/pages/Login.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Profile and billing
frontend/src/pages/Profile.jsx - Admin panel
frontend/src/pages/AdminPanel.jsx - Global mind maps
frontend/src/pages/GlobalMindMap.jsx - Mind map view
frontend/src/pages/MindMap.jsx - Landing page
frontend/src/pages/LandingPage.jsx - Hero animation
frontend/src/pages/HeroParticles.jsx - Notifications UI
frontend/src/components/NotificationsBell.jsx - Shared WebSocket
frontend/src/utils/sharedSocket.js - API client
frontend/src/api.js
API and accounts
- API gateway
api-gateway/src/index.js - User service
services/user-service/src/index.js - User data access
services/user-service/src/db.js - Email delivery
services/user-service/src/emailService.js - Nginx entry point
Media processing
- Upload service
services/upload-service/src/index.js - Upload data access
services/upload-service/src/db.js - RabbitMQ jobs
- Processing worker
services/ai-processing-service/worker.py - Transcription and analysis
services/ai-processing-service/ai_core.py - Processing persistence
services/ai-processing-service/db.py
Search and learning
- Search service
services/search-service/src/index.js - Search data access
services/search-service/src/db.js - Redis cache
services/search-service/src/redisClient.js - Proxy usage stats
services/search-service/src/astroproxyService.js - Mind map service
services/mindmap-service/src/main.py
Platform state
- PostgreSQL
- Stripe / PayPal
Other components
- Platform user
Connections 39
- Platform user → Nginx entry point: opens app
README.md - Nginx entry point → React application: serves SPA
README.md - Nginx entry point → API gateway: proxies API
README.md - React application → Login: routes to
frontend/src/App.jsx - React application → Dashboard: routes to
frontend/src/App.jsx - React application → Profile and billing: routes to
frontend/src/App.jsx - React application → Admin panel: routes to
frontend/src/App.jsx - React application → Global mind maps: routes to
frontend/src/App.jsx - React application → Landing page: routes to
frontend/src/App.jsx - Dashboard → API client: requests data
frontend/src/pages/Dashboard.jsx - Dashboard → Mind map view: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Hero animation: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Notifications UI: renders
frontend/src/pages/Dashboard.jsx - Landing page → Hero animation: renders
frontend/src/pages/LandingPage.jsx - Notifications UI → API client: fetches notices
frontend/src/components/NotificationsBell.jsx - Notifications UI → Shared WebSocket: subscribes
frontend/src/components/NotificationsBell.jsx - API client → API gateway: sends API requests
frontend/src/api.js - API gateway → User service: routes requests
README.md - API gateway → Upload service: routes requests
README.md - API gateway → Search service: routes requests
README.md - API gateway → Mind map service: routes requests
README.md - API gateway → Shared WebSocket: manages WebSockets
README.md - User service → User data access: uses
services/user-service/src/index.js - User service → Email delivery: sends mail
services/user-service/src/index.js - User service → Stripe / PayPal: integrates billing
README.md - Upload service → Upload data access: uses
services/upload-service/src/index.js - Upload service → RabbitMQ jobs: publishes jobs
README.md - RabbitMQ jobs → Processing worker: delivers jobs
README.md - Processing worker → Transcription and analysis: calls analysis
services/ai-processing-service/worker.py - Processing worker → Processing persistence: updates and saves
services/ai-processing-service/worker.py - Processing worker → Mind map service: posts mind map
services/ai-processing-service/worker.py - Search service → Search data access: queries data
services/search-service/src/index.js - Search service → Redis cache: uses cache
services/search-service/src/index.js - Search service → Proxy usage stats: gets proxy stats
services/search-service/src/index.js - Proxy usage stats → Search data access: queries totals
services/search-service/src/astroproxyService.js - User data access → PostgreSQL: reads and writes
README.md - Upload data access → PostgreSQL: reads and writes
README.md - Processing persistence → PostgreSQL: persists results
README.md - Search data access → PostgreSQL: queries transcriptions
README.md