jihedsaguer/neurostage_ai_backend

How jihedsaguer/neurostage_ai_backend works

The source tree describes a NestJS backend for internship and academic-placement management, with authentication, user profiles, applications, supervision, milestones, messaging, AI/RAG, analytics, and audit capabilities. The likely user workflow is authenticated access to those domain APIs; the tree alone does not establish a sequential application-to-placement process, so the graph keeps those stages as separate capabilities. Relationships are limited to calls or imports shown in excerpts and the SOURCE INDEX; several feature services were not sampled.

Main entry points: app.module.ts Nest application · auth.service.ts Authentication service · auth.controller.ts Authentication API · rag.controller.ts Procedure knowledge API

Components 20

Access and identity

Authentication API src/modules/auth/auth.controller.ts
Authentication service src/modules/auth/auth.service.ts
User records src/modules/users/entities/user.entity.ts
Roles and permissions src/modules/roles/entities/role.entity.ts
Email verification src/modules/email/email.service.ts

Placement management

Student profiles src/modules/profiles/profiles.controller.ts
Applications src/modules/candidatures/candidatures.controller.ts
Placement assignments src/modules/assignments/assignments.controller.ts
Placement stages src/modules/stages/stages.controller.ts
Milestones and deliverables src/modules/jalons/jalons.controller.ts
Subject catalog src/modules/subjects/subjects.controller.ts

Collaboration and AI

Chat and rooms src/modules/chat/chat.service.ts
Procedure knowledge API src/modules/rag/rag.controller.ts
RAG service src/modules/rag/rag.service.ts
Analytics src/modules/analytics/analytics.controller.ts

Platform operations

Audit logging src/common/audit/audit.service.ts
Audit API src/common/audit/audit.controller.ts
Audit interceptor src/common/interceptors/audit.interceptor.ts
Nest application src/app.module.ts

Other components

API user

Connections 17

API user → Authentication API: authenticates through
Authentication API → Authentication service: delegates to src/modules/auth/auth.service.ts
Authentication service → User records: reads and saves src/modules/auth/auth.service.ts
Authentication service → Roles and permissions: loads role src/modules/auth/auth.service.ts
Authentication service → Email verification: sends verification src/modules/auth/auth.service.ts
Procedure knowledge API → RAG service: delegates to src/modules/rag/rag.controller.ts
Audit API → Audit logging: queries logs src/common/audit/audit.controller.ts
Audit interceptor → Audit logging: records events src/common/interceptors/audit.interceptor.ts
Nest application → Authentication API: registers module src/app.module.ts
Nest application → Student profiles: registers module src/app.module.ts
Nest application → Applications: registers module src/app.module.ts
Nest application → Placement assignments: registers module src/app.module.ts
Nest application → Placement stages: registers module src/app.module.ts
Nest application → Milestones and deliverables: registers module src/app.module.ts
Nest application → Subject catalog: registers module src/app.module.ts
Nest application → Procedure knowledge API: registers module src/app.module.ts
Nest application → Analytics: registers module src/app.module.ts

Drawn by GitDiagram on November 12, 2026 from the repository's file tree, README and source files. Read as Markdown ·