# khayaai/neo-lloyds architecture

> Architecture diagram of the GitHub repository khayaai/neo-lloyds, 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/khayaai/neo-lloyds
- Repository: https://github.com/khayaai/neo-lloyds

## Overview

Neo-Lloyds is prototype risk-capital marketplace infrastructure, not an insurer. A broker submits a risk, which is assessed and cleared for underwriting before listing; capital providers express interest and allocations can be bound. Claims then proceed through evidence, coverage and loss review to settlement. Other documented capabilities include graph-based risk analysis, simulation, reinsurance, agent execution, identity/compliance and jurisdiction modules. The graph follows documented workflows and sampled service dependencies; unsampled implementation links are omitted where evidence is unavailable.

Main entry points: [`apps/api/src/marketplace/marketplace.service.ts`](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/marketplace/marketplace.service.ts) (Marketplace), [`apps/api/src/claims/claims.service.ts`](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/claims/claims.service.ts) (Claims), [`apps/api/src/underwriting/underwriting.service.ts`](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/underwriting/underwriting.service.ts) (Underwriting), [`apps/api/src/agent/agent.service.ts`](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/agent/agent.service.ts) (AI agent API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User portals"]
  node_broker["Broker portal"]
  node_capital_portal["Capital portal"]
  node_corporate["Corporate portal"]
  node_claims_admin["Claims admin portal"]
  node_admin["Admin portal"]
end

subgraph group_risk["Risk lifecycle"]
  node_submission["Risk submission"]
  node_graph["Risk graph<br/>[graph.service.ts]"]
  node_scoring_analyst["Scoring and analyst"]
  node_underwriting["Underwriting"]
  node_simulation["Simulation"]
end

subgraph group_capital["Capital and claims"]
  node_marketplace["Marketplace"]
  node_syndication["Syndication"]
  node_capital_ledger["Capital ledger<br/>[capital-ledger.ts]"]
  node_claims["Claims<br/>[claims.service.ts]"]
  node_settlement["Settlement"]
  node_reinsurance["Reinsurance"]
end

subgraph group_platform["Platform services"]
  node_agent["AI agent API<br/>[agent.service.ts]"]
  node_identity_compliance["Identity and compliance"]
  node_jurisdictions["Jurisdiction modules<br/>[jurisdiction.ts]"]
end

subgraph group_internal["Internal layers"]
  node_domain["Domain rules"]
  node_persistence["Persistence ports<br/>[ports.ts]"]
  node_audit["Audit service<br/>[audit.service.ts]"]
end

node_broker_user(("Broker"))
node_capital_user(("Capital provider"))
node_corporate_user(("Corporate user"))
node_claims_user(("Claims administrator"))
node_admin_user(("Administrator"))

node_broker_user -->|"uses"| node_broker
node_capital_user -->|"uses"| node_capital_portal
node_corporate_user -->|"uses"| node_corporate
node_claims_user -->|"uses"| node_claims_admin
node_admin_user -->|"uses"| node_admin
node_broker -->|"submits risks"| node_submission
node_submission -.->|"records risk"| node_graph
node_broker -->|"requests assessment"| node_scoring_analyst
node_scoring_analyst -->|"informs clearance"| node_underwriting
node_broker -->|"requests clearance"| node_underwriting
node_broker -->|"lists risk"| node_marketplace
node_capital_portal -->|"browses and signals interest"| node_marketplace
node_marketplace -->|"checks clearance"| node_underwriting
node_marketplace -->|"enables allocations"| node_syndication
node_syndication -->|"updates capital"| node_capital_ledger
node_corporate -->|"reports claims and evidence"| node_claims
node_claims_admin -->|"processes claims"| node_claims
node_claims -->|"settles approved claims"| node_settlement
node_graph -->|"supports scenarios"| node_simulation
node_reinsurance -.->|"splits loss"| node_claims
node_agent -->|"delegates workflow"| node_submission
node_agent -->|"delegates assessment"| node_scoring_analyst
node_agent -->|"delegates approval"| node_underwriting
node_agent -->|"delegates execution"| node_marketplace
node_agent -->|"delegates settlement"| node_settlement
node_admin -->|"manages organisations"| node_identity_compliance
node_admin -->|"browses rules"| node_jurisdictions
node_identity_compliance -.->|"uses jurisdiction rules"| node_jurisdictions
node_submission -.->|"uses rules"| node_domain
node_underwriting -->|"assesses risk"| node_domain
node_claims -->|"applies claim rules"| node_domain
node_graph -->|"uses repositories"| node_persistence
node_underwriting -->|"reads and writes"| node_persistence
node_claims -->|"reads and writes"| node_persistence
node_marketplace -->|"reads and writes"| node_persistence
node_reinsurance -->|"reads and writes"| node_persistence
node_underwriting -->|"records actions"| node_audit
node_claims -->|"records actions"| node_audit
node_marketplace -->|"records actions"| node_audit
node_reinsurance -->|"records actions"| node_audit
node_audit -->|"appends records"| node_persistence

click node_broker "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/broker-portal"
click node_capital_portal "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/capital-portal"
click node_corporate "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/corporate-portal"
click node_claims_admin "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/claims-admin-portal"
click node_admin "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/admin-portal"
click node_submission "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/submission"
click node_graph "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/graph/graph.service.ts"
click node_scoring_analyst "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/analyst"
click node_underwriting "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/underwriting/underwriting.service.ts"
click node_marketplace "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/marketplace/marketplace.service.ts"
click node_syndication "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/syndication"
click node_capital_ledger "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/packages/domain/src/capital-ledger.ts"
click node_claims "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/claims/claims.service.ts"
click node_settlement "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/settlement/settlement.service.ts"
click node_simulation "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/simulation"
click node_reinsurance "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/reinsurance/reinsurance.service.ts"
click node_agent "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/agent/agent.service.ts"
click node_identity_compliance "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/identity"
click node_jurisdictions "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/packages/config/src/jurisdiction.ts"
click node_domain "https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/packages/domain/src"
click node_persistence "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/persistence/ports.ts"
click node_audit "https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/common/audit.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_broker,node_capital_portal,node_corporate,node_claims_admin,node_admin,node_corporate_user toneBlue
class node_submission,node_graph,node_scoring_analyst,node_underwriting,node_simulation toneAmber
class node_marketplace,node_syndication,node_capital_ledger,node_claims,node_settlement,node_reinsurance,node_capital_user toneMint
class node_agent,node_identity_compliance,node_jurisdictions toneRose
class node_domain,node_persistence,node_audit,node_broker_user,node_claims_user,node_admin_user toneIndigo
```

## Components

### User portals

- [Broker portal](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/broker-portal): `apps/broker-portal`
- [Capital portal](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/capital-portal): `apps/capital-portal`
- [Corporate portal](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/corporate-portal): `apps/corporate-portal`
- [Claims admin portal](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/claims-admin-portal): `apps/claims-admin-portal`
- [Admin portal](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/admin-portal): `apps/admin-portal`

### Risk lifecycle

- [Risk submission](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/submission): `apps/api/src/submission`
- [Risk graph](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/graph/graph.service.ts): `apps/api/src/graph/graph.service.ts`
- [Scoring and analyst](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/analyst): `apps/api/src/analyst`
- [Underwriting](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/underwriting/underwriting.service.ts): `apps/api/src/underwriting/underwriting.service.ts`
- [Simulation](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/simulation): `apps/api/src/simulation`

### Capital and claims

- [Marketplace](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/marketplace/marketplace.service.ts): `apps/api/src/marketplace/marketplace.service.ts`
- [Syndication](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/syndication): `apps/api/src/syndication`
- [Capital ledger](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/packages/domain/src/capital-ledger.ts): `packages/domain/src/capital-ledger.ts`
- [Claims](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/claims/claims.service.ts): `apps/api/src/claims/claims.service.ts`
- [Settlement](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/settlement/settlement.service.ts): `apps/api/src/settlement/settlement.service.ts`
- [Reinsurance](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/reinsurance/reinsurance.service.ts): `apps/api/src/reinsurance/reinsurance.service.ts`

### Platform services

- [AI agent API](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/agent/agent.service.ts): `apps/api/src/agent/agent.service.ts`
- [Identity and compliance](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/apps/api/src/identity): `apps/api/src/identity`
- [Jurisdiction modules](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/packages/config/src/jurisdiction.ts): `packages/config/src/jurisdiction.ts`

### Internal layers

- [Domain rules](https://github.com/khayaai/neo-lloyds/tree/claude/neo-lloyds-platform-cyr9yo/packages/domain/src): `packages/domain/src`
- [Persistence ports](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/persistence/ports.ts): `apps/api/src/persistence/ports.ts`
- [Audit service](https://github.com/khayaai/neo-lloyds/blob/claude/neo-lloyds-platform-cyr9yo/apps/api/src/common/audit.service.ts): `apps/api/src/common/audit.service.ts`

### Other components

- **Broker**
- **Capital provider**
- **Corporate user**
- **Claims administrator**
- **Administrator**

## Connections

- Broker → Broker portal: uses (evidence: `README.md`)
- Capital provider → Capital portal: uses (evidence: `README.md`)
- Corporate user → Corporate portal: uses (evidence: `README.md`)
- Claims administrator → Claims admin portal: uses (evidence: `README.md`)
- Administrator → Admin portal: uses (evidence: `README.md`)
- Broker portal → Risk submission: submits risks (evidence: `README.md`)
- Risk submission → Risk graph: records risk
- Broker portal → Scoring and analyst: requests assessment (evidence: `README.md`)
- Scoring and analyst → Underwriting: informs clearance (evidence: `README.md`)
- Broker portal → Underwriting: requests clearance (evidence: `README.md`)
- Broker portal → Marketplace: lists risk (evidence: `README.md`)
- Capital portal → Marketplace: browses and signals interest (evidence: `README.md`)
- Marketplace → Underwriting: checks clearance (evidence: `apps/api/src/marketplace/marketplace.service.ts`)
- Marketplace → Syndication: enables allocations (evidence: `README.md`)
- Syndication → Capital ledger: updates capital (evidence: `README.md`)
- Corporate portal → Claims: reports claims and evidence (evidence: `README.md`)
- Claims admin portal → Claims: processes claims (evidence: `README.md`)
- Claims → Settlement: settles approved claims (evidence: `README.md`)
- Risk graph → Simulation: supports scenarios (evidence: `README.md`)
- Reinsurance → Claims: splits loss
- AI agent API → Risk submission: delegates workflow (evidence: `apps/api/src/agent/agent.service.ts`)
- AI agent API → Scoring and analyst: delegates assessment (evidence: `apps/api/src/agent/agent.service.ts`)
- AI agent API → Underwriting: delegates approval (evidence: `apps/api/src/agent/agent.service.ts`)
- AI agent API → Marketplace: delegates execution (evidence: `apps/api/src/agent/agent.service.ts`)
- AI agent API → Settlement: delegates settlement (evidence: `apps/api/src/agent/agent.service.ts`)
- Admin portal → Identity and compliance: manages organisations (evidence: `README.md`)
- Admin portal → Jurisdiction modules: browses rules (evidence: `README.md`)
- Identity and compliance → Jurisdiction modules: uses jurisdiction rules
- Risk submission → Domain rules: uses rules
- Underwriting → Domain rules: assesses risk (evidence: `apps/api/src/underwriting/underwriting.service.ts`)
- Claims → Domain rules: applies claim rules
- Risk graph → Persistence ports: uses repositories (evidence: `apps/api/src/graph/graph.service.ts`)
- Underwriting → Persistence ports: reads and writes (evidence: `apps/api/src/underwriting/underwriting.service.ts`)
- Claims → Persistence ports: reads and writes (evidence: `apps/api/src/claims/claims.service.ts`)
- Marketplace → Persistence ports: reads and writes (evidence: `apps/api/src/marketplace/marketplace.service.ts`)
- Reinsurance → Persistence ports: reads and writes (evidence: `apps/api/src/reinsurance/reinsurance.service.ts`)
- Underwriting → Audit service: records actions (evidence: `apps/api/src/underwriting/underwriting.service.ts`)
- Claims → Audit service: records actions (evidence: `apps/api/src/claims/claims.service.ts`)
- Marketplace → Audit service: records actions (evidence: `apps/api/src/marketplace/marketplace.service.ts`)
- Reinsurance → Audit service: records actions (evidence: `apps/api/src/reinsurance/reinsurance.service.ts`)
- Audit service → Persistence ports: appends records (evidence: `apps/api/src/common/audit.service.ts`)
