# shalini-576-cse/agentic-intelligence-ai architecture

> Architecture diagram of the GitHub repository shalini-576-cse/agentic-intelligence-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shalini-576-cse/agentic-intelligence-ai
- Repository: https://github.com/shalini-576-cse/agentic-intelligence-ai

## Overview

AgentFlow AI is an account-scoped campaign planning and review app. Users register or sign in, generate campaigns, review and edit drafts, then manage campaigns and view account-based reports. The README documents planner, research, content generation, AI review, and publishing/management capabilities; unsampled implementation details are represented only where supported by that documentation. Source excerpts establish the authentication and campaign-cache paths, but do not expose all route-to-server wiring.

Main entry points: [`backend/lib/campaign-api.ts`](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/campaign-api.ts) (Campaign operations), [`frontend/src/lib/api/agentflow.ts`](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/lib/api/agentflow.ts) (Campaign data cache), [`backend/lib/auth-api.ts`](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/auth-api.ts) (Account operations), [`backend/lib/server/auth-store.ts`](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/auth-store.ts) (Account and campaign store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_routes["App routes"]
  node_authguard["Auth guard<br/>[require-auth.ts]"]
  node_campaignui["Campaign views"]
  node_dashboard["Dashboard and reports<br/>[dashboard.tsx]"]
  node_campaigncache["Campaign data cache<br/>[agentflow.ts]"]
  node_reports["Campaign reporting<br/>[reports.tsx]"]
end

subgraph group_services["Application services"]
  node_campaignapi["Campaign operations<br/>[campaign-api.ts]"]
  node_server["Server entry<br/>[server.ts]"]
  node_types["Shared contracts<br/>[types.ts]"]
end

subgraph group_identity["Accounts and persistence"]
  node_authapi["Account operations<br/>[auth-api.ts]"]
  node_accountapi["Profile operations<br/>[account-api.ts]"]
  node_authcontext["Request identity<br/>[auth-context.ts]"]
  node_authstore[("Account and campaign store<br/>[auth-store.ts]")]
  node_email["Verification and reset email<br/>[email.ts]"]
end

subgraph group_generation["Campaign generation"]
  node_generator["Campaign generation<br/>[generator.ts]"]
  node_review["AI review<br/>[campaign-api.ts]"]
  node_publisher["Publishing management<br/>[workflow.tsx]"]
end

node_user(("User"))
node_gemini["Gemini API"]

node_user -->|"uses"| node_routes
node_routes -->|"checks access"| node_authguard
node_authguard -->|"reads session"| node_authapi
node_campaignui -->|"manages campaigns"| node_campaigncache
node_dashboard -->|"reads metrics"| node_campaigncache
node_reports -->|"reads analytics"| node_campaigncache
node_campaigncache -->|"calls operations"| node_campaignapi
node_authapi -->|"reads and writes"| node_authstore
node_authapi -->|"sends account email"| node_email
node_authcontext -->|"resolves session"| node_authstore
node_campaignapi -->|"requires identity"| node_authcontext
node_campaignapi -->|"reads and writes"| node_authstore
node_campaignapi -->|"generates content"| node_generator
node_campaignapi -->|"reviews campaign"| node_review
node_generator -.->|"requests generation"| node_gemini
node_review -.->|"requests review"| node_gemini
node_publisher -.->|"manages workflow"| node_campaignapi
node_campaigncache -->|"uses contracts"| node_types

click node_routes "https://github.com/shalini-576-cse/agentic-intelligence-ai/tree/main/frontend/src/routes"
click node_authguard "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/lib/require-auth.ts"
click node_campaignui "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/campaigns.%24campaignId.tsx"
click node_dashboard "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/dashboard.tsx"
click node_campaigncache "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/lib/api/agentflow.ts"
click node_authapi "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/auth-api.ts"
click node_campaignapi "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/campaign-api.ts"
click node_accountapi "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/account-api.ts"
click node_authcontext "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/auth-context.ts"
click node_authstore "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/auth-store.ts"
click node_email "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/email.ts"
click node_generator "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/generator.ts"
click node_review "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/campaign-api.ts"
click node_publisher "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/workflow.tsx"
click node_reports "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/reports.tsx"
click node_server "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/server.ts"
click node_types "https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/shared/types.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_routes,node_authguard,node_campaignui,node_dashboard,node_campaigncache,node_reports,node_user toneBlue
class node_campaignapi,node_server,node_types toneAmber
class node_authapi,node_accountapi,node_authcontext,node_authstore,node_email,node_gemini toneMint
class node_generator,node_review,node_publisher toneRose
```

## Components

### Frontend experience

- [App routes](https://github.com/shalini-576-cse/agentic-intelligence-ai/tree/main/frontend/src/routes): `frontend/src/routes`
- [Auth guard](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/lib/require-auth.ts): `frontend/src/lib/require-auth.ts`
- [Campaign views](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/campaigns.%24campaignId.tsx): `frontend/src/routes/campaigns.$campaignId.tsx`
- [Dashboard and reports](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/dashboard.tsx): `frontend/src/routes/dashboard.tsx`
- [Campaign data cache](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/lib/api/agentflow.ts): `frontend/src/lib/api/agentflow.ts`
- [Campaign reporting](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/reports.tsx): `frontend/src/routes/reports.tsx`

### Application services

- [Campaign operations](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/campaign-api.ts): `backend/lib/campaign-api.ts`
- [Server entry](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/server.ts): `backend/server.ts`
- [Shared contracts](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/shared/types.ts): `shared/types.ts`

### Accounts and persistence

- [Account operations](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/auth-api.ts): `backend/lib/auth-api.ts`
- [Profile operations](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/account-api.ts): `backend/lib/account-api.ts`
- [Request identity](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/auth-context.ts): `backend/lib/server/auth-context.ts`
- [Account and campaign store](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/auth-store.ts): `backend/lib/server/auth-store.ts`
- [Verification and reset email](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/server/email.ts): `backend/lib/server/email.ts`

### Campaign generation

- [Campaign generation](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/generator.ts): `backend/lib/generator.ts`
- [AI review](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/backend/lib/campaign-api.ts): `backend/lib/campaign-api.ts`
- [Publishing management](https://github.com/shalini-576-cse/agentic-intelligence-ai/blob/main/frontend/src/routes/workflow.tsx): `frontend/src/routes/workflow.tsx`

### Other components

- **User**
- **Gemini API**

## Connections

- User → App routes: uses
- App routes → Auth guard: checks access
- Auth guard → Account operations: reads session
- Campaign views → Campaign data cache: manages campaigns
- Dashboard and reports → Campaign data cache: reads metrics
- Campaign reporting → Campaign data cache: reads analytics
- Campaign data cache → Campaign operations: calls operations
- Account operations → Account and campaign store: reads and writes
- Account operations → Verification and reset email: sends account email
- Request identity → Account and campaign store: resolves session
- Campaign operations → Request identity: requires identity
- Campaign operations → Account and campaign store: reads and writes
- Campaign operations → Campaign generation: generates content
- Campaign operations → AI review: reviews campaign
- Campaign generation → Gemini API: requests generation
- AI review → Gemini API: requests review
- Publishing management → Campaign operations: manages workflow
- Campaign data cache → Shared contracts: uses contracts