How edgar-mendonca/datum-plan works
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: doc.rs Plan document · api.ts Desktop API · model.rs Project model · main.tsx Plan workspace
Components 23
Desktop experience
- Plan workspace
ui/src/main.tsx - View state
ui/src/store.ts - Desktop API
ui/src/api.ts - Tauri shell
src-tauri/src/main.rs
Plan engine
- Plan document
crates/core/src/doc.rs - Project model
crates/core/src/model.rs - Fields and queries
crates/core/src/fields.rs - Work calendars
crates/core/src/cal.rs - Critical path scheduler
crates/core/src/sched.rs - Formula engine
crates/core/src/formula.rs - Plan spreadsheets
crates/core/src/sheet.rs
Project controls
- Plan registers
crates/core/src/contract.rs - Document register
crates/core/src/docreg.rs - Procurement
crates/core/src/procure.rs - Progress control
crates/core/src/progress.rs
Analysis and reporting
- Delay analysis
crates/core/src/delay.rs - Schedule risk
crates/core/src/risk.rs - Reports and dashboards
ui/src/reports.tsx - Spreadsheet UI
ui/src/sheets.tsx
AI and file exchange
- Import and export
crates/core/src/io - AI Link tools
src-tauri/src/ai.rs
Other components
- Planner
- Local AI assistant
Connections 22
- Planner → Plan workspace: edits plans
- Plan workspace → View state: updates views
ui/src/main.tsx - Plan workspace → Desktop API: invokes commands
ui/src/api.ts - Desktop API → Tauri shell: calls Tauri
ui/src/api.ts - Tauri shell → Plan document: dispatches plan operations
- Plan document → Project model: edits plan model
crates/core/src/doc.rs - Project model → Critical path scheduler: schedules tasks
crates/core/src/model.rs - Critical path scheduler → Work calendars: uses work calendars
crates/core/src/sched.rs - Project model → Fields and queries: exposes plan fields
crates/core/src/fields.rs - Project model → Plan spreadsheets: supplies plan data
crates/core/src/sheet.rs - Plan spreadsheets → Formula engine: evaluates formulas
crates/core/src/sheet.rs - Plan document → Plan registers: includes contract data
crates/core/src/doc.rs - Plan document → Document register: includes document register
crates/core/src/doc.rs - Plan document → Procurement: includes procurement data
crates/core/src/doc.rs - Plan document → Progress control: tracks progress
crates/core/src/doc.rs - Plan document → Delay analysis: analyzes delays
crates/core/src/doc.rs - Plan document → Schedule risk: analyzes schedule risk
- Desktop API → Reports and dashboards: supplies report data
ui/src/reports.tsx - Desktop API → Spreadsheet UI: serves sheet commands
ui/src/sheets.tsx - Plan document → Import and export: imports and exports plans
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