# harshiniudayakumar/intellitransplant architecture

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

- Interactive diagram: https://gitdiagram.com/harshiniudayakumar/intellitransplant
- Repository: https://github.com/harshiniudayakumar/intellitransplant

## Overview

IntelliTransplant is a FastAPI organ-transplant coordination API. Its central workflow is to register organ, recipient, and hospital data; evaluate recipient eligibility and rank compatible assignments; and plan organ transport with route, risk, and coordination assessments. The graph includes the documented-in-code API and AI stages plus the persistence layer. Several engine implementations and route details were not excerpted, so their relationships are included only where the source index names them; no README was provided.

Main entry points: [`backend/app/routes/transport_routes.py`](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/transport_routes.py) (Transport planning), [`backend/app/db/connection.py`](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/connection.py) (Database sessions), [`backend/app/main.py`](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/routes/matching_routes.py`](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/matching_routes.py) (Match workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_application["FastAPI application<br/>[main.py]"]
  node_organ_routes["Organ registry<br/>[organ_routes.py]"]
  node_recipient_routes["Recipient registry"]
  node_hospital_routes["Hospital registry<br/>[hospital_routes.py]"]
  node_matching_routes["Match workflow<br/>[matching_routes.py]"]
  node_transport_routes["Transport planning"]
end

subgraph group_ai["Decision engines"]
  node_knowledge["Eligibility rules"]
  node_csp["CSP matching<br/>[csp_engine.py]"]
  node_astar["A* routing<br/>[astar_engine.py]"]
  node_ucs["Uniform-cost routing<br/>[ucs_engine.py]"]
  node_bayesian["Risk assessment<br/>[bayesian_engine.py]"]
  node_coordination["Decision coordination"]
end

subgraph group_persistence["Persistence"]
  node_db_session["Database sessions<br/>[connection.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[connection.py]")]
end

subgraph group_contracts["API contracts"]
  node_organ_schema["Organ contracts<br/>[organ.py]"]
  node_recipient_schema["Recipient contracts<br/>[recipient.py]"]
  node_hospital_schema["Hospital contracts<br/>[hospital.py]"]
  node_matching_schema["Match contract<br/>[matching.py]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_application
node_application -->|"registers routes"| node_organ_routes
node_application -->|"registers routes"| node_recipient_routes
node_application -->|"registers routes"| node_hospital_routes
node_application -->|"registers routes"| node_matching_routes
node_application -->|"registers routes"| node_transport_routes
node_organ_routes -->|"validates data"| node_organ_schema
node_recipient_routes -->|"validates data"| node_recipient_schema
node_hospital_routes -->|"validates data"| node_hospital_schema
node_matching_routes -->|"shapes response"| node_matching_schema
node_organ_routes -->|"queries records"| node_db_session
node_recipient_routes -->|"queries records"| node_db_session
node_hospital_routes -->|"queries records"| node_db_session
node_matching_routes -->|"queries and saves"| node_db_session
node_transport_routes -->|"queries and saves"| node_db_session
node_db_session -->|"opens sessions"| node_sqlite
node_models -->|"uses base"| node_db_session
node_organ_routes -->|"uses records"| node_models
node_recipient_routes -->|"uses records"| node_models
node_hospital_routes -->|"uses records"| node_models
node_matching_routes -->|"uses records"| node_models
node_transport_routes -->|"uses records"| node_models
node_matching_routes -->|"checks eligibility"| node_knowledge
node_matching_routes -->|"finds assignment"| node_csp
node_knowledge -->|"checks blood groups"| node_csp
node_transport_routes -->|"searches routes"| node_astar
node_transport_routes -->|"searches routes"| node_ucs
node_transport_routes -->|"estimates risk"| node_bayesian
node_transport_routes -->|"coordinates decision"| node_coordination

click node_application "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/main.py"
click node_organ_routes "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/organ_routes.py"
click node_recipient_routes "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/recipient_routes.py"
click node_hospital_routes "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/hospital_routes.py"
click node_matching_routes "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/matching_routes.py"
click node_transport_routes "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/transport_routes.py"
click node_knowledge "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/knowledge_engine.py"
click node_csp "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/csp_engine.py"
click node_astar "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/astar_engine.py"
click node_ucs "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/ucs_engine.py"
click node_bayesian "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/bayesian_engine.py"
click node_coordination "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/coordination_agent.py"
click node_db_session "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/connection.py"
click node_models "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/models.py"
click node_sqlite "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/connection.py"
click node_organ_schema "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/organ.py"
click node_recipient_schema "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/recipient.py"
click node_hospital_schema "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/hospital.py"
click node_matching_schema "https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/matching.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_application,node_organ_routes,node_recipient_routes,node_hospital_routes,node_matching_routes,node_transport_routes,node_client toneBlue
class node_knowledge,node_csp,node_astar,node_ucs,node_bayesian,node_coordination toneAmber
class node_db_session,node_models,node_sqlite toneMint
class node_organ_schema,node_recipient_schema,node_hospital_schema,node_matching_schema toneRose
```

## Components

### API workflows

- [FastAPI application](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/main.py): `backend/app/main.py`
- [Organ registry](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/organ_routes.py): `backend/app/routes/organ_routes.py`
- [Recipient registry](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/recipient_routes.py): `backend/app/routes/recipient_routes.py`
- [Hospital registry](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/hospital_routes.py): `backend/app/routes/hospital_routes.py`
- [Match workflow](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/matching_routes.py): `backend/app/routes/matching_routes.py`
- [Transport planning](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/routes/transport_routes.py): `backend/app/routes/transport_routes.py`

### Decision engines

- [Eligibility rules](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/knowledge_engine.py): `backend/app/ai_engines/knowledge_engine.py`
- [CSP matching](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/csp_engine.py): `backend/app/ai_engines/csp_engine.py`
- [A* routing](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/astar_engine.py): `backend/app/ai_engines/astar_engine.py`
- [Uniform-cost routing](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/ucs_engine.py): `backend/app/ai_engines/ucs_engine.py`
- [Risk assessment](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/bayesian_engine.py): `backend/app/ai_engines/bayesian_engine.py`
- [Decision coordination](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/ai_engines/coordination_agent.py): `backend/app/ai_engines/coordination_agent.py`

### Persistence

- [Database sessions](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/connection.py): `backend/app/db/connection.py`
- [Domain records](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/models.py): `backend/app/db/models.py`
- [SQLite database](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/db/connection.py): `backend/app/db/connection.py`

### API contracts

- [Organ contracts](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/organ.py): `backend/app/schemas/organ.py`
- [Recipient contracts](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/recipient.py): `backend/app/schemas/recipient.py`
- [Hospital contracts](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/hospital.py): `backend/app/schemas/hospital.py`
- [Match contract](https://github.com/harshiniudayakumar/intellitransplant/blob/main/backend/app/schemas/matching.py): `backend/app/schemas/matching.py`

### Other components

- **API client**

## Connections

- API client → FastAPI application: sends requests
- FastAPI application → Organ registry: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Recipient registry: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Hospital registry: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Match workflow: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Transport planning: registers routes (evidence: `backend/app/main.py`)
- Organ registry → Organ contracts: validates data (evidence: `backend/app/routes/organ_routes.py`)
- Recipient registry → Recipient contracts: validates data (evidence: `backend/app/routes/recipient_routes.py`)
- Hospital registry → Hospital contracts: validates data (evidence: `backend/app/routes/hospital_routes.py`)
- Match workflow → Match contract: shapes response (evidence: `backend/app/routes/matching_routes.py`)
- Organ registry → Database sessions: queries records (evidence: `backend/app/routes/organ_routes.py`)
- Recipient registry → Database sessions: queries records (evidence: `backend/app/routes/recipient_routes.py`)
- Hospital registry → Database sessions: queries records (evidence: `backend/app/routes/hospital_routes.py`)
- Match workflow → Database sessions: queries and saves (evidence: `backend/app/routes/matching_routes.py`)
- Transport planning → Database sessions: queries and saves (evidence: `backend/app/routes/transport_routes.py`)
- Database sessions → SQLite database: opens sessions (evidence: `backend/app/db/connection.py`)
- Domain records → Database sessions: uses base (evidence: `backend/app/db/models.py`)
- Organ registry → Domain records: uses records (evidence: `backend/app/routes/organ_routes.py`)
- Recipient registry → Domain records: uses records (evidence: `backend/app/routes/recipient_routes.py`)
- Hospital registry → Domain records: uses records (evidence: `backend/app/routes/hospital_routes.py`)
- Match workflow → Domain records: uses records (evidence: `backend/app/routes/matching_routes.py`)
- Transport planning → Domain records: uses records (evidence: `backend/app/routes/transport_routes.py`)
- Match workflow → Eligibility rules: checks eligibility (evidence: `backend/app/routes/matching_routes.py`)
- Match workflow → CSP matching: finds assignment (evidence: `backend/app/routes/matching_routes.py`)
- Eligibility rules → CSP matching: checks blood groups (evidence: `backend/app/ai_engines/knowledge_engine.py`)
- Transport planning → A* routing: searches routes (evidence: `backend/app/routes/transport_routes.py`)
- Transport planning → Uniform-cost routing: searches routes (evidence: `backend/app/routes/transport_routes.py`)
- Transport planning → Risk assessment: estimates risk (evidence: `backend/app/routes/transport_routes.py`)
- Transport planning → Decision coordination: coordinates decision (evidence: `backend/app/routes/transport_routes.py`)
