# tranmanhhung522006/brandcomplianceai architecture

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

- Interactive diagram: https://gitdiagram.com/tranmanhhung522006/brandcomplianceai
- Repository: https://github.com/tranmanhhung522006/brandcomplianceai

## Overview

Brand Compliance AI is a campaign-based asset review system. Makers submit marketing assets; background scoring applies three AI compliance checks using campaign documents; Checkers review or override results; Admins release approved work. The frontend also supports campaign/team management, compliance-document administration, and audit viewing. The graph reflects documented workflow stages and source-indexed dependencies; several routes, worker details, and frontend-to-backend calls were not sampled, so those links are omitted or marked unverified.

Main entry points: [`backend/src/prisma/prisma.service.ts`](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/prisma/prisma.service.ts) (Prisma data access), [`backend/src/compliance-documents/compliance-documents.service.ts`](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/compliance-documents/compliance-documents.service.ts) (Compliance documents), [`frontend/src/pages`](https://github.com/tranmanhhung522006/brandcomplianceai/tree/main/frontend/src/pages) (Workflow pages), [`backend/src/scoring/scoring.service.ts`](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/scoring/scoring.service.ts) (Background scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Web portal"]
  node_portal["Web application<br/>[App.tsx]"]
  node_pages["Workflow pages"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_workflow["Asset workflow"]
  node_campaigns["Campaign management"]
  node_asset_upload["Asset intake"]
  node_scoring["Background scoring<br/>[scoring.service.ts]"]
  node_reviews["Checker reviews<br/>[reviews.service.ts]"]
  node_releases["Admin release"]
end

subgraph group_policy["Policy and AI"]
  node_compliance_docs["Compliance documents"]
  node_ai["AI compliance checks<br/>[ai.service.ts]"]
  node_llm["LLM gateway"]
end

subgraph group_identity["Identity and governance"]
  node_auth["Session authentication<br/>[auth.guard.ts]"]
  node_wp_auth["WordPress SSO"]
  node_audit["Audit log<br/>[audit.service.ts]"]
end

subgraph group_platform["Persistence and files"]
  node_prisma["Prisma data access<br/>[prisma.service.ts]"]
  node_database[("PostgreSQL")]
  node_storage["Asset storage<br/>[storage.service.ts]"]
end

node_maker(("Maker"))
node_checker(("Checker"))
node_admin(("Admin"))
node_openai["OpenAI"]
node_file_store[("Local or R2 storage")]

node_maker -->|"submits asset"| node_pages
node_pages -->|"routes through"| node_portal
node_portal -.->|"uses API"| node_api_client
node_api_client -.->|"sends upload"| node_asset_upload
node_asset_upload -->|"queues scoring"| node_scoring
node_scoring -->|"requests checks"| node_ai
node_ai -.->|"delegates checks"| node_llm
node_llm -->|"requests analysis"| node_openai
node_llm -->|"loads campaign documents"| node_compliance_docs
node_scoring -->|"records activity"| node_audit
node_checker -->|"submits decision"| node_reviews
node_reviews -->|"reads and writes"| node_prisma
node_admin -->|"releases approved work"| node_releases
node_campaigns -->|"reads and writes"| node_prisma
node_compliance_docs -->|"stores documents"| node_storage
node_compliance_docs -->|"reads and writes"| node_prisma
node_storage -->|"stores files"| node_file_store
node_auth -->|"loads user"| node_prisma
node_wp_auth -->|"synchronizes user"| node_prisma
node_audit -->|"reads and writes"| node_prisma
node_prisma -.->|"persists records"| node_database
node_admin -->|"manages policy files"| node_compliance_docs
node_checker -->|"uses review portal"| node_pages
node_admin -->|"uses admin portal"| node_pages

click node_portal "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/frontend/src/App.tsx"
click node_pages "https://github.com/tranmanhhung522006/brandcomplianceai/tree/main/frontend/src/pages"
click node_api_client "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/frontend/src/services/api.ts"
click node_campaigns "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/campaigns/campaigns.service.ts"
click node_asset_upload "https://github.com/tranmanhhung522006/brandcomplianceai/tree/main/backend/src"
click node_scoring "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/scoring/scoring.service.ts"
click node_reviews "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/reviews/reviews.service.ts"
click node_releases "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/releases/releases.service.ts"
click node_compliance_docs "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/compliance-documents/compliance-documents.service.ts"
click node_ai "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/ai/ai.service.ts"
click node_llm "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/ai/llm-gateway.service.ts"
click node_auth "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/auth/auth.guard.ts"
click node_wp_auth "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/wordpress-auth/wordpress-auth.service.ts"
click node_audit "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/audit/audit.service.ts"
click node_prisma "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/prisma/prisma.service.ts"
click node_storage "https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/storage/storage.service.ts"

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,node_pages,node_api_client toneBlue
class node_campaigns,node_asset_upload,node_scoring,node_reviews,node_releases,node_file_store toneAmber
class node_compliance_docs,node_ai,node_llm toneMint
class node_auth,node_wp_auth,node_audit toneRose
class node_prisma,node_database,node_storage,node_maker,node_checker,node_admin,node_openai toneIndigo
```

## Components

### Web portal

- [Web application](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Workflow pages](https://github.com/tranmanhhung522006/brandcomplianceai/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Asset workflow

- [Campaign management](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/campaigns/campaigns.service.ts): `backend/src/campaigns/campaigns.service.ts`
- [Asset intake](https://github.com/tranmanhhung522006/brandcomplianceai/tree/main/backend/src): `backend/src`
- [Background scoring](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/scoring/scoring.service.ts): `backend/src/scoring/scoring.service.ts`
- [Checker reviews](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/reviews/reviews.service.ts): `backend/src/reviews/reviews.service.ts`
- [Admin release](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/releases/releases.service.ts): `backend/src/releases/releases.service.ts`

### Policy and AI

- [Compliance documents](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/compliance-documents/compliance-documents.service.ts): `backend/src/compliance-documents/compliance-documents.service.ts`
- [AI compliance checks](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/ai/ai.service.ts): `backend/src/ai/ai.service.ts`
- [LLM gateway](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/ai/llm-gateway.service.ts): `backend/src/ai/llm-gateway.service.ts`

### Identity and governance

- [Session authentication](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/auth/auth.guard.ts): `backend/src/auth/auth.guard.ts`
- [WordPress SSO](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/wordpress-auth/wordpress-auth.service.ts): `backend/src/wordpress-auth/wordpress-auth.service.ts`
- [Audit log](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/audit/audit.service.ts): `backend/src/audit/audit.service.ts`

### Persistence and files

- [Prisma data access](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- **PostgreSQL**
- [Asset storage](https://github.com/tranmanhhung522006/brandcomplianceai/blob/main/backend/src/storage/storage.service.ts): `backend/src/storage/storage.service.ts`

### Other components

- **Maker**
- **Checker**
- **Admin**
- **OpenAI**
- **Local or R2 storage**

## Connections

- Maker → Workflow pages: submits asset
- Workflow pages → Web application: routes through (evidence: `frontend/src/App.tsx`)
- Web application → API client: uses API
- API client → Asset intake: sends upload
- Asset intake → Background scoring: queues scoring (evidence: `backend/src/scoring/scoring.controller.ts`)
- Background scoring → AI compliance checks: requests checks (evidence: `backend/src/scoring/scoring.service.ts`)
- AI compliance checks → LLM gateway: delegates checks
- LLM gateway → OpenAI: requests analysis (evidence: `backend/src/ai/llm-gateway.service.ts`)
- LLM gateway → Compliance documents: loads campaign documents (evidence: `backend/src/ai/llm-gateway.service.ts`)
- Background scoring → Audit log: records activity (evidence: `backend/src/scoring/scoring.service.ts`)
- Checker → Checker reviews: submits decision
- Checker reviews → Prisma data access: reads and writes (evidence: `backend/src/reviews/reviews.service.ts`)
- Admin → Admin release: releases approved work
- Campaign management → Prisma data access: reads and writes (evidence: `backend/src/campaigns/campaigns.service.ts`)
- Compliance documents → Asset storage: stores documents (evidence: `backend/src/compliance-documents/compliance-documents.service.ts`)
- Compliance documents → Prisma data access: reads and writes (evidence: `backend/src/compliance-documents/compliance-documents.service.ts`)
- Asset storage → Local or R2 storage: stores files (evidence: `backend/src/storage/storage.service.ts`)
- Session authentication → Prisma data access: loads user (evidence: `backend/src/auth/auth.guard.ts`)
- WordPress SSO → Prisma data access: synchronizes user (evidence: `backend/src/wordpress-auth/wordpress-auth.service.ts`)
- Audit log → Prisma data access: reads and writes (evidence: `backend/src/audit/audit.service.ts`)
- Prisma data access → PostgreSQL: persists records
- Admin → Compliance documents: manages policy files
- Checker → Workflow pages: uses review portal
- Admin → Workflow pages: uses admin portal
