# shrutidhepe/ai-based-contract-clause-analyzer architecture

> Architecture diagram of the GitHub repository shrutidhepe/ai-based-contract-clause-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shrutidhepe/ai-based-contract-clause-analyzer
- Repository: https://github.com/shrutidhepe/ai-based-contract-clause-analyzer

## Overview

This is a contract-management and risk-analysis application. Users register or sign in, upload contracts, inspect their contract list and analysis reports, and manage notifications, profiles, and audit history. The server handles authenticated API routes, contract storage, analysis, and account activity. Analysis includes clause extraction/classification, risk scoring, drift detection, and summary generation. The map follows relationships shown in excerpts or the source index; links whose cross-service wiring was not shown are omitted.

Main entry points: [`server/src/services/analysis.service.js`](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis.service.js) (Analysis workflow), [`client/src/App.jsx`](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/App.jsx) (Route application), [`server/src/controllers/user.controllers.js`](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/user.controllers.js) (Account controller), [`server/src/controllers/contract.controllers.js`](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/contract.controllers.js) (Contract controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Route application<br/>[App.jsx]"]
  node_authctx["Authentication state<br/>[AuthContext.jsx]"]
  node_authapi["Authentication API<br/>[auth.js]"]
  node_contractpages["Contract screens"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_analysisview["Analysis report view<br/>[AnalysisResult.jsx]"]
  node_notifctx["Notification state"]
  node_notifpage["Notification screen<br/>[Notifications.jsx]"]
  node_profile["Profile screen<br/>[Profiles.jsx]"]
end

subgraph group_api["API and accounts"]
  node_serverapp["HTTP application<br/>[app.js]"]
  node_userroute["User routes<br/>[user.routes.js]"]
  node_userctrl["Account controller"]
  node_authmw["JWT middleware"]
end

subgraph group_contracts["Contracts and analysis"]
  node_contractroute["Contract routes<br/>[contract.routes.js]"]
  node_contractctrl["Contract controller"]
  node_analysisroute["Analysis routes<br/>[analysis.routes.js]"]
  node_analysisctrl["Analysis controller"]
  node_analysisservice["Analysis workflow"]
  node_clause["Clause analysis<br/>[clauseAnalysis.js]"]
  node_risk["Risk scoring<br/>[riskEngine.js]"]
  node_drift["Clause drift<br/>[driftEngine.js]"]
  node_summary["Contract summary<br/>[summaryEngine.js]"]
  node_ml["ML model service<br/>[model_server.py]"]
end

subgraph group_records["Activity and persistence"]
  node_contractmodel["Contract records<br/>[contract.models.js]"]
  node_usermodel["User records<br/>[user.models.js]"]
  node_notifctrl["Notification controller"]
  node_notifmodel["Notification records"]
  node_audit["Audit logging"]
  node_auditmodel["Audit records<br/>[auditLog.models.js]"]
end

node_user(("Contract user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_contractpages
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_notifpage
node_app -->|"routes to"| node_profile
node_authctx -->|"calls"| node_authapi
node_notifctx -->|"reads state"| node_authctx
node_notifctx -.->|"provides state"| node_notifpage
node_dashboard -.->|"uses contract API"| node_contractpages
node_serverapp -->|"mounts routes"| node_userroute
node_serverapp -->|"mounts routes"| node_contractroute
node_serverapp -->|"mounts routes"| node_analysisroute
node_userroute -->|"dispatches to"| node_userctrl
node_userroute -->|"guards routes"| node_authmw
node_contractroute -->|"dispatches to"| node_contractctrl
node_contractroute -->|"guards routes"| node_authmw
node_analysisroute -->|"dispatches to"| node_analysisctrl
node_analysisroute -->|"guards routes"| node_authmw
node_userctrl -->|"reads and writes"| node_usermodel
node_userctrl -->|"reads and deletes"| node_contractmodel
node_userctrl -->|"records activity"| node_audit
node_contractctrl -->|"creates and queries"| node_contractmodel
node_contractctrl -->|"records activity"| node_audit
node_contractctrl -->|"creates notification"| node_notifmodel
node_analysisctrl -->|"delegates to"| node_analysisservice
node_analysisservice -->|"uses"| node_clause
node_analysisservice -->|"uses"| node_risk
node_analysisservice -->|"uses"| node_drift
node_analysisservice -->|"uses"| node_summary
node_analysisservice -->|"stores contract analysis"| node_contractmodel
node_analysisservice -.->|"requests inference"| node_ml
node_notifctrl -->|"queries and updates"| node_notifmodel
node_audit -->|"creates records"| node_auditmodel

click node_app "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/App.jsx"
click node_authctx "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/context/AuthContext.jsx"
click node_authapi "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/api/auth.js"
click node_contractpages "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/tree/main/client/src/pages/Contracts"
click node_dashboard "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/DashBoard/Dashboard.jsx"
click node_analysisview "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/Analysis/AnalysisResult.jsx"
click node_notifctx "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/context/NotificationContext.jsx"
click node_notifpage "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/Notifications/Notifications.jsx"
click node_profile "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/profile/Profiles.jsx"
click node_serverapp "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/app.js"
click node_userroute "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/user.routes.js"
click node_userctrl "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/user.controllers.js"
click node_authmw "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/middlewares/auth.middlewares.js"
click node_contractroute "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/contract.routes.js"
click node_contractctrl "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/contract.controllers.js"
click node_analysisroute "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/analysis.routes.js"
click node_analysisctrl "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/analysis.controllers.js"
click node_analysisservice "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis.service.js"
click node_clause "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/clauseAnalysis.js"
click node_risk "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/riskEngine.js"
click node_drift "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/driftEngine.js"
click node_summary "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/summaryEngine.js"
click node_ml "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/analysis/python/model_server.py"
click node_contractmodel "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/contract.models.js"
click node_usermodel "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/user.models.js"
click node_notifctrl "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/notifications.controllers.js"
click node_notifmodel "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/notification.models.js"
click node_audit "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/auditlog.service.js"
click node_auditmodel "https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/auditLog.models.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_authctx,node_authapi,node_contractpages,node_dashboard,node_analysisview,node_notifctx,node_notifpage,node_profile,node_user toneBlue
class node_serverapp,node_userroute,node_userctrl,node_authmw toneAmber
class node_contractroute,node_contractctrl,node_analysisroute,node_analysisctrl,node_analysisservice,node_clause,node_risk,node_drift,node_summary,node_ml toneMint
class node_contractmodel,node_usermodel,node_notifctrl,node_notifmodel,node_audit,node_auditmodel toneRose
```

## Components

### Web application

- [Route application](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Authentication state](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Authentication API](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/api/auth.js): `client/src/api/auth.js`
- [Contract screens](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/tree/main/client/src/pages/Contracts): `client/src/pages/Contracts`
- [Dashboard](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/DashBoard/Dashboard.jsx): `client/src/pages/DashBoard/Dashboard.jsx`
- [Analysis report view](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/Analysis/AnalysisResult.jsx): `client/src/pages/Analysis/AnalysisResult.jsx`
- [Notification state](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/context/NotificationContext.jsx): `client/src/context/NotificationContext.jsx`
- [Notification screen](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/Notifications/Notifications.jsx): `client/src/pages/Notifications/Notifications.jsx`
- [Profile screen](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/client/src/pages/profile/Profiles.jsx): `client/src/pages/profile/Profiles.jsx`

### API and accounts

- [HTTP application](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/app.js): `server/src/app.js`
- [User routes](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/user.routes.js): `server/src/routes/user.routes.js`
- [Account controller](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/user.controllers.js): `server/src/controllers/user.controllers.js`
- [JWT middleware](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/middlewares/auth.middlewares.js): `server/src/middlewares/auth.middlewares.js`

### Contracts and analysis

- [Contract routes](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/contract.routes.js): `server/src/routes/contract.routes.js`
- [Contract controller](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/contract.controllers.js): `server/src/controllers/contract.controllers.js`
- [Analysis routes](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/routes/analysis.routes.js): `server/src/routes/analysis.routes.js`
- [Analysis controller](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/analysis.controllers.js): `server/src/controllers/analysis.controllers.js`
- [Analysis workflow](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis.service.js): `server/src/services/analysis.service.js`
- [Clause analysis](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/clauseAnalysis.js): `server/src/services/analysis/clauseAnalysis.js`
- [Risk scoring](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/riskEngine.js): `server/src/services/analysis/riskEngine.js`
- [Clause drift](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/driftEngine.js): `server/src/services/analysis/driftEngine.js`
- [Contract summary](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/analysis/summaryEngine.js): `server/src/services/analysis/summaryEngine.js`
- [ML model service](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/analysis/python/model_server.py): `server/src/analysis/python/model_server.py`

### Activity and persistence

- [Contract records](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/contract.models.js): `server/src/models/contract.models.js`
- [User records](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/user.models.js): `server/src/models/user.models.js`
- [Notification controller](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/controllers/notifications.controllers.js): `server/src/controllers/notifications.controllers.js`
- [Notification records](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/notification.models.js): `server/src/models/notification.models.js`
- [Audit logging](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/services/auditlog.service.js): `server/src/services/auditlog.service.js`
- [Audit records](https://github.com/shrutidhepe/ai-based-contract-clause-analyzer/blob/main/server/src/models/auditLog.models.js): `server/src/models/auditLog.models.js`

### Other components

- **Contract user**

## Connections

- Contract user → Route application: uses (evidence: `client/src/App.jsx`)
- Route application → Contract screens: routes to (evidence: `client/src/App.jsx`)
- Route application → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Route application → Notification screen: routes to (evidence: `client/src/App.jsx`)
- Route application → Profile screen: routes to (evidence: `client/src/App.jsx`)
- Authentication state → Authentication API: calls (evidence: `client/src/context/AuthContext.jsx`)
- Notification state → Authentication state: reads state (evidence: `client/src/context/NotificationContext.jsx`)
- Notification state → Notification screen: provides state (evidence: `client/src/pages/Notifications/Notifications.jsx`)
- Dashboard → Contract screens: uses contract API
- HTTP application → User routes: mounts routes (evidence: `server/src/app.js`)
- HTTP application → Contract routes: mounts routes (evidence: `server/src/app.js`)
- HTTP application → Analysis routes: mounts routes (evidence: `server/src/app.js`)
- User routes → Account controller: dispatches to (evidence: `server/src/routes/user.routes.js`)
- User routes → JWT middleware: guards routes (evidence: `server/src/routes/user.routes.js`)
- Contract routes → Contract controller: dispatches to (evidence: `server/src/routes/contract.routes.js`)
- Contract routes → JWT middleware: guards routes (evidence: `server/src/routes/contract.routes.js`)
- Analysis routes → Analysis controller: dispatches to (evidence: `server/src/routes/analysis.routes.js`)
- Analysis routes → JWT middleware: guards routes (evidence: `server/src/routes/analysis.routes.js`)
- Account controller → User records: reads and writes (evidence: `server/src/controllers/user.controllers.js`)
- Account controller → Contract records: reads and deletes (evidence: `server/src/controllers/user.controllers.js`)
- Account controller → Audit logging: records activity (evidence: `server/src/controllers/user.controllers.js`)
- Contract controller → Contract records: creates and queries (evidence: `server/src/controllers/contract.controllers.js`)
- Contract controller → Audit logging: records activity (evidence: `server/src/controllers/contract.controllers.js`)
- Contract controller → Notification records: creates notification (evidence: `server/src/controllers/contract.controllers.js`)
- Analysis controller → Analysis workflow: delegates to
- Analysis workflow → Clause analysis: uses (evidence: `server/src/services/analysis.service.js`)
- Analysis workflow → Risk scoring: uses (evidence: `server/src/services/analysis.service.js`)
- Analysis workflow → Clause drift: uses (evidence: `server/src/services/analysis.service.js`)
- Analysis workflow → Contract summary: uses (evidence: `server/src/services/analysis.service.js`)
- Analysis workflow → Contract records: stores contract analysis (evidence: `server/src/services/analysis.service.js`)
- Analysis workflow → ML model service: requests inference
- Notification controller → Notification records: queries and updates (evidence: `server/src/controllers/notifications.controllers.js`)
- Audit logging → Audit records: creates records (evidence: `server/src/services/auditlog.service.js`)
