# amritesh-singh-11/sebi-member-compliance-monitoring-system architecture

> Architecture diagram of the GitHub repository amritesh-singh-11/sebi-member-compliance-monitoring-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amritesh-singh-11/sebi-member-compliance-monitoring-system
- Repository: https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system

## Overview

ReguLens is an academic compliance-monitoring platform for regulated market intermediaries. Its documented workflow is to manage members and filing requirements, collect and review evidence, detect breaches, then investigate violations through corrective actions while recalculating risk and recording changes. The graph also preserves the documented reporting, dashboard, notification, regulation, complaint, and advisory-ML capabilities. Source excerpts establish selected frontend routes and member persistence; most domain connections below are documented in the README workflow. Other implementation details were not sampled.

Main entry points: [`backend/src/main/java/com/sebi/compliance/violation/ViolationService.java`](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/violation/ViolationService.java) (Violation investigation), [`backend/src/main/java/com/sebi/compliance/record/ComplianceRecord.java`](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/record/ComplianceRecord.java) (Filing records), [`backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java`](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java) (Rule engine), [`backend/src/main/java/com/sebi/compliance/document/DocumentService.java`](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/document/DocumentService.java) (Evidence vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["User portal"]
  node_portal["ReguLens web portal<br/>[App.jsx]"]
end

subgraph group_governance["Compliance governance"]
  node_members[("Member registry<br/>[MemberService.java]")]
  node_requirements[("Filing requirements")]
  node_records[("Filing records")]
  node_documents[("Evidence vault")]
  node_storage["File storage"]
  node_regulations[("Regulation catalog")]
end

subgraph group_casework["Breach response"]
  node_rules["Rule engine"]
  node_violations[("Violation investigation")]
  node_capa[("Corrective actions<br/>[CAService.java]")]
  node_complaints[("Complaints")]
end

subgraph group_insight["Monitoring and insight"]
  node_risk[("Risk scoring")]
  node_ml["Advisory ML predictor<br/>[main.py]"]
  node_dashboard["Dashboard metrics"]
  node_reports["PDF and CSV reports<br/>[ReportService.java]"]
  node_audit[("Audit trail<br/>[AuditService.java]")]
  node_notifications[("Notifications")]
end

subgraph group_identity["Identity and access"]
  node_users[("Compliance users<br/>[User.java]")]
  node_auth["Sign-in and access<br/>[AuthService.java]"]
end

node_operator(("Officer or member"))

node_operator -->|"uses"| node_portal
node_portal -.->|"signs in"| node_auth
node_members -->|"sets obligations"| node_requirements
node_requirements -->|"tracks filings"| node_records
node_records -->|"submits evidence"| node_documents
node_documents -.->|"stores files"| node_storage
node_records -->|"checks filings"| node_rules
node_documents -->|"checks evidence"| node_rules
node_rules -->|"creates breaches"| node_violations
node_rules -->|"marks compliant"| node_records
node_violations -->|"starts remediation"| node_capa
node_violations -->|"updates score"| node_risk
node_capa -->|"logs resolution"| node_audit
node_violations -.->|"alerts"| node_notifications
node_risk -.->|"offers prediction"| node_ml
node_members -->|"summarizes"| node_dashboard
node_records -->|"reports filings"| node_reports
node_violations -->|"reports breaches"| node_reports
node_operator -.->|"browses"| node_regulations
node_operator -.->|"submits"| node_complaints

click node_users "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/user/User.java"
click node_auth "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/auth/AuthService.java"
click node_members "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/member/MemberService.java"
click node_requirements "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/requirement/RequirementService.java"
click node_records "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/record/ComplianceRecord.java"
click node_documents "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/document/DocumentService.java"
click node_storage "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/document/LocalStorageService.java"
click node_rules "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java"
click node_violations "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/violation/ViolationService.java"
click node_capa "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/correctiveaction/CAService.java"
click node_risk "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/risk/RiskEngineService.java"
click node_ml "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/ml-service/app/main.py"
click node_dashboard "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/dashboard/DashboardService.java"
click node_reports "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/report/ReportService.java"
click node_audit "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/audit/AuditService.java"
click node_notifications "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/notification/NotificationService.java"
click node_regulations "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/regulation/RegulationService.java"
click node_complaints "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/complaint/ComplaintService.java"
click node_portal "https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/frontend/src/App.jsx"

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_portal toneBlue
class node_members,node_requirements,node_records,node_documents,node_storage,node_regulations toneAmber
class node_rules,node_violations,node_capa,node_complaints toneMint
class node_risk,node_ml,node_dashboard,node_reports,node_audit,node_notifications toneRose
class node_users,node_auth,node_operator toneIndigo
```

## Components

### User portal

- [ReguLens web portal](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Compliance governance

- [Member registry](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/member/MemberService.java): `backend/src/main/java/com/sebi/compliance/member/MemberService.java`
- [Filing requirements](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/requirement/RequirementService.java): `backend/src/main/java/com/sebi/compliance/requirement/RequirementService.java`
- [Filing records](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/record/ComplianceRecord.java): `backend/src/main/java/com/sebi/compliance/record/ComplianceRecord.java`
- [Evidence vault](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/document/DocumentService.java): `backend/src/main/java/com/sebi/compliance/document/DocumentService.java`
- [File storage](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/document/LocalStorageService.java): `backend/src/main/java/com/sebi/compliance/document/LocalStorageService.java`
- [Regulation catalog](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/regulation/RegulationService.java): `backend/src/main/java/com/sebi/compliance/regulation/RegulationService.java`

### Breach response

- [Rule engine](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java): `backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java`
- [Violation investigation](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/violation/ViolationService.java): `backend/src/main/java/com/sebi/compliance/violation/ViolationService.java`
- [Corrective actions](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/correctiveaction/CAService.java): `backend/src/main/java/com/sebi/compliance/correctiveaction/CAService.java`
- [Complaints](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/complaint/ComplaintService.java): `backend/src/main/java/com/sebi/compliance/complaint/ComplaintService.java`

### Monitoring and insight

- [Risk scoring](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/risk/RiskEngineService.java): `backend/src/main/java/com/sebi/compliance/risk/RiskEngineService.java`
- [Advisory ML predictor](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/ml-service/app/main.py): `ml-service/app/main.py`
- [Dashboard metrics](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/dashboard/DashboardService.java): `backend/src/main/java/com/sebi/compliance/dashboard/DashboardService.java`
- [PDF and CSV reports](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/report/ReportService.java): `backend/src/main/java/com/sebi/compliance/report/ReportService.java`
- [Audit trail](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/audit/AuditService.java): `backend/src/main/java/com/sebi/compliance/audit/AuditService.java`
- [Notifications](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/notification/NotificationService.java): `backend/src/main/java/com/sebi/compliance/notification/NotificationService.java`

### Identity and access

- [Compliance users](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/user/User.java): `backend/src/main/java/com/sebi/compliance/user/User.java`
- [Sign-in and access](https://github.com/amritesh-singh-11/sebi-member-compliance-monitoring-system/blob/main/backend/src/main/java/com/sebi/compliance/auth/AuthService.java): `backend/src/main/java/com/sebi/compliance/auth/AuthService.java`

### Other components

- **Officer or member**

## Connections

- Officer or member → ReguLens web portal: uses (evidence: `frontend/src/App.jsx`)
- ReguLens web portal → Sign-in and access: signs in
- Member registry → Filing requirements: sets obligations
- Filing requirements → Filing records: tracks filings
- Filing records → Evidence vault: submits evidence
- Evidence vault → File storage: stores files
- Filing records → Rule engine: checks filings (evidence: `backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java`)
- Evidence vault → Rule engine: checks evidence
- Rule engine → Violation investigation: creates breaches
- Rule engine → Filing records: marks compliant (evidence: `backend/src/main/java/com/sebi/compliance/rule/RuleEngineService.java`)
- Violation investigation → Corrective actions: starts remediation
- Violation investigation → Risk scoring: updates score
- Corrective actions → Audit trail: logs resolution
- Violation investigation → Notifications: alerts
- Risk scoring → Advisory ML predictor: offers prediction
- Member registry → Dashboard metrics: summarizes (evidence: `backend/src/main/java/com/sebi/compliance/dashboard/DashboardService.java`)
- Filing records → PDF and CSV reports: reports filings (evidence: `backend/src/main/java/com/sebi/compliance/report/ReportService.java`)
- Violation investigation → PDF and CSV reports: reports breaches (evidence: `backend/src/main/java/com/sebi/compliance/report/ReportService.java`)
- Officer or member → Regulation catalog: browses
- Officer or member → Complaints: submits
