# arjun-coder-ops/prism_ai_code_review_system architecture

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

- Interactive diagram: https://gitdiagram.com/arjun-coder-ops/prism_ai_code_review_system
- Repository: https://github.com/arjun-coder-ops/prism_ai_code_review_system

## Overview

PRISM is an evidence-first pull-request review workspace. A user submits a canonical GitHub PR URL through the React client; the API validates it, records a review, and queues work. A worker retrieves PR metadata and files, parses diffs, detects candidate issues, verifies their evidence, and stores findings for API retrieval. GitHub webhooks provide a separate event-driven review-request path. The map includes documented but credential-gated integrations; unsampled implementation details and frontend request wiring are not inferred beyond the README.

Main entry points: [`backend/app/api.py`](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/api.py) (Review API), [`backend/app/workers/celery_app.py`](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/workers/celery_app.py) (Review worker), [`backend/app/db/session.py`](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/db/session.py) (Database sessions), [`backend/app/services/github.py`](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/services/github.py) (PR retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Review entry points"]
  node_frontend["React client<br/>[main.tsx]"]
  node_api["Review API<br/>[api.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_metrics["Review metrics<br/>[metrics.py]"]
end

subgraph group_processing["Review processing"]
  node_worker["Review worker<br/>[celery_app.py]"]
  node_diff["Diff parser<br/>[diff.py]"]
  node_static["Static checks<br/>[static.py]"]
  node_evidence["Evidence verifier<br/>[evidence.py]"]
  node_impact["Impact analysis<br/>[impact.py]"]
  node_test_gaps["Test-gap analysis<br/>[test_gaps.py]"]
end

subgraph group_persistence["Persistence and queue"]
  node_models["Review records<br/>[models.py]"]
  node_session["Database sessions<br/>[session.py]"]
  node_postgres[("PostgreSQL")]
  node_celery["Task dispatch<br/>[celery_app.py]"]
  node_redis["Redis broker"]
end

subgraph group_integrations["GitHub and extensions"]
  node_github_service["PR retrieval<br/>[github.py]"]
  node_webhooks["Webhook verification<br/>[webhooks.py]"]
  node_ai_providers["LLM providers<br/>[providers.py]"]
end

node_user(("Reviewer"))
node_github["GitHub"]

node_user -->|"submits PR"| node_frontend
node_frontend -->|"submits review"| node_api
node_api -->|"validates payloads"| node_schemas
node_api -->|"creates and reads"| node_models
node_api -->|"validates URL"| node_github_service
node_api -->|"enqueues review"| node_celery
node_api -->|"verifies signature"| node_webhooks
node_api -->|"increments counter"| node_metrics
node_api -->|"uses sessions"| node_session
node_worker -->|"loads sessions"| node_session
node_worker -->|"updates review records"| node_models
node_worker -->|"fetches PR data"| node_github_service
node_worker -->|"parses patches"| node_diff
node_worker -->|"finds candidates"| node_static
node_worker -->|"verifies candidates"| node_evidence
node_session -->|"connects to"| node_postgres
node_celery -->|"uses broker"| node_redis
node_github_service -->|"retrieves PR data"| node_github
node_api -->|"dispatches outbox"| node_celery
node_ai_providers -.->|"optional integration"| node_github

click node_frontend "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/frontend/src/main.tsx"
click node_api "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/api.py"
click node_schemas "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/schemas.py"
click node_worker "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/workers/celery_app.py"
click node_github_service "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/services/github.py"
click node_diff "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/services/diff.py"
click node_static "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/analysis/static.py"
click node_evidence "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/verification/evidence.py"
click node_models "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/models.py"
click node_session "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/db/session.py"
click node_celery "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/workers/celery_app.py"
click node_webhooks "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/github/webhooks.py"
click node_metrics "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/core/metrics.py"
click node_ai_providers "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/ai/providers.py"
click node_impact "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/intelligence/impact.py"
click node_test_gaps "https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/intelligence/test_gaps.py"

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_frontend,node_api,node_schemas,node_metrics,node_user toneBlue
class node_worker,node_diff,node_static,node_evidence,node_impact,node_test_gaps toneAmber
class node_models,node_session,node_postgres,node_celery,node_redis toneMint
class node_github_service,node_webhooks,node_ai_providers toneRose
class node_github toneIndigo
```

## Components

### Review entry points

- [React client](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Review API](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/api.py): `backend/app/api.py`
- [API schemas](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/schemas.py): `backend/app/schemas.py`
- [Review metrics](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/core/metrics.py): `backend/app/core/metrics.py`

### Review processing

- [Review worker](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/workers/celery_app.py): `backend/app/workers/celery_app.py`
- [Diff parser](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/services/diff.py): `backend/app/services/diff.py`
- [Static checks](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/analysis/static.py): `backend/app/analysis/static.py`
- [Evidence verifier](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/verification/evidence.py): `backend/app/verification/evidence.py`
- [Impact analysis](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/intelligence/impact.py): `backend/app/intelligence/impact.py`
- [Test-gap analysis](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/intelligence/test_gaps.py): `backend/app/intelligence/test_gaps.py`

### Persistence and queue

- [Review records](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/models.py): `backend/app/models.py`
- [Database sessions](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/db/session.py): `backend/app/db/session.py`
- **PostgreSQL**
- [Task dispatch](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/workers/celery_app.py): `backend/app/workers/celery_app.py`
- **Redis broker**

### GitHub and extensions

- [PR retrieval](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/services/github.py): `backend/app/services/github.py`
- [Webhook verification](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/github/webhooks.py): `backend/app/github/webhooks.py`
- [LLM providers](https://github.com/arjun-coder-ops/prism_ai_code_review_system/blob/arjunpush/backend/app/ai/providers.py): `backend/app/ai/providers.py`

### Other components

- **Reviewer**
- **GitHub**

## Connections

- Reviewer → React client: submits PR (evidence: `README.md`)
- React client → Review API: submits review (evidence: `README.md`)
- Review API → API schemas: validates payloads (evidence: `backend/app/api.py`)
- Review API → Review records: creates and reads (evidence: `backend/app/api.py`)
- Review API → PR retrieval: validates URL (evidence: `backend/app/api.py`)
- Review API → Task dispatch: enqueues review (evidence: `backend/app/api.py`)
- Review API → Webhook verification: verifies signature (evidence: `backend/app/api.py`)
- Review API → Review metrics: increments counter (evidence: `backend/app/api.py`)
- Review API → Database sessions: uses sessions (evidence: `backend/app/api.py`)
- Review worker → Database sessions: loads sessions (evidence: `backend/app/workers/celery_app.py`)
- Review worker → Review records: updates review records (evidence: `backend/app/workers/celery_app.py`)
- Review worker → PR retrieval: fetches PR data (evidence: `backend/app/workers/celery_app.py`)
- Review worker → Diff parser: parses patches (evidence: `backend/app/workers/celery_app.py`)
- Review worker → Static checks: finds candidates (evidence: `backend/app/workers/celery_app.py`)
- Review worker → Evidence verifier: verifies candidates (evidence: `backend/app/workers/celery_app.py`)
- Database sessions → PostgreSQL: connects to (evidence: `backend/app/db/session.py`)
- Task dispatch → Redis broker: uses broker (evidence: `backend/app/workers/celery_app.py`)
- PR retrieval → GitHub: retrieves PR data (evidence: `backend/app/services/github.py`)
- Review API → Task dispatch: dispatches outbox (evidence: `backend/app/api.py`)
- LLM providers → GitHub: optional integration
