# lemmalegalconsulting/haddendraft architecture

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

- Interactive diagram: https://gitdiagram.com/lemmalegalconsulting/haddendraft
- Repository: https://github.com/lemmalegalconsulting/haddendraft

## Overview

Legal Drafting Tool is a Django + React housing-court drafting workspace with research, template-based drafting, and drafting-from-scratch modes. Users select a matter, gather case materials and legal authorities, review structured drafting inputs, generate or fill a document, validate it, and export it. Research is a separate deterministic search capability; optional AI augments drafting and case chat. The graph reflects documented capabilities and indexed references; several subsystem connections are described by the README rather than sampled implementation excerpts.

Main entry points: [`backend/apps/drafting/services.py`](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/drafting/services.py) (Drafting Services), [`frontend/src/App.jsx`](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/App.jsx) (Drafting Workspace), [`backend/apps/sources/connectors/legalserver.py`](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/connectors/legalserver.py) (LegalServer Connector), [`frontend/src/api/client.js`](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/api/client.js) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace"]
  node_workspace_ui["Drafting Workspace<br/>[App.jsx]"]
  node_api_client["API Client<br/>[client.js]"]
end

subgraph group_matter_sources["Matter Sources"]
  node_matter_records[("Matter Records<br/>[models.py]")]
  node_case_materials["Case Materials"]
  node_legalserver_connector["LegalServer Connector<br/>[legalserver.py]"]
  node_source_registry["Source Registry<br/>[registry.py]"]
end

subgraph group_research["Legal Research"]
  node_research_engine["Research Search<br/>[engine.py]"]
  node_source_selection["Source Selection<br/>[selection.py]"]
  node_source_augmentation["Search Augmentation<br/>[augmentation.py]"]
end

subgraph group_drafting["Drafting and Review"]
  node_draft_services["Drafting Services<br/>[services.py]"]
  node_template_workflow["Template Workflow"]
  node_fact_review["Fact Review<br/>[FactReview.jsx]"]
  node_ai_services["AI Services<br/>[services.py]"]
  node_case_chat["Case Chat<br/>[case_chat.py]"]
  node_validation["Document Validation<br/>[services.py]"]
  node_exporting["Document Export<br/>[services.py]"]
end

subgraph group_platform["Integrations and Storage"]
  node_openai_client["OpenAI Client<br/>[openai_client.py]"]
  node_document_storage[("Document Storage<br/>[storage.py]")]
  node_caselaw_storage[("Case-law Artifacts<br/>[storage.py]")]
end

node_advocate(("Advocate"))
node_legalserver["LegalServer"]

node_advocate -->|"uses"| node_workspace_ui
node_workspace_ui -->|"requests"| node_api_client
node_api_client -.->|"calls API"| node_draft_services
node_workspace_ui -->|"shows"| node_case_materials
node_case_materials -.->|"supports review"| node_fact_review
node_legalserver_connector -->|"fetches matters"| node_legalserver
node_legalserver_connector -->|"uses matter services"| node_matter_records
node_source_registry -->|"registers"| node_legalserver_connector
node_source_selection -.->|"provides sources"| node_research_engine
node_source_augmentation -->|"selects sources"| node_source_selection
node_workspace_ui -.->|"searches authorities"| node_research_engine
node_workspace_ui -.->|"starts drafting"| node_draft_services
node_draft_services -->|"calls"| node_ai_services
node_draft_services -->|"reads matter"| node_matter_records
node_draft_services -->|"uses questions"| node_template_workflow
node_draft_services -.->|"validates draft"| node_validation
node_validation -->|"uses export services"| node_exporting
node_case_chat -->|"calls"| node_openai_client
node_ai_services -->|"calls"| node_openai_client
node_caselaw_storage -->|"uses shared store"| node_document_storage

click node_workspace_ui "https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/App.jsx"
click node_api_client "https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/api/client.js"
click node_matter_records "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/matters/models.py"
click node_case_materials "https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/components/CaseMaterialsPanel.jsx"
click node_legalserver_connector "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/connectors/legalserver.py"
click node_source_registry "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/registry.py"
click node_research_engine "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/research/engine.py"
click node_source_selection "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/selection.py"
click node_source_augmentation "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/augmentation.py"
click node_draft_services "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/drafting/services.py"
click node_template_workflow "https://github.com/lemmalegalconsulting/haddendraft/tree/main/backend/apps/templates_app"
click node_fact_review "https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/components/FactReview.jsx"
click node_ai_services "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/services.py"
click node_case_chat "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/case_chat.py"
click node_openai_client "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/openai_client.py"
click node_validation "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/validation/services.py"
click node_exporting "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/exporting/services.py"
click node_document_storage "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/core/storage.py"
click node_caselaw_storage "https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/caselaw/storage.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_workspace_ui,node_api_client toneBlue
class node_matter_records,node_case_materials,node_legalserver_connector,node_source_registry toneAmber
class node_research_engine,node_source_selection,node_source_augmentation,node_legalserver toneMint
class node_draft_services,node_template_workflow,node_fact_review,node_ai_services,node_case_chat,node_validation,node_exporting toneRose
class node_openai_client,node_document_storage,node_caselaw_storage,node_advocate toneIndigo
```

## Components

### Workspace

- [Drafting Workspace](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API Client](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Matter Sources

- [Matter Records](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/matters/models.py): `backend/apps/matters/models.py`
- [Case Materials](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/components/CaseMaterialsPanel.jsx): `frontend/src/components/CaseMaterialsPanel.jsx`
- [LegalServer Connector](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/connectors/legalserver.py): `backend/apps/sources/connectors/legalserver.py`
- [Source Registry](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/registry.py): `backend/apps/sources/registry.py`

### Legal Research

- [Research Search](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/research/engine.py): `backend/apps/sources/research/engine.py`
- [Source Selection](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/selection.py): `backend/apps/sources/selection.py`
- [Search Augmentation](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/sources/augmentation.py): `backend/apps/sources/augmentation.py`

### Drafting and Review

- [Drafting Services](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/drafting/services.py): `backend/apps/drafting/services.py`
- [Template Workflow](https://github.com/lemmalegalconsulting/haddendraft/tree/main/backend/apps/templates_app): `backend/apps/templates_app`
- [Fact Review](https://github.com/lemmalegalconsulting/haddendraft/blob/main/frontend/src/components/FactReview.jsx): `frontend/src/components/FactReview.jsx`
- [AI Services](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/services.py): `backend/apps/ai/services.py`
- [Case Chat](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/case_chat.py): `backend/apps/ai/case_chat.py`
- [Document Validation](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/validation/services.py): `backend/apps/validation/services.py`
- [Document Export](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/exporting/services.py): `backend/apps/exporting/services.py`

### Integrations and Storage

- [OpenAI Client](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/ai/openai_client.py): `backend/apps/ai/openai_client.py`
- [Document Storage](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/core/storage.py): `backend/apps/core/storage.py`
- [Case-law Artifacts](https://github.com/lemmalegalconsulting/haddendraft/blob/main/backend/apps/caselaw/storage.py): `backend/apps/caselaw/storage.py`

### Other components

- **Advocate**
- **LegalServer**

## Connections

- Advocate → Drafting Workspace: uses (evidence: `README.md`)
- Drafting Workspace → API Client: requests (evidence: `frontend/src/App.jsx`)
- API Client → Drafting Services: calls API
- Drafting Workspace → Case Materials: shows (evidence: `frontend/src/App.jsx`)
- Case Materials → Fact Review: supports review
- LegalServer Connector → LegalServer: fetches matters (evidence: `backend/apps/sources/connectors/legalserver.py`)
- LegalServer Connector → Matter Records: uses matter services (evidence: `backend/apps/sources/connectors/legalserver.py`)
- Source Registry → LegalServer Connector: registers (evidence: `backend/apps/sources/registry.py`)
- Source Selection → Research Search: provides sources
- Search Augmentation → Source Selection: selects sources (evidence: `backend/apps/sources/augmentation.py`)
- Drafting Workspace → Research Search: searches authorities
- Drafting Workspace → Drafting Services: starts drafting
- Drafting Services → AI Services: calls (evidence: `backend/apps/drafting/services.py`)
- Drafting Services → Matter Records: reads matter (evidence: `backend/apps/drafting/services.py`)
- Drafting Services → Template Workflow: uses questions (evidence: `backend/apps/drafting/services.py`)
- Drafting Services → Document Validation: validates draft
- Document Validation → Document Export: uses export services (evidence: `backend/apps/validation/services.py`)
- Case Chat → OpenAI Client: calls (evidence: `backend/apps/ai/case_chat.py`)
- AI Services → OpenAI Client: calls (evidence: `backend/apps/ai/services.py`)
- Case-law Artifacts → Document Storage: uses shared store (evidence: `backend/apps/caselaw/storage.py`)
