# csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform architecture

> Architecture diagram of the GitHub repository csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform, 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/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform
- Repository: https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform

## Overview

ComplianceAI is an enterprise legal-document analysis and policy-governance platform. Users authenticate, submit text, files, or URLs, receive AI classification, clause-risk findings, rewrites, scores, and an executive summary, then review reports and manage approvals; version comparison, audit, and administration are distinct workflows. The graph follows documented frontend routes and sampled analysis calls through extraction, AI, persistence, and audit. Some subsystems are represented from the README and file tree because their implementation was not sampled; those links are documented rather than inferred from co-location.

Main entry points: [`backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java) (Analysis API), [`backend/src/main/java/com/compliance/platform/service/AuditService.java`](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/AuditService.java) (Audit trail), [`backend/src/main/java/com/compliance/platform/repository`](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/repository) (Mongo repositories), [`backend/src/main/java/com/compliance/platform/controller/AuthController.java`](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AuthController.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Application routes<br/>[App.js]"]
  node_api_client["Analysis and API client<br/>[analysisService.js]"]
  node_pages["Product pages"]
end

subgraph group_identity["Identity and access"]
  node_authctx["Session context<br/>[AuthContext.js]"]
  node_auth_controller["Authentication API"]
  node_security["JWT security"]
  node_user_service["User and roles<br/>[UserService.java]"]
end

subgraph group_analysis["Document intelligence"]
  node_analyze_controller["Analysis API"]
  node_extractor["Document extraction"]
  node_ai_service["AI analysis<br/>[AiService.java]"]
  node_prompts["Specialized prompts<br/>[PromptLibrary.java]"]
  node_groq_client["Model API client<br/>[GroqClient.java]"]
end

subgraph group_governance["Review and governance"]
  node_report_service["Report and scoring<br/>[ReportService.java]"]
  node_report_api["Report approvals"]
  node_compare_service["Version comparison"]
  node_audit_service["Audit trail<br/>[AuditService.java]"]
  node_admin_audit_apis["Audit and admin APIs"]
end

subgraph group_persistence["Platform data"]
  node_repositories["Mongo repositories"]
  node_mongo[("MongoDB")]
end

node_employee(("Enterprise user"))
node_model_provider{{"External AI provider"}}

node_employee -->|"uses"| node_app
node_app -->|"routes to"| node_pages
node_app -->|"provides session"| node_authctx
node_authctx -->|"restores and authenticates"| node_auth_controller
node_pages -.->|"requests analysis"| node_api_client
node_api_client -->|"posts documents"| node_analyze_controller
node_analyze_controller -->|"extracts file or URL"| node_extractor
node_analyze_controller -->|"runs analysis"| node_ai_service
node_ai_service -->|"uses prompts"| node_prompts
node_ai_service -->|"requests model"| node_groq_client
node_groq_client -.->|"calls model"| node_model_provider
node_analyze_controller -->|"saves report"| node_report_service
node_report_service -->|"persists and queries"| node_repositories
node_repositories -.->|"reads and writes"| node_mongo
node_analyze_controller -->|"records activity"| node_audit_service
node_audit_service -->|"stores audit logs"| node_repositories
node_report_api -->|"manages reports"| node_report_service
node_report_api -->|"records review actions"| node_audit_service
node_api_client -.->|"requests comparison"| node_compare_service
node_compare_service -->|"stores comparisons"| node_repositories
node_admin_audit_apis -.->|"serves audit views"| node_audit_service
node_auth_controller -->|"handles accounts"| node_user_service
node_auth_controller -->|"records auth events"| node_audit_service
node_user_service -->|"reads and writes users"| node_repositories
node_security -.->|"protects API"| node_auth_controller

click node_app "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/App.js"
click node_authctx "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/context/AuthContext.js"
click node_api_client "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/services/analysisService.js"
click node_pages "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/frontend/src/pages"
click node_auth_controller "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AuthController.java"
click node_security "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/security"
click node_user_service "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/UserService.java"
click node_analyze_controller "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java"
click node_extractor "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/DocumentExtractionService.java"
click node_ai_service "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/AiService.java"
click node_prompts "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/PromptLibrary.java"
click node_groq_client "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/GroqClient.java"
click node_report_service "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ReportService.java"
click node_report_api "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/ReportController.java"
click node_compare_service "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/VersionComparisonService.java"
click node_audit_service "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/AuditService.java"
click node_admin_audit_apis "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/controller"
click node_repositories "https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/repository"

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_api_client,node_pages,node_employee toneBlue
class node_authctx,node_auth_controller,node_security,node_user_service toneAmber
class node_analyze_controller,node_extractor,node_ai_service,node_prompts,node_groq_client toneMint
class node_report_service,node_report_api,node_compare_service,node_audit_service,node_admin_audit_apis toneRose
class node_repositories,node_mongo,node_model_provider toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Analysis and API client](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/services/analysisService.js): `frontend/src/services/analysisService.js`
- [Product pages](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/frontend/src/pages): `frontend/src/pages`

### Identity and access

- [Session context](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Authentication API](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AuthController.java): `backend/src/main/java/com/compliance/platform/controller/AuthController.java`
- [JWT security](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/security): `backend/src/main/java/com/compliance/platform/security`
- [User and roles](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/UserService.java): `backend/src/main/java/com/compliance/platform/service/UserService.java`

### Document intelligence

- [Analysis API](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java): `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`
- [Document extraction](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/DocumentExtractionService.java): `backend/src/main/java/com/compliance/platform/service/DocumentExtractionService.java`
- [AI analysis](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/AiService.java): `backend/src/main/java/com/compliance/platform/service/ai/AiService.java`
- [Specialized prompts](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/PromptLibrary.java): `backend/src/main/java/com/compliance/platform/service/ai/PromptLibrary.java`
- [Model API client](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ai/GroqClient.java): `backend/src/main/java/com/compliance/platform/service/ai/GroqClient.java`

### Review and governance

- [Report and scoring](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/ReportService.java): `backend/src/main/java/com/compliance/platform/service/ReportService.java`
- [Report approvals](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/controller/ReportController.java): `backend/src/main/java/com/compliance/platform/controller/ReportController.java`
- [Version comparison](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/VersionComparisonService.java): `backend/src/main/java/com/compliance/platform/service/VersionComparisonService.java`
- [Audit trail](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/blob/main/backend/src/main/java/com/compliance/platform/service/AuditService.java): `backend/src/main/java/com/compliance/platform/service/AuditService.java`
- [Audit and admin APIs](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/controller): `backend/src/main/java/com/compliance/platform/controller`

### Platform data

- [Mongo repositories](https://github.com/csudharsan-hub/ai-enterprise-compliance-policy-intelligence-platform/tree/main/backend/src/main/java/com/compliance/platform/repository): `backend/src/main/java/com/compliance/platform/repository`
- **MongoDB**

### Other components

- **Enterprise user**
- **External AI provider**

## Connections

- Enterprise user → Application routes: uses (evidence: `README.md`)
- Application routes → Product pages: routes to (evidence: `frontend/src/App.js`)
- Application routes → Session context: provides session (evidence: `frontend/src/App.js`)
- Session context → Authentication API: restores and authenticates (evidence: `frontend/src/context/AuthContext.js`)
- Product pages → Analysis and API client: requests analysis (evidence: `frontend/src/pages/dashboards/ReviewerDashboard.js`)
- Analysis and API client → Analysis API: posts documents (evidence: `frontend/src/services/analysisService.js`)
- Analysis API → Document extraction: extracts file or URL (evidence: `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`)
- Analysis API → AI analysis: runs analysis (evidence: `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`)
- AI analysis → Specialized prompts: uses prompts (evidence: `backend/src/main/java/com/compliance/platform/service/ai/AiService.java`)
- AI analysis → Model API client: requests model (evidence: `backend/src/main/java/com/compliance/platform/service/ai/AiService.java`)
- Model API client → External AI provider: calls model
- Analysis API → Report and scoring: saves report (evidence: `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`)
- Report and scoring → Mongo repositories: persists and queries (evidence: `backend/src/main/java/com/compliance/platform/service/ReportService.java`)
- Mongo repositories → MongoDB: reads and writes (evidence: `README.md`)
- Analysis API → Audit trail: records activity (evidence: `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`)
- Audit trail → Mongo repositories: stores audit logs (evidence: `backend/src/main/java/com/compliance/platform/service/AuditService.java`)
- Report approvals → Report and scoring: manages reports (evidence: `backend/src/main/java/com/compliance/platform/controller/ReportController.java`)
- Report approvals → Audit trail: records review actions (evidence: `backend/src/main/java/com/compliance/platform/controller/ReportController.java`)
- Analysis and API client → Version comparison: requests comparison
- Version comparison → Mongo repositories: stores comparisons (evidence: `backend/src/main/java/com/compliance/platform/service/VersionComparisonService.java`)
- Audit and admin APIs → Audit trail: serves audit views (evidence: `backend/src/main/java/com/compliance/platform/controller/AnalyzeController.java`)
- Authentication API → User and roles: handles accounts (evidence: `backend/src/main/java/com/compliance/platform/controller/AuthController.java`)
- Authentication API → Audit trail: records auth events (evidence: `backend/src/main/java/com/compliance/platform/controller/AuthController.java`)
- User and roles → Mongo repositories: reads and writes users (evidence: `backend/src/main/java/com/compliance/platform/service/UserService.java`)
- JWT security → Authentication API: protects API (evidence: `backend/src/main/java/com/compliance/platform/controller/AuthController.java`)
