How mohmmdmahdiashouri/lmsplatform works
LMSPlatform is an in-progress LMS monolith; the supplied implementation is concentrated in identity: authentication, session management, authorization, and school creation. The principal user workflow is sign-up/sign-in through the frontend, API request handling, and backend authentication endpoints; backend CQRS handlers and persistence implement the domain operations. Other README-listed LMS domains are planned, but no implementation paths for them appear in this tree. Edges are limited to relationships visible in excerpts, the SOURCE INDEX, or documented in the README; unsampled wiring is not assumed.
Main entry points: auth.service.ts Auth service · authentication.controller.ts Authentication routes · http-client.ts API client · page.tsx Auth screens
Components 26
Frontend Experience
- Auth screens
frontend/src/app/(public)/auth/page.tsx - Auth hooks
frontend/src/features/authentication/hooks/useAuth.ts - Auth service
frontend/src/features/authentication/services/auth.service.ts
Authentication
- Authentication routes
backend/src/modules/identity/authentication/presentation/controllers/authentication.controller.ts - Session routes
backend/src/modules/identity/authentication/presentation/controllers/session.controller.ts - Verification routes
backend/src/modules/identity/authentication/presentation/controllers/verification.controller.ts - Auth commands
backend/src/modules/identity/authentication/application/commands - Auth queries
backend/src/modules/identity/authentication/application/queries - Session service
backend/src/modules/identity/authentication/application/services/authentication.service.ts - Verification service
backend/src/modules/identity/authentication/application/services/verification-token.service.ts - Session cache
backend/src/modules/identity/authentication/infrastructure/persistence/cached-session.repository.ts - Session records
backend/src/modules/identity/authentication/infrastructure/persistence/prisma-session.repository.ts - Verification email
backend/src/modules/identity/authentication/infrastructure/email
Identity Management
- Role authorization
backend/src/modules/identity/authorization/application/services/authorization.service.ts - School routes
backend/src/modules/identity/school-management/presentation/controllers/school.controller.ts - Create school
backend/src/modules/identity/school-management/application/commands/create-school.handler.ts - School persistence
backend/src/modules/identity/school-management/infrastructure/persistence/prisma-school.repository.ts
Shared Backend Services
- Backend entry
backend/src/main.ts - Application modules
backend/src/app.module.ts - Outbox processing
backend/src/shared/common/infrastructure/outbox-processor.service.ts - SMTP sender
backend/src/shared/email/smtp-email.sender.ts
API Client
- API client
frontend/src/shared/features/api-client/lib/http-client.ts - Browser transport
frontend/src/shared/features/api-client/lib/axios-client.ts - Server transport
frontend/src/shared/features/api-client/lib/fetch-client.ts - Token store
frontend/src/shared/features/api-client/lib/auth-store.ts
Other components
- LMS user
Connections 16
- LMS user → Auth screens: uses
- Auth screens → Auth hooks: uses
- Auth hooks → Auth service: calls
frontend/src/features/authentication/hooks/useAuth.ts - Auth service → API client: sends requests
frontend/src/features/authentication/services/auth.service.ts - API client → Browser transport: dispatches CSR
frontend/src/shared/features/api-client/lib/http-client.ts - API client → Server transport: dispatches SSR
frontend/src/shared/features/api-client/lib/http-client.ts - Browser transport → Token store: reads token
frontend/src/shared/features/api-client/lib/axios-client.ts - Auth service → Authentication routes: calls HTTP routes
frontend/src/features/authentication/services/auth.service.ts - Backend entry → Application modules: starts
backend/src/main.ts - Authentication routes → Auth commands: dispatches commands
backend/src/modules/identity/authentication/presentation/controllers/authentication.controller.ts - Authentication routes → Auth queries: dispatches queries
backend/src/modules/identity/authentication/presentation/controllers/authentication.controller.ts - Session service → Session cache: uses repository
backend/src/modules/identity/authentication/application/services/authentication.service.ts - Session cache → Session records: reads and writes
backend/src/modules/identity/authentication/infrastructure/persistence/cached-session.repository.ts - School routes → Create school: dispatches command
backend/src/modules/identity/school-management/presentation/controllers/school.controller.ts - Create school → School persistence: uses repository
- Verification email → SMTP sender: sends email