How hmsmiraz/techedu works
TechEdu is an LMS with a public signup site, an admin console for account and course-content management, and a student portal for approved learners. The main workflow is signup and login, admin approval, then authenticated module access; administrators also manage users, modules, and resources. Two FastAPI services provide these domain stages and persist data separately in MySQL. The README documents a shared Nginx gateway and a self-hosted metrics, logs, and traces stack. Deployment and infrastructure files are absent from the supplied tree, so those documented components have no repository paths; unsampled connections are omitted or marked unverified.
Main entry points: auth.py Auth API · app/main.py Auth service entry · app/main.py Content service entry · database.py Auth persistence
Components 20
Web applications
- Landing and signup
apps/landing/src/app/signup/page.tsx - Landing login
apps/landing/src/app/login/page.tsx - Admin console
apps/admin/src/app/users/page.tsx - Content editor
apps/admin/src/app/content/page.tsx - Student portal
apps/learning-portal/src/app/page.tsx
Identity service
- Auth API
services/auth-service/app/routers/auth.py - User administration
services/auth-service/app/routers/admin_users.py - Password and JWT security
services/auth-service/app/security.py - Auth persistence
services/auth-service/app/database.py - Auth service entry
services/auth-service/app/main.py
Learning content
- Module API
services/content-service/app/routers/modules.py - Module and resource management
services/content-service/app/routers/admin_content.py - Content persistence
services/content-service/app/database.py - Content service entry
services/content-service/app/main.py
Observability
- Auth instrumentation
services/auth-service/app/telemetry.py - Content instrumentation
services/content-service/app/telemetry.py - Metrics, logs, traces
Other components
- Learner or admin
- Nginx gateway
- MySQL
Connections 26
- Learner or admin → Nginx gateway: visits
README.md - Nginx gateway → Landing and signup: routes requests
README.md - Nginx gateway → Admin console: routes requests
README.md - Nginx gateway → Student portal: routes requests
README.md - Landing and signup → Auth API: submits signup
- Landing login → Auth API: submits login
- Admin console → User administration: manages accounts
README.md - Content editor → Module and resource management: manages courses
README.md - Student portal → Module API: requests modules
README.md - Auth service entry → Auth API: registers router
services/auth-service/app/main.py - Auth service entry → User administration: registers router
services/auth-service/app/main.py - Auth service entry → Auth instrumentation: sets up telemetry
services/auth-service/app/main.py - Content service entry → Module API: registers router
services/content-service/app/main.py - Content service entry → Module and resource management: registers router
services/content-service/app/main.py - Content service entry → Content instrumentation: sets up telemetry
services/content-service/app/main.py - Auth API → Password and JWT security: hashes and issues tokens
services/auth-service/app/routers/auth.py - Auth API → Auth persistence: reads and writes
services/auth-service/app/routers/auth.py - User administration → Auth persistence: reads and writes
services/auth-service/app/routers/admin_users.py - Module API → Content persistence: reads modules
services/content-service/app/routers/modules.py - Module and resource management → Content persistence: reads and writes
services/content-service/app/routers/admin_content.py - Auth service entry → Auth persistence: waits and creates tables
services/auth-service/app/main.py - Content service entry → Content persistence: waits and creates tables
services/content-service/app/main.py - Auth persistence → MySQL: connects to database
- Content persistence → MySQL: connects to database
- Auth instrumentation → Metrics, logs, traces: emits telemetry
README.md - Content instrumentation → Metrics, logs, traces: emits telemetry
README.md