# chodisettiakshitha-code/iiit architecture

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

- Interactive diagram: https://gitdiagram.com/chodisettiakshitha-code/iiit
- Repository: https://github.com/chodisettiakshitha-code/iiit

## Overview

Collection Copilot 360 is a collections decision-support application. Collectors review portfolio metrics, select a customer, inspect a unified profile and reconstructed timeline, compare what changed, read the customer story, and review a reasoned next-best action before approving, modifying, or overriding it. The app also provides a collections assistant, data-quality diagnostics, and governance/audit views. Backend relationships follow sampled routes and service calls; frontend-to-backend links are HTTP interactions documented by the README and API client. Several domain capabilities are documented but their implementation details were not sampled.

Main entry points: [`backend/main.py`](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/main.py) (API routes), [`frontend/src/App.tsx`](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/App.tsx) (Application shell), [`frontend/src/api.ts`](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/api.ts) (HTTP API client), [`backend/models.py`](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/models.py) (Relational models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Collector interface"]
  node_app["Application shell<br/>[App.tsx]"]
  node_navbar["Navigation and search<br/>[Navbar.tsx]"]
  node_dashboard["Portfolio dashboard<br/>[DashboardView.tsx]"]
  node_workspace["Customer workspace"]
  node_assistantview["Assistant view<br/>[AssistantView.tsx]"]
  node_qualityview["Data quality view"]
  node_governanceview["Governance view<br/>[GovernanceView.tsx]"]
end

subgraph group_api["Application API"]
  node_client["HTTP API client<br/>[api.ts]"]
  node_fastapi["API routes<br/>[main.py]"]
end

subgraph group_domain["Collections services"]
  node_reconstruction["Customer reconstruction"]
  node_customer360["Unified customer profile"]
  node_timeline["Chronological timeline"]
  node_changed["State comparison"]
  node_story["Customer story"]
  node_nba["Next-best action"]
  node_audit["Decision audit"]
  node_assistant["Collections assistant"]
  node_quality["Data quality checks"]
  node_dashboarddata["Dashboard metrics<br/>[main.py]"]
end

subgraph group_persistence["Data layer"]
  node_orm["Relational models<br/>[models.py]"]
  node_database[("Collections database<br/>[collections360.db]")]
end

node_collector(("Collector"))

node_collector -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_workspace
node_app -->|"renders"| node_assistantview
node_app -->|"renders"| node_qualityview
node_app -->|"renders"| node_governanceview
node_dashboard -->|"fetches metrics"| node_client
node_workspace -->|"requests customer data"| node_client
node_workspace -->|"submits decisions"| node_client
node_assistantview -->|"queries"| node_client
node_qualityview -->|"requests checks"| node_client
node_governanceview -->|"requests audit data"| node_client
node_navbar -->|"searches customers"| node_client
node_client -->|"calls HTTP routes"| node_fastapi
node_fastapi -->|"serves metrics"| node_dashboarddata
node_fastapi -->|"creates service"| node_reconstruction
node_fastapi -->|"creates service"| node_assistant
node_fastapi -->|"creates service"| node_quality
node_reconstruction -->|"builds profile"| node_customer360
node_reconstruction -->|"builds timeline"| node_timeline
node_customer360 -->|"provides source data"| node_story
node_fastapi -->|"serves analysis"| node_changed
node_fastapi -->|"serves story"| node_story
node_fastapi -->|"serves recommendation"| node_nba
node_fastapi -->|"serves audit trail"| node_audit
node_fastapi -->|"queries and writes"| node_orm
node_assistant -->|"queries customer records"| node_orm
node_quality -->|"checks records"| node_orm
node_reconstruction -->|"queries and writes"| node_orm
node_orm -->|"maps records"| node_database
node_fastapi -->|"opens sessions"| node_database

click node_app "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/App.tsx"
click node_navbar "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/Navbar.tsx"
click node_dashboard "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/DashboardView.tsx"
click node_workspace "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/CustomerWorkspace.tsx"
click node_assistantview "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/AssistantView.tsx"
click node_qualityview "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/DataQualityView.tsx"
click node_governanceview "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/GovernanceView.tsx"
click node_client "https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/api.ts"
click node_fastapi "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/main.py"
click node_reconstruction "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_customer360 "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_timeline "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_changed "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_story "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_nba "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_audit "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py"
click node_assistant "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/assistant_service.py"
click node_quality "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/data_quality_service.py"
click node_dashboarddata "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/main.py"
click node_orm "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/models.py"
click node_database "https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/collections360.db"

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_navbar,node_dashboard,node_workspace,node_assistantview,node_qualityview,node_governanceview toneBlue
class node_client,node_fastapi toneAmber
class node_reconstruction,node_customer360,node_timeline,node_changed,node_story,node_nba,node_audit,node_assistant,node_quality,node_dashboarddata toneMint
class node_orm,node_database toneRose
class node_collector toneIndigo
```

## Components

### Collector interface

- [Application shell](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Navigation and search](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/Navbar.tsx): `frontend/src/components/Navbar.tsx`
- [Portfolio dashboard](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/DashboardView.tsx): `frontend/src/components/DashboardView.tsx`
- [Customer workspace](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/CustomerWorkspace.tsx): `frontend/src/components/CustomerWorkspace.tsx`
- [Assistant view](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/AssistantView.tsx): `frontend/src/components/AssistantView.tsx`
- [Data quality view](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/DataQualityView.tsx): `frontend/src/components/DataQualityView.tsx`
- [Governance view](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/components/GovernanceView.tsx): `frontend/src/components/GovernanceView.tsx`

### Application API

- [HTTP API client](https://github.com/chodisettiakshitha-code/iiit/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [API routes](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/main.py): `backend/main.py`

### Collections services

- [Customer reconstruction](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Unified customer profile](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Chronological timeline](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [State comparison](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Customer story](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Next-best action](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Decision audit](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/reconstruction_engine.py): `backend/services/reconstruction_engine.py`
- [Collections assistant](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/assistant_service.py): `backend/services/assistant_service.py`
- [Data quality checks](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/services/data_quality_service.py): `backend/services/data_quality_service.py`
- [Dashboard metrics](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/main.py): `backend/main.py`

### Data layer

- [Relational models](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/models.py): `backend/models.py`
- [Collections database](https://github.com/chodisettiakshitha-code/iiit/blob/main/backend/collections360.db): `backend/collections360.db`

### Other components

- **Collector**

## Connections

- Collector → Application shell: uses (evidence: `README.md`)
- Application shell → Navigation and search: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Portfolio dashboard: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Customer workspace: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Assistant view: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Data quality view: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Governance view: renders (evidence: `frontend/src/App.tsx`)
- Portfolio dashboard → HTTP API client: fetches metrics (evidence: `frontend/src/components/DashboardView.tsx`)
- Customer workspace → HTTP API client: requests customer data (evidence: `frontend/src/components/CustomerWorkspace.tsx`)
- Customer workspace → HTTP API client: submits decisions (evidence: `frontend/src/components/CustomerWorkspace.tsx`)
- Assistant view → HTTP API client: queries (evidence: `frontend/src/components/AssistantView.tsx`)
- Data quality view → HTTP API client: requests checks (evidence: `frontend/src/components/DataQualityView.tsx`)
- Governance view → HTTP API client: requests audit data (evidence: `frontend/src/components/GovernanceView.tsx`)
- Navigation and search → HTTP API client: searches customers (evidence: `frontend/src/components/Navbar.tsx`)
- HTTP API client → API routes: calls HTTP routes (evidence: `README.md`)
- API routes → Dashboard metrics: serves metrics (evidence: `backend/main.py`)
- API routes → Customer reconstruction: creates service (evidence: `backend/main.py`)
- API routes → Collections assistant: creates service (evidence: `backend/main.py`)
- API routes → Data quality checks: creates service (evidence: `backend/main.py`)
- Customer reconstruction → Unified customer profile: builds profile (evidence: `backend/services/reconstruction_engine.py`)
- Customer reconstruction → Chronological timeline: builds timeline (evidence: `backend/services/reconstruction_engine.py`)
- Unified customer profile → Customer story: provides source data (evidence: `backend/services/reconstruction_engine.py`)
- API routes → State comparison: serves analysis (evidence: `README.md`)
- API routes → Customer story: serves story (evidence: `README.md`)
- API routes → Next-best action: serves recommendation (evidence: `README.md`)
- API routes → Decision audit: serves audit trail (evidence: `backend/main.py`)
- API routes → Relational models: queries and writes (evidence: `backend/main.py`)
- Collections assistant → Relational models: queries customer records (evidence: `backend/services/assistant_service.py`)
- Data quality checks → Relational models: checks records (evidence: `backend/services/data_quality_service.py`)
- Customer reconstruction → Relational models: queries and writes (evidence: `backend/services/reconstruction_engine.py`)
- Relational models → Collections database: maps records (evidence: `backend/models.py`)
- API routes → Collections database: opens sessions
