# edgar-mendonca/datum-plan architecture

> Architecture diagram of the GitHub repository edgar-mendonca/datum-plan, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edgar-mendonca/datum-plan
- Repository: https://github.com/edgar-mendonca/datum-plan

## Overview

Datum Plan is a private, local desktop application for project planning and control. The main workflow is to edit a plan in the desktop UI, send commands through the Tauri bridge to the Rust engine, schedule and calculate results, then display, report, or export them. Separate product areas cover registers, delay and risk analysis, spreadsheets and dashboards, and AI-assisted plan operations. The README documents these capabilities; some subsystem-to-engine connections are therefore documented rather than verified in sampled implementation excerpts.

Main entry points: [`crates/core/src/doc.rs`](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/doc.rs) (Plan document), [`ui/src/api.ts`](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/api.ts) (Desktop API), [`crates/core/src/model.rs`](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/model.rs) (Project model), [`ui/src/main.tsx`](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/main.tsx) (Plan workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_ui["Plan workspace<br/>[main.tsx]"]
  node_state["View state<br/>[store.ts]"]
  node_api["Desktop API<br/>[api.ts]"]
  node_shell["Tauri shell<br/>[main.rs]"]
end

subgraph group_engine["Plan engine"]
  node_plan[("Plan document<br/>[doc.rs]")]
  node_project["Project model<br/>[model.rs]"]
  node_fields["Fields and queries<br/>[fields.rs]"]
  node_calendar["Work calendars<br/>[cal.rs]"]
  node_scheduler["Critical path scheduler<br/>[sched.rs]"]
  node_formula["Formula engine<br/>[formula.rs]"]
  node_sheets["Plan spreadsheets<br/>[sheet.rs]"]
end

subgraph group_controls["Project controls"]
  node_registers["Plan registers<br/>[contract.rs]"]
  node_documents["Document register<br/>[docreg.rs]"]
  node_procurement["Procurement<br/>[procure.rs]"]
  node_progress["Progress control<br/>[progress.rs]"]
end

subgraph group_insight["Analysis and reporting"]
  node_delay["Delay analysis<br/>[delay.rs]"]
  node_risk["Schedule risk<br/>[risk.rs]"]
  node_reports["Reports and dashboards<br/>[reports.tsx]"]
  node_sheetui["Spreadsheet UI<br/>[sheets.tsx]"]
end

subgraph group_integrations["AI and file exchange"]
  node_exchange["Import and export"]
  node_ai["AI Link tools<br/>[ai.rs]"]
end

node_user(("Planner"))
node_assistant(("Local AI assistant"))

node_user -->|"edits plans"| node_ui
node_ui -->|"updates views"| node_state
node_ui -->|"invokes commands"| node_api
node_api -->|"calls Tauri"| node_shell
node_shell -.->|"dispatches plan operations"| node_plan
node_plan -->|"edits plan model"| node_project
node_project -->|"schedules tasks"| node_scheduler
node_scheduler -->|"uses work calendars"| node_calendar
node_project -->|"exposes plan fields"| node_fields
node_project -->|"supplies plan data"| node_sheets
node_sheets -->|"evaluates formulas"| node_formula
node_plan -->|"includes contract data"| node_registers
node_plan -->|"includes document register"| node_documents
node_plan -->|"includes procurement data"| node_procurement
node_plan -->|"tracks progress"| node_progress
node_plan -->|"analyzes delays"| node_delay
node_plan -->|"analyzes schedule risk"| node_risk
node_api -->|"supplies report data"| node_reports
node_api -->|"serves sheet commands"| node_sheetui
node_plan -->|"imports and exports plans"| node_exchange
node_assistant -->|"connects over local MCP"| node_ai
node_ai -->|"reads and changes plans"| node_plan

click node_ui "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/main.tsx"
click node_state "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/store.ts"
click node_api "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/api.ts"
click node_shell "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/src-tauri/src/main.rs"
click node_plan "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/doc.rs"
click node_project "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/model.rs"
click node_fields "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/fields.rs"
click node_calendar "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/cal.rs"
click node_scheduler "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/sched.rs"
click node_formula "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/formula.rs"
click node_sheets "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/sheet.rs"
click node_registers "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/contract.rs"
click node_documents "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/docreg.rs"
click node_procurement "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/procure.rs"
click node_progress "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/progress.rs"
click node_delay "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/delay.rs"
click node_risk "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/risk.rs"
click node_reports "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/reports.tsx"
click node_sheetui "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/sheets.tsx"
click node_exchange "https://github.com/edgar-mendonca/datum-plan/tree/claude/fervent-keller-ddas5s/crates/core/src/io"
click node_ai "https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/src-tauri/src/ai.rs"

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_ui,node_state,node_api,node_shell toneBlue
class node_plan,node_project,node_fields,node_calendar,node_scheduler,node_formula,node_sheets toneAmber
class node_registers,node_documents,node_procurement,node_progress toneMint
class node_delay,node_risk,node_reports,node_sheetui toneRose
class node_exchange,node_ai,node_user,node_assistant toneIndigo
```

## Components

### Desktop experience

- [Plan workspace](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/main.tsx): `ui/src/main.tsx`
- [View state](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/store.ts): `ui/src/store.ts`
- [Desktop API](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/api.ts): `ui/src/api.ts`
- [Tauri shell](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/src-tauri/src/main.rs): `src-tauri/src/main.rs`

### Plan engine

- [Plan document](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/doc.rs): `crates/core/src/doc.rs`
- [Project model](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/model.rs): `crates/core/src/model.rs`
- [Fields and queries](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/fields.rs): `crates/core/src/fields.rs`
- [Work calendars](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/cal.rs): `crates/core/src/cal.rs`
- [Critical path scheduler](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/sched.rs): `crates/core/src/sched.rs`
- [Formula engine](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/formula.rs): `crates/core/src/formula.rs`
- [Plan spreadsheets](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/sheet.rs): `crates/core/src/sheet.rs`

### Project controls

- [Plan registers](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/contract.rs): `crates/core/src/contract.rs`
- [Document register](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/docreg.rs): `crates/core/src/docreg.rs`
- [Procurement](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/procure.rs): `crates/core/src/procure.rs`
- [Progress control](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/progress.rs): `crates/core/src/progress.rs`

### Analysis and reporting

- [Delay analysis](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/delay.rs): `crates/core/src/delay.rs`
- [Schedule risk](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/crates/core/src/risk.rs): `crates/core/src/risk.rs`
- [Reports and dashboards](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/reports.tsx): `ui/src/reports.tsx`
- [Spreadsheet UI](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/ui/src/sheets.tsx): `ui/src/sheets.tsx`

### AI and file exchange

- [Import and export](https://github.com/edgar-mendonca/datum-plan/tree/claude/fervent-keller-ddas5s/crates/core/src/io): `crates/core/src/io`
- [AI Link tools](https://github.com/edgar-mendonca/datum-plan/blob/claude/fervent-keller-ddas5s/src-tauri/src/ai.rs): `src-tauri/src/ai.rs`

### Other components

- **Planner**
- **Local AI assistant**

## Connections

- Planner → Plan workspace: edits plans
- Plan workspace → View state: updates views (evidence: `ui/src/main.tsx`)
- Plan workspace → Desktop API: invokes commands (evidence: `ui/src/api.ts`)
- Desktop API → Tauri shell: calls Tauri (evidence: `ui/src/api.ts`)
- Tauri shell → Plan document: dispatches plan operations
- Plan document → Project model: edits plan model (evidence: `crates/core/src/doc.rs`)
- Project model → Critical path scheduler: schedules tasks (evidence: `crates/core/src/model.rs`)
- Critical path scheduler → Work calendars: uses work calendars (evidence: `crates/core/src/sched.rs`)
- Project model → Fields and queries: exposes plan fields (evidence: `crates/core/src/fields.rs`)
- Project model → Plan spreadsheets: supplies plan data (evidence: `crates/core/src/sheet.rs`)
- Plan spreadsheets → Formula engine: evaluates formulas (evidence: `crates/core/src/sheet.rs`)
- Plan document → Plan registers: includes contract data (evidence: `crates/core/src/doc.rs`)
- Plan document → Document register: includes document register (evidence: `crates/core/src/doc.rs`)
- Plan document → Procurement: includes procurement data (evidence: `crates/core/src/doc.rs`)
- Plan document → Progress control: tracks progress (evidence: `crates/core/src/doc.rs`)
- Plan document → Delay analysis: analyzes delays (evidence: `crates/core/src/doc.rs`)
- Plan document → Schedule risk: analyzes schedule risk
- Desktop API → Reports and dashboards: supplies report data (evidence: `ui/src/reports.tsx`)
- Desktop API → Spreadsheet UI: serves sheet commands (evidence: `ui/src/sheets.tsx`)
- Plan document → Import and export: imports and exports plans (evidence: `crates/core/src/io/table.rs`)
- Local AI assistant → AI Link tools: connects over local MCP
- AI Link tools → Plan document: reads and changes plans
