# codewithpriyam/nyaysetu architecture

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

- Interactive diagram: https://gitdiagram.com/codewithpriyam/nyaysetu
- Repository: https://github.com/codewithpriyam/nyaysetu

## Overview

NyayaSetu is a legal-services platform for Indian users: people can find advocates, request consultations, pay for them, manage cases, and use AI legal tools; lawyers and administrators have separate workflows. The frontend routes public and role-protected experiences, while Spring controllers implement backend workflows and repositories persist domain records. The sampled excerpts show several controller-to-repository and AI-engine calls, but not the frontend API wiring or most unsampled controllers, so those connections are left unverified or omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/App.jsx) (Route application), [`backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java`](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java) (Lawyer consultation actions), [`backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java`](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java) (Payment verification), [`backend/src/main/java/com/nyaysetu/backend/controller/AiController.java`](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/AiController.java) (AI endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Route application<br/>[App.jsx]"]
  node_publiclegal["Legal discovery"]
  node_advocates["Advocate directory"]
  node_userportal["User case portal"]
  node_lawyerportal["Lawyer workspace"]
  node_adminportal["Admin workspace"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication state<br/>[authStore.js]"]
  node_userservice["User synchronization<br/>[UserService.java]"]
  node_userrepo[("User records")]
end

subgraph group_legal["Legal workflows"]
  node_caseui["Case management screens<br/>[CasesPage.jsx]"]
  node_casecontroller["Case management"]
  node_caserepo[("Legal case records")]
end

subgraph group_consult["Consultations and payments"]
  node_consultui["Consultation screens"]
  node_consultcontroller["Consultation requests"]
  node_lawyercontroller["Lawyer consultation actions"]
  node_paymentcontroller["Payment verification"]
  node_consultrepo[("Consultation records")]
  node_paymentrepo[("Payment records")]
end

subgraph group_platform["AI and persistence"]
  node_aiui["AI legal tools"]
  node_aicontroller["AI endpoints<br/>[AiController.java]"]
  node_aiengine["Groq AI engine<br/>[GroqAiEngine.java]"]
  node_aiconversations[("AI conversation records")]
  node_notifications["Notifications<br/>[Notification.java]"]
end

node_citizen(("Citizen"))
node_lawyer(("Lawyer"))
node_admin(("Administrator"))

node_citizen -->|"opens"| node_webapp
node_lawyer -->|"opens"| node_webapp
node_admin -->|"opens"| node_webapp
node_webapp -->|"routes to"| node_publiclegal
node_webapp -->|"routes to"| node_userportal
node_webapp -->|"routes to"| node_lawyerportal
node_webapp -->|"routes to"| node_adminportal
node_citizen -.->|"browses"| node_advocates
node_citizen -.->|"requests"| node_consultui
node_consultui -.->|"submits to"| node_consultcontroller
node_consultcontroller -.->|"persists via"| node_consultrepo
node_lawyerportal -.->|"manages requests"| node_lawyercontroller
node_lawyercontroller -->|"updates"| node_consultrepo
node_lawyercontroller -->|"creates"| node_notifications
node_citizen -.->|"submits payment"| node_paymentcontroller
node_paymentcontroller -->|"checks ownership"| node_consultrepo
node_paymentcontroller -->|"saves payment"| node_paymentrepo
node_citizen -.->|"manages cases"| node_caseui
node_caseui -.->|"calls"| node_casecontroller
node_casecontroller -->|"saves and reads"| node_caserepo
node_citizen -.->|"uses"| node_aiui
node_aiui -.->|"calls"| node_aicontroller
node_aicontroller -->|"generates responses"| node_aiengine
node_aicontroller -->|"stores conversations"| node_aiconversations
node_auth -.->|"syncs identity"| node_userservice
node_userservice -->|"reads and saves"| node_userrepo

click node_webapp "https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/App.jsx"
click node_publiclegal "https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/public"
click node_advocates "https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/data"
click node_userportal "https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/user"
click node_lawyerportal "https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/lawyer"
click node_adminportal "https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/admin"
click node_auth "https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/store/authStore.js"
click node_userservice "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/service/UserService.java"
click node_userrepo "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/UserRepository.java"
click node_consultui "https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/pages/user/ConsultationsPage.jsx"
click node_consultcontroller "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/ConsultationController.java"
click node_lawyercontroller "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java"
click node_paymentcontroller "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java"
click node_consultrepo "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/ConsultationRepository.java"
click node_paymentrepo "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/PaymentRepository.java"
click node_caseui "https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/pages/user/CasesPage.jsx"
click node_casecontroller "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/CaseController.java"
click node_caserepo "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/CaseRepository.java"
click node_aiui "https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/services/groqLegalAiService.js"
click node_aicontroller "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/AiController.java"
click node_aiengine "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/service/GroqAiEngine.java"
click node_aiconversations "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/AiConversationRepository.java"
click node_notifications "https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/model/Notification.java"

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_webapp,node_publiclegal,node_advocates,node_userportal,node_lawyerportal,node_adminportal toneBlue
class node_auth,node_userservice,node_userrepo toneAmber
class node_caseui,node_casecontroller,node_caserepo toneMint
class node_consultui,node_consultcontroller,node_lawyercontroller,node_paymentcontroller,node_consultrepo,node_paymentrepo toneRose
class node_aiui,node_aicontroller,node_aiengine,node_aiconversations,node_notifications,node_citizen,node_lawyer,node_admin toneIndigo
```

## Components

### Web experience

- [Route application](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Legal discovery](https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/public): `frontend/src/pages/public`
- [Advocate directory](https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/data): `frontend/src/data`
- [User case portal](https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/user): `frontend/src/pages/user`
- [Lawyer workspace](https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/lawyer): `frontend/src/pages/lawyer`
- [Admin workspace](https://github.com/codewithpriyam/nyaysetu/tree/master/frontend/src/pages/admin): `frontend/src/pages/admin`

### Identity and access

- [Authentication state](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/store/authStore.js): `frontend/src/store/authStore.js`
- [User synchronization](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/service/UserService.java): `backend/src/main/java/com/nyaysetu/backend/service/UserService.java`
- [User records](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/UserRepository.java): `backend/src/main/java/com/nyaysetu/backend/repository/UserRepository.java`

### Legal workflows

- [Case management screens](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/pages/user/CasesPage.jsx): `frontend/src/pages/user/CasesPage.jsx`
- [Case management](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/CaseController.java): `backend/src/main/java/com/nyaysetu/backend/controller/CaseController.java`
- [Legal case records](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/CaseRepository.java): `backend/src/main/java/com/nyaysetu/backend/repository/CaseRepository.java`

### Consultations and payments

- [Consultation screens](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/pages/user/ConsultationsPage.jsx): `frontend/src/pages/user/ConsultationsPage.jsx`
- [Consultation requests](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/ConsultationController.java): `backend/src/main/java/com/nyaysetu/backend/controller/ConsultationController.java`
- [Lawyer consultation actions](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java): `backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java`
- [Payment verification](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java): `backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java`
- [Consultation records](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/ConsultationRepository.java): `backend/src/main/java/com/nyaysetu/backend/repository/ConsultationRepository.java`
- [Payment records](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/PaymentRepository.java): `backend/src/main/java/com/nyaysetu/backend/repository/PaymentRepository.java`

### AI and persistence

- [AI legal tools](https://github.com/codewithpriyam/nyaysetu/blob/master/frontend/src/services/groqLegalAiService.js): `frontend/src/services/groqLegalAiService.js`
- [AI endpoints](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/controller/AiController.java): `backend/src/main/java/com/nyaysetu/backend/controller/AiController.java`
- [Groq AI engine](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/service/GroqAiEngine.java): `backend/src/main/java/com/nyaysetu/backend/service/GroqAiEngine.java`
- [AI conversation records](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/repository/AiConversationRepository.java): `backend/src/main/java/com/nyaysetu/backend/repository/AiConversationRepository.java`
- [Notifications](https://github.com/codewithpriyam/nyaysetu/blob/master/backend/src/main/java/com/nyaysetu/backend/model/Notification.java): `backend/src/main/java/com/nyaysetu/backend/model/Notification.java`

### Other components

- **Citizen**
- **Lawyer**
- **Administrator**

## Connections

- Citizen → Route application: opens (evidence: `frontend/src/App.jsx`)
- Lawyer → Route application: opens (evidence: `frontend/src/App.jsx`)
- Administrator → Route application: opens (evidence: `frontend/src/App.jsx`)
- Route application → Legal discovery: routes to (evidence: `frontend/src/App.jsx`)
- Route application → User case portal: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Lawyer workspace: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Admin workspace: routes to (evidence: `frontend/src/App.jsx`)
- Citizen → Advocate directory: browses
- Citizen → Consultation screens: requests
- Consultation screens → Consultation requests: submits to
- Consultation requests → Consultation records: persists via
- Lawyer workspace → Lawyer consultation actions: manages requests
- Lawyer consultation actions → Consultation records: updates (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java`)
- Lawyer consultation actions → Notifications: creates (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/LawyerDashboardController.java`)
- Citizen → Payment verification: submits payment
- Payment verification → Consultation records: checks ownership (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java`)
- Payment verification → Payment records: saves payment (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/PaymentController.java`)
- Citizen → Case management screens: manages cases
- Case management screens → Case management: calls
- Case management → Legal case records: saves and reads (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/CaseController.java`)
- Citizen → AI legal tools: uses
- AI legal tools → AI endpoints: calls
- AI endpoints → Groq AI engine: generates responses (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/AiController.java`)
- AI endpoints → AI conversation records: stores conversations (evidence: `backend/src/main/java/com/nyaysetu/backend/controller/AiController.java`)
- Authentication state → User synchronization: syncs identity
- User synchronization → User records: reads and saves (evidence: `backend/src/main/java/com/nyaysetu/backend/service/UserService.java`)
