How thomas-gosnet/libheros-test works
This is a task-management application with a Nuxt browser client and a NestJS modular-monolith API backed by PostgreSQL. The main workflow is: a user registers or signs in, restores an authenticated session, manages owned lists and their tasks, and receives socket updates reflected in shared client state. The graph keeps list and task operations distinct and includes authentication, persistence, and realtime delivery. Some subsystem links are based on README statements because their implementation files were not excerpted.
Main entry points: realtime.gateway.ts Socket gateway · app.module.ts Nest application · index.vue App pages · useApi.ts API client
Components 23
Browser application
- App pages
apps/web/app/pages/index.vue - Route guards
apps/web/app/middleware/auth.ts - Task UI
apps/web/app/components/TaskCard.vue - Pinia stores
apps/web/app/stores/tasks.ts - API client
apps/web/app/composables/useApi.ts - Socket client
apps/web/app/plugins/socket.client.ts
API boundaries
- Nest application
apps/api/src/app.module.ts - Auth endpoints
apps/api/src/auth/auth.controller.ts - List endpoints
apps/api/src/lists/lists.controller.ts - Task endpoints
apps/api/src/tasks/tasks.controller.ts - List task endpoints
apps/api/src/tasks/list-tasks.controller.ts
Identity and users
- Session service
apps/api/src/auth/auth.service.ts - User records
apps/api/src/users/infrastructure/prisma-user.repository.ts - Refresh sessions
apps/api/src/auth/infrastructure/prisma-refresh-token.repository.ts
Lists and tasks
- List service
apps/api/src/lists/lists.service.ts - List records
apps/api/src/lists/infrastructure/prisma-list.repository.ts - Task service
apps/api/src/tasks/tasks.service.ts - Task records
apps/api/src/tasks/infrastructure/prisma-task.repository.ts - PostgreSQL
Realtime updates
- Socket gateway
apps/api/src/realtime/realtime.gateway.ts - List broadcaster
apps/api/src/realtime/domain/list-broadcaster.ts - Task broadcaster
apps/api/src/realtime/domain/task-broadcaster.ts
Other components
- User
Connections 32
- User → App pages: uses
README.md - App pages → Route guards: guards routes
README.md - App pages → Task UI: renders
README.md - Task UI → Pinia stores: updates state
README.md - App pages → API client: requests data
- Socket client → Pinia stores: applies events
README.md - Socket client → Socket gateway: exchanges events
README.md - API client → Auth endpoints: calls API
- API client → List endpoints: calls API
- API client → Task endpoints: calls API
- Nest application → Auth endpoints: registers
apps/api/src/app.module.ts - Nest application → List endpoints: registers
apps/api/src/app.module.ts - Nest application → Task endpoints: registers
apps/api/src/app.module.ts - Nest application → Socket gateway: registers
apps/api/src/app.module.ts - Auth endpoints → Session service: delegates
apps/api/src/auth/auth.controller.ts - Session service → User records: reads and writes
apps/api/src/auth/auth.service.ts - Session service → Refresh sessions: rotates tokens
apps/api/src/auth/auth.service.ts - List endpoints → List service: delegates
apps/api/src/lists/lists.controller.ts - List service → List records: reads and writes
apps/api/src/lists/lists.service.ts - List task endpoints → Task service: delegates
apps/api/src/tasks/list-tasks.controller.ts - Task endpoints → Task service: delegates
apps/api/src/tasks/tasks.controller.ts - Task service → Task records: reads and writes
apps/api/src/tasks/tasks.service.ts - List records → PostgreSQL: persists
README.md - Task records → PostgreSQL: persists
README.md - User records → PostgreSQL: persists
README.md - Refresh sessions → PostgreSQL: persists
README.md - List service → List broadcaster: emits changes
README.md - Task service → Task broadcaster: emits changes
README.md - Socket gateway → List records: checks ownership
README.md - Socket gateway → User: authenticates socket
README.md - List broadcaster → Socket gateway: broadcasts
- Task broadcaster → Socket gateway: broadcasts