How dev-michaeljohn/my-app works
PIT-FES is an academic evaluation platform: users sign in, manage institutional records and class rosters, configure evaluation instruments and schedules, submit evaluations, and review reports and analytics. The frontend routes role- and permission-specific pages; the backend exposes versioned API routes backed by controllers and services. Shared schemas and types define cross-app domain contracts. The sampled evidence confirms app/router wiring and selected module references, but not most controller-to-service calls or frontend HTTP-to-backend links; those links are therefore omitted or marked unverified.
Main entry points: AppRoutes.tsx App routes · index.router.ts Versioned routes · user.service.ts Accounts and roles · app.ts HTTP application
Components 24
Web client
- App routes
apps/frontend/src/app/AppRoutes.tsx - Authentication UI
apps/frontend/src/features/auth - Dashboards
apps/frontend/src/features/dashboard - Academic admin UI
apps/frontend/src/features - Evaluation UI
apps/frontend/src/features/evaluations - Analytics UI
apps/frontend/src/features/analytics - User management UI
apps/frontend/src/features/users - API client
apps/frontend/src/lib/api.lib.ts
Backend API
- HTTP application
apps/backend/src/app.ts - Versioned routes
apps/backend/src/routers/index.router.ts - Authentication services
apps/backend/src/services/auth.service.ts - Evaluation endpoints
apps/backend/src/routers/evaluation-builder.router.ts - Evaluation processing
apps/backend/src/services - Analytics processing
apps/backend/src/services/analytics.service.ts - Logging
apps/backend/src/libs/logger.lib.ts
Academic operations
- Institution records
apps/backend/src/services/college.service.ts - Accounts and roles
apps/backend/src/services/user.service.ts - Email and OTP
apps/backend/src/services/email.service.ts - Live updates
apps/backend/src/libs/socket.lib.ts
Shared contracts
- Auth schemas
packages/shared/src/schemas/auth.schema.ts - Institution schemas
packages/shared/src/schemas/institution.schema.ts - Evaluation contracts
packages/shared/src/schemas/evaluation-instrument.schema.ts - User types
packages/shared/src/types/user.type.ts
Other components
- Staff / learner
Connections 24
- Staff / learner → App routes: opens pages
apps/frontend/src/app/AppRoutes.tsx - App routes → Authentication UI: routes login
apps/frontend/src/app/AppRoutes.tsx - App routes → Dashboards: routes dashboard
apps/frontend/src/app/AppRoutes.tsx - App routes → Academic admin UI: routes admin
apps/frontend/src/app/AppRoutes.tsx - App routes → Evaluation UI: routes evaluations
apps/frontend/src/app/AppRoutes.tsx - App routes → Analytics UI: routes analytics
- App routes → User management UI: routes user admin
- HTTP application → Versioned routes: mounts API
apps/backend/src/app.ts - Versioned routes → Evaluation endpoints: mounts endpoint
apps/backend/src/routers/index.router.ts - Versioned routes → Authentication services: mounts auth routes
apps/backend/src/routers/index.router.ts - Versioned routes → Institution records: mounts academic routes
apps/backend/src/routers/index.router.ts - Evaluation endpoints → Evaluation processing: dispatches processing
- API client → HTTP application: sends API requests
- Authentication services → Accounts and roles: uses account service
apps/backend/src/services/auth.service.ts - Authentication services → Email and OTP: uses OTP service
apps/backend/src/services/auth.service.ts - Accounts and roles → Email and OTP: uses email service
apps/backend/src/services/user.service.ts - Institution records → Accounts and roles: uses account service
apps/backend/src/services/college.service.ts - Institution records → Institution schemas: uses domain schema
apps/backend/src/services/college.service.ts - Accounts and roles → User types: uses user types
apps/backend/src/services/user.service.ts - Evaluation UI → Evaluation contracts: uses evaluation contracts
- Authentication UI → Auth schemas: uses auth types
apps/frontend/src/features/auth/hooks/useAuth.ts - Logging → Live updates: streams logs
apps/backend/src/libs/logger.lib.ts - HTTP application → Logging: logs requests
apps/backend/src/app.ts - Versioned routes → Analytics processing: mounts analytics routes
apps/backend/src/routers/index.router.ts