# laxmiganji/ecap-erp architecture

> Architecture diagram of the GitHub repository laxmiganji/ecap-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/laxmiganji/ecap-erp
- Repository: https://github.com/laxmiganji/ecap-erp

## Overview

ECAP_SPHN is a role-based campus administration portal. Users enter through login and receive role-specific workspaces; those workspaces support academic setup and attainment, faculty workflows, campus services, and placement. The backend exposes routed APIs whose controllers operate on MongoDB models. The README documents major workflows, but many feature implementations and route-to-controller links were not sampled, so those connections are not asserted here; optional or unverified links are dashed.

Main entry points: [`frontend/src/App.js`](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/App.js) (Role router), [`backend/services/coattainment.service.js`](https://github.com/laxmiganji/ecap-erp/blob/main/backend/services/coattainment.service.js) (CO attainment), [`backend/models/Students/details.model.js`](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Students/details.model.js) (Student records), [`backend/controllers/Other/rag.controller.js`](https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Other/rag.controller.js) (Library RAG)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User workspaces"]
  node_app["Role router<br/>[App.js]"]
  node_login["Login<br/>[Login.jsx]"]
  node_accounts["Accounts workspace<br/>[Home.jsx]"]
  node_principal["Principal workspace<br/>[Home.jsx]"]
  node_parent["Parent portal<br/>[ParentPortal.jsx]"]
  node_portfolio["Portfolio view<br/>[Portfolio3D.jsx]"]
  node_hostelui["Hostel workspace<br/>[Home.jsx]"]
  node_assistant["AI assistant"]
  node_baseurl["API base URL<br/>[baseUrl.js]"]
end

subgraph group_backend["API and identity"]
  node_api["Express API<br/>[index.js]"]
  node_auth["Google sign-in"]
  node_mongo[("MongoDB<br/>[db.js]")]
end

subgraph group_academics["Academic operations"]
  node_student[("Student records<br/>[details.model.js]")]
  node_obe["CO attainment"]
  node_branches[("Branch setup<br/>[branch.model.js]")]
  node_subjects[("Subject setup<br/>[subject.model.js]")]
end

subgraph group_services["Campus services"]
  node_faculty["Faculty workflows"]
  node_rag["Library RAG<br/>[rag.controller.js]"]
  node_ragstore[("RAG documents")]
  node_pinecone["Vector search"]
end

subgraph group_placement["Library and placement"]
  node_placementui["Placement panel<br/>[Applications.jsx]"]
  node_applications["Applications"]
  node_applicationstore[("Application records")]
end

node_user(("Campus user"))

node_user -->|"opens portal"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_accounts
node_app -->|"routes to"| node_parent
node_app -->|"routes to"| node_portfolio
node_app -->|"routes to"| node_hostelui
node_app -->|"renders"| node_assistant
node_user -.->|"signs in"| node_auth
node_auth -->|"checks account"| node_student
node_api -->|"connects to"| node_mongo
node_api -->|"routes attainment"| node_obe
node_obe -->|"reads students"| node_student
node_obe -->|"reads and updates"| node_subjects
node_obe -->|"reads branch"| node_branches
node_user -.->|"configures and reviews"| node_obe
node_user -.->|"manages attendance"| node_faculty
node_faculty -->|"uses faculty records"| node_student
node_user -.->|"queries library"| node_rag
node_rag -->|"creates and queries"| node_ragstore
node_rag -->|"upserts vectors"| node_pinecone
node_placementui -->|"uses API base"| node_baseurl
node_user -.->|"applies to drives"| node_placementui
node_applications -->|"creates and queries"| node_applicationstore
node_applications -->|"populates student"| node_student
node_placementui -.->|"calls API"| node_applications

click node_app "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/App.js"
click node_login "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/components/Login.jsx"
click node_accounts "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Accounts/Home.jsx"
click node_principal "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Principal/Home.jsx"
click node_parent "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Common/ParentPortal.jsx"
click node_portfolio "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Common/Portfolio3D.jsx"
click node_hostelui "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Hostel/Home.jsx"
click node_assistant "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/components/GlobalAIAssistant.jsx"
click node_api "https://github.com/laxmiganji/ecap-erp/blob/main/backend/index.js"
click node_auth "https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/googleAuth.controller.js"
click node_mongo "https://github.com/laxmiganji/ecap-erp/blob/main/backend/Database/db.js"
click node_student "https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Students/details.model.js"
click node_obe "https://github.com/laxmiganji/ecap-erp/blob/main/backend/services/coattainment.service.js"
click node_branches "https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/branch.model.js"
click node_subjects "https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/subject.model.js"
click node_faculty "https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Faculty/details.controller.js"
click node_rag "https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Other/rag.controller.js"
click node_ragstore "https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/ragDocument.model.js"
click node_pinecone "https://github.com/laxmiganji/ecap-erp/blob/main/backend/services/pinecone.service.js"
click node_placementui "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Placement/Applications.jsx"
click node_applications "https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Placement/application.controller.js"
click node_applicationstore "https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Placement/application.model.js"
click node_baseurl "https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/baseUrl.js"

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_app,node_login,node_accounts,node_principal,node_parent,node_portfolio,node_hostelui,node_assistant,node_baseurl,node_user toneBlue
class node_api,node_auth,node_mongo toneAmber
class node_student,node_obe,node_branches,node_subjects toneMint
class node_faculty,node_rag,node_ragstore,node_pinecone toneRose
class node_placementui,node_applications,node_applicationstore toneIndigo
```

## Components

### User workspaces

- [Role router](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Login](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/components/Login.jsx): `frontend/src/components/Login.jsx`
- [Accounts workspace](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Accounts/Home.jsx): `frontend/src/Screens/Accounts/Home.jsx`
- [Principal workspace](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Principal/Home.jsx): `frontend/src/Screens/Principal/Home.jsx`
- [Parent portal](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Common/ParentPortal.jsx): `frontend/src/Screens/Common/ParentPortal.jsx`
- [Portfolio view](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Common/Portfolio3D.jsx): `frontend/src/Screens/Common/Portfolio3D.jsx`
- [Hostel workspace](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Hostel/Home.jsx): `frontend/src/Screens/Hostel/Home.jsx`
- [AI assistant](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/components/GlobalAIAssistant.jsx): `frontend/src/components/GlobalAIAssistant.jsx`
- [API base URL](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/baseUrl.js): `frontend/src/baseUrl.js`

### API and identity

- [Express API](https://github.com/laxmiganji/ecap-erp/blob/main/backend/index.js): `backend/index.js`
- [Google sign-in](https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/googleAuth.controller.js): `backend/controllers/googleAuth.controller.js`
- [MongoDB](https://github.com/laxmiganji/ecap-erp/blob/main/backend/Database/db.js): `backend/Database/db.js`

### Academic operations

- [Student records](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Students/details.model.js): `backend/models/Students/details.model.js`
- [CO attainment](https://github.com/laxmiganji/ecap-erp/blob/main/backend/services/coattainment.service.js): `backend/services/coattainment.service.js`
- [Branch setup](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/branch.model.js): `backend/models/Other/branch.model.js`
- [Subject setup](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/subject.model.js): `backend/models/Other/subject.model.js`

### Campus services

- [Faculty workflows](https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Faculty/details.controller.js): `backend/controllers/Faculty/details.controller.js`
- [Library RAG](https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Other/rag.controller.js): `backend/controllers/Other/rag.controller.js`
- [RAG documents](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Other/ragDocument.model.js): `backend/models/Other/ragDocument.model.js`
- [Vector search](https://github.com/laxmiganji/ecap-erp/blob/main/backend/services/pinecone.service.js): `backend/services/pinecone.service.js`

### Library and placement

- [Placement panel](https://github.com/laxmiganji/ecap-erp/blob/main/frontend/src/Screens/Placement/Applications.jsx): `frontend/src/Screens/Placement/Applications.jsx`
- [Applications](https://github.com/laxmiganji/ecap-erp/blob/main/backend/controllers/Placement/application.controller.js): `backend/controllers/Placement/application.controller.js`
- [Application records](https://github.com/laxmiganji/ecap-erp/blob/main/backend/models/Placement/application.model.js): `backend/models/Placement/application.model.js`

### Other components

- **Campus user**

## Connections

- Campus user → Role router: opens portal (evidence: `frontend/src/App.js`)
- Role router → Login: routes to (evidence: `frontend/src/App.js`)
- Role router → Accounts workspace: routes to (evidence: `frontend/src/App.js`)
- Role router → Parent portal: routes to (evidence: `frontend/src/App.js`)
- Role router → Portfolio view: routes to (evidence: `frontend/src/App.js`)
- Role router → Hostel workspace: routes to (evidence: `frontend/src/App.js`)
- Role router → AI assistant: renders (evidence: `frontend/src/App.js`)
- Campus user → Google sign-in: signs in (evidence: `README.md`)
- Google sign-in → Student records: checks account (evidence: `backend/controllers/googleAuth.controller.js`)
- Express API → MongoDB: connects to (evidence: `backend/index.js`)
- Express API → CO attainment: routes attainment (evidence: `backend/index.js`)
- CO attainment → Student records: reads students (evidence: `backend/services/coattainment.service.js`)
- CO attainment → Subject setup: reads and updates (evidence: `backend/services/coattainment.service.js`)
- CO attainment → Branch setup: reads branch (evidence: `backend/services/coattainment.service.js`)
- Campus user → CO attainment: configures and reviews (evidence: `README.md`)
- Campus user → Faculty workflows: manages attendance (evidence: `README.md`)
- Faculty workflows → Student records: uses faculty records (evidence: `backend/controllers/Faculty/details.controller.js`)
- Campus user → Library RAG: queries library (evidence: `README.md`)
- Library RAG → RAG documents: creates and queries (evidence: `backend/controllers/Other/rag.controller.js`)
- Library RAG → Vector search: upserts vectors (evidence: `backend/controllers/Other/rag.controller.js`)
- Placement panel → API base URL: uses API base (evidence: `frontend/src/Screens/Placement/Applications.jsx`)
- Campus user → Placement panel: applies to drives (evidence: `README.md`)
- Applications → Application records: creates and queries (evidence: `backend/controllers/Placement/application.controller.js`)
- Applications → Student records: populates student (evidence: `backend/controllers/Placement/application.controller.js`)
- Placement panel → Applications: calls API
