Release 1.34 — Development Timeline
Material Management & Supply Chain — Three-Level Supply Chain Model → Procurement Pipeline → Inventory & Operations.
Three phases building on each other, with parallel tracks where possible. Click any row with a spec to expand it inline.
Total Features
11
4 Foundation + 5 Procurement + 2 Operations
Phases
3
Foundation → Procurement → Operations
Est. Duration
56-76 days
End-to-end across all phases
New Prisma Models
12+
ManufacturerProduct, DistributorPrice, PurchaseOrder, PO LineItem, MaterialConsumptionEntry, PriceBookImport, MaterialRequest, MaterialRequestItem, DistributorDiscount, InventoryLocation, InventoryItem, InventoryMovement, PO Receipt, ReceiptLineItem, VendorCredit, VendorCreditLineItem
READY No blockers
BLOCKED Waiting on dependency
▶ = has spec (click to expand)
Critical Path
The longest dependency chain that determines minimum timeline:
MAT-0
Supply Chain
→
MAT-9
Discounts
→
MAT-5
Supplier PO
→
MAT-6
Receiving
→
MAT-7
Inventory
→
MAT-8
Vendor Credits
Backend Infrastructure Sprint
The database models, GraphQL resolvers, and services for all features below are being built in a Backend Sprint that runs in parallel with Release 1.33 WO development. This timeline covers the full feature scope (backend + UI). Click any row to view the spec and implementation plan.
Phase 1
Foundation — Core Data Models
Core data models for supply chain, purchase orders, and daily material consumption. No blocking dependencies — can start immediately after 1.33.
↓
Phase 2
Procurement Pipeline
Bulk pricing import, field-to-office material requests, discount management, supplier purchase orders, and receiving. Depends on Phase 1 foundation models.
↓
Phase 3
Operations — Inventory & Returns
Inventory tracking, stock management, vendor credits and returns. Depends on the procurement pipeline being in place.
Sequencing Rationale
- Supply Chain Model first (MAT-0) because all downstream pricing, PO creation, and receiving depend on the ManufacturerProduct + DistributorPrice data structure.
- Customer PO (MAT-1) parallel with MAT-0 because Supplier POs (MAT-5) share the PurchaseOrder model.
- LEM Consumption (MAT-2a/2b) parallel with MAT-0 because it only depends on the existing material catalog + LEM foundation from 1.33.
- Procurement Pipeline (Phase 2) after foundations because Price Book Import writes to ManufacturerProduct + DistributorPrice, Supplier POs consume them.
- Discount Management (MAT-9) must precede Supplier PO (MAT-5) so PO line items can show effective prices.
- Operations (Phase 3) last because Inventory requires receiving (MAT-6) and Vendor Credits require both POs (MAT-5) and Inventory (MAT-7).
Key Decisions
- Decided: Three-level supply chain model (Material → ManufacturerProduct → DistributorPrice)
- Decided: “Manufacturer” as new Company type (alongside existing Supplier/Customer/Consultant)
- Decided: PurchaseOrder as shared model for Customer PO and Supplier PO (differentiated by
type const)
- Decided: Material consumption costs computed at query time, not stored on entry (mirrors timesheet pattern)
- Decided: Discount resolution cascades — Product-specific overrides Category, Category overrides Global
- Decided: Inventory movements as an append-only ledger (no direct stock edits)
- Decided: All new enum-like values use const-based TypeScript patterns (not Prisma enums)
- Open: Inventory costing method — FIFO vs. weighted average (flagged for spec authoring)
Source Documents
- Release 1.34 Plan:
release_1.34_material_supply_chain_24906d55.plan.md
- Material Management Deep Analysis:
plan/MATERIAL_MANAGEMENT_SUPPLY_CHAIN_DEEP_ANALYSIS.md
- Material Supply Chain Story:
plan/MATERIAL_SUPPLY_CHAIN_STORY.md
- Agent Planning Guidelines:
agent-planning-guidelines.md