# kumaran-m-15/skillnova architecture

> Architecture diagram of the GitHub repository kumaran-m-15/skillnova, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kumaran-m-15/skillnova
- Repository: https://github.com/kumaran-m-15/skillnova

## Overview

SkillNova is an internship-management platform: interns, mentors, and administrators use role-specific interfaces to access program operations, while the API authenticates and authorizes requests, handles domain workflows, and persists state. Its documented capabilities include reports, attendance, projects, knowledge-base and Q&A features, announcements, analytics, audit, and real-time updates. An optional Python AI assistant provides a separate retrieval-grounded chat service. The tree contains parallel frontend/backend directories; this map follows the root `src/` and `server/` paths emphasized by the source index. Some domain links are documented rather than verified from sampled handlers.

Main entry points: [`src/App.jsx`](https://github.com/kumaran-m-15/skillnova/blob/main/src/App.jsx) (Role router), [`server/src/routes/api.routes.js`](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/routes/api.routes.js) (API routes), [`server/src/controllers/reports.controller.js`](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/reports.controller.js) (Reports and reviews), [`src/lib/api.js`](https://github.com/kumaran-m-15/skillnova/blob/main/src/lib/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Role interfaces"]
  node_role_router["Role router<br/>[App.jsx]"]
  node_intern_portal["Intern portal<br/>[App.jsx]"]
  node_mentor_portal["Mentor portal<br/>[App.jsx]"]
  node_admin_portal["Admin portal<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_api_routes["API routes<br/>[api.routes.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_handler["Authentication<br/>[auth.controller.js]"]
  node_auth_middleware["JWT and RBAC<br/>[auth.js]"]
end

subgraph group_operations["Program operations"]
  node_reports["Reports and reviews"]
  node_program_features["Program features"]
  node_knowledge_base["Knowledge base<br/>[kb.controller.js]"]
end

subgraph group_platform["Platform services"]
  node_audit["Audit logging<br/>[audit.service.js]"]
  node_realtime["Realtime events<br/>[index.js]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_assistant["AI assistant"]
  node_ai_chat["AI chat API<br/>[main.py]"]
  node_agent_graph["RAG agent<br/>[graph.py]"]
  node_vectorstore["Knowledge retrieval<br/>[vectorstore.py]"]
  node_llm["Groq model"]
end

node_intern(("Intern"))
node_mentor(("Mentor"))
node_admin(("Administrator"))

node_intern -.->|"uses"| node_role_router
node_mentor -.->|"uses"| node_role_router
node_admin -.->|"uses"| node_role_router
node_role_router -->|"routes by role"| node_intern_portal
node_role_router -->|"routes by role"| node_mentor_portal
node_role_router -->|"routes by role"| node_admin_portal
node_intern_portal -.->|"requests data"| node_api_client
node_mentor_portal -.->|"requests data"| node_api_client
node_admin_portal -.->|"requests data"| node_api_client
node_api_client -.->|"sends requests"| node_api_routes
node_api_routes -->|"checks access"| node_auth_middleware
node_api_routes -->|"dispatches"| node_reports
node_api_routes -->|"dispatches"| node_program_features
node_api_routes -.->|"dispatches"| node_knowledge_base
node_auth_routes -.->|"dispatches"| node_auth_handler
node_auth_handler -->|"reads and writes"| node_postgres
node_reports -->|"reads and writes"| node_postgres
node_reports -->|"records actions"| node_audit
node_reports -.->|"notifies"| node_realtime
node_ai_chat -->|"runs"| node_agent_graph
node_agent_graph -.->|"retrieves context"| node_vectorstore
node_agent_graph -.->|"generates response"| node_llm

click node_role_router "https://github.com/kumaran-m-15/skillnova/blob/main/src/App.jsx"
click node_intern_portal "https://github.com/kumaran-m-15/skillnova/blob/main/src/user/App.jsx"
click node_mentor_portal "https://github.com/kumaran-m-15/skillnova/blob/main/src/mentor/App.jsx"
click node_admin_portal "https://github.com/kumaran-m-15/skillnova/blob/main/src/admin/App.jsx"
click node_api_client "https://github.com/kumaran-m-15/skillnova/blob/main/src/lib/api.js"
click node_api_routes "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/routes/api.routes.js"
click node_auth_routes "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/routes/auth.routes.js"
click node_auth_handler "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/auth.controller.js"
click node_auth_middleware "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/middleware/auth.js"
click node_reports "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/reports.controller.js"
click node_program_features "https://github.com/kumaran-m-15/skillnova/tree/main/server/src/controllers"
click node_knowledge_base "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/kb.controller.js"
click node_audit "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/services/audit.service.js"
click node_realtime "https://github.com/kumaran-m-15/skillnova/blob/main/server/src/sockets/index.js"
click node_ai_chat "https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/main.py"
click node_agent_graph "https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/agent/graph.py"
click node_vectorstore "https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/retriever/vectorstore.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_role_router,node_intern_portal,node_mentor_portal,node_admin_portal,node_api_client toneBlue
class node_api_routes,node_auth_routes,node_auth_handler,node_auth_middleware toneAmber
class node_reports,node_program_features,node_knowledge_base toneMint
class node_audit,node_realtime,node_postgres toneRose
class node_ai_chat,node_agent_graph,node_vectorstore,node_llm,node_intern,node_mentor,node_admin toneIndigo
```

## Components

### Role interfaces

- [Role router](https://github.com/kumaran-m-15/skillnova/blob/main/src/App.jsx): `src/App.jsx`
- [Intern portal](https://github.com/kumaran-m-15/skillnova/blob/main/src/user/App.jsx): `src/user/App.jsx`
- [Mentor portal](https://github.com/kumaran-m-15/skillnova/blob/main/src/mentor/App.jsx): `src/mentor/App.jsx`
- [Admin portal](https://github.com/kumaran-m-15/skillnova/blob/main/src/admin/App.jsx): `src/admin/App.jsx`
- [API client](https://github.com/kumaran-m-15/skillnova/blob/main/src/lib/api.js): `src/lib/api.js`

### API and access

- [API routes](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/routes/api.routes.js): `server/src/routes/api.routes.js`
- [Auth routes](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Authentication](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [JWT and RBAC](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`

### Program operations

- [Reports and reviews](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/reports.controller.js): `server/src/controllers/reports.controller.js`
- [Program features](https://github.com/kumaran-m-15/skillnova/tree/main/server/src/controllers): `server/src/controllers`
- [Knowledge base](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/controllers/kb.controller.js): `server/src/controllers/kb.controller.js`

### Platform services

- [Audit logging](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/services/audit.service.js): `server/src/services/audit.service.js`
- [Realtime events](https://github.com/kumaran-m-15/skillnova/blob/main/server/src/sockets/index.js): `server/src/sockets/index.js`
- **PostgreSQL**

### AI assistant

- [AI chat API](https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/main.py): `aiassistant/aiassistant-backend/main.py`
- [RAG agent](https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/agent/graph.py): `aiassistant/aiassistant-backend/agent/graph.py`
- [Knowledge retrieval](https://github.com/kumaran-m-15/skillnova/blob/main/aiassistant/aiassistant-backend/retriever/vectorstore.py): `aiassistant/aiassistant-backend/retriever/vectorstore.py`
- **Groq model**

### Other components

- **Intern**
- **Mentor**
- **Administrator**

## Connections

- Intern → Role router: uses (evidence: `README.md`)
- Mentor → Role router: uses (evidence: `README.md`)
- Administrator → Role router: uses (evidence: `README.md`)
- Role router → Intern portal: routes by role
- Role router → Mentor portal: routes by role
- Role router → Admin portal: routes by role
- Intern portal → API client: requests data
- Mentor portal → API client: requests data
- Admin portal → API client: requests data
- API client → API routes: sends requests (evidence: `README.md`)
- API routes → JWT and RBAC: checks access (evidence: `server/src/routes/api.routes.js`)
- API routes → Reports and reviews: dispatches (evidence: `server/src/routes/api.routes.js`)
- API routes → Program features: dispatches (evidence: `server/src/routes/api.routes.js`)
- API routes → Knowledge base: dispatches
- Auth routes → Authentication: dispatches
- Authentication → PostgreSQL: reads and writes (evidence: `server/src/controllers/auth.controller.js`)
- Reports and reviews → PostgreSQL: reads and writes (evidence: `server/src/controllers/reports.controller.js`)
- Reports and reviews → Audit logging: records actions (evidence: `server/src/controllers/reports.controller.js`)
- Reports and reviews → Realtime events: notifies (evidence: `server/src/controllers/reports.controller.js`)
- AI chat API → RAG agent: runs (evidence: `aiassistant/aiassistant-backend/main.py`)
- RAG agent → Knowledge retrieval: retrieves context
- RAG agent → Groq model: generates response (evidence: `README.md`)
