diff --git a/architecture/workspace/dynamic-inventory-to-production.puml b/architecture/workspace/dynamic-inventory-to-production.puml new file mode 100644 index 0000000..854cdbd --- /dev/null +++ b/architecture/workspace/dynamic-inventory-to-production.puml @@ -0,0 +1,32 @@ +@startuml +!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Dynamic.puml + +title Inventory to Production Workflow - Dynamic Diagram + +Person(staff, "Operations Staff") +Person(owner, "Business Owner") + +System(system, "Kell Creations Platform", "Unified business applications and shared services") + +Container(inventory, "Inventory Application", "Business Application", "Tracks material and finished goods availability") +Container(mrp, "Craft Manufacturing / MRP", "Business Application", "Creates work orders and manages production planning") +Container(datarepo, "Shared Data Repository", "Shared Service", "Stores shared product, BOM, and inventory reference data") +Container(api, "API Orchestrator", "Integration Service", "Coordinates workflow and application events") +Container(notify, "Notification Service", "Messaging Service", "Sends shortage, readiness, and exception notifications") +Container(audit, "Audit & Logging Service", "Observability Service", "Captures inventory, production, and workflow events") + +Rel(staff, inventory, "Reviews stock and material availability in") +Rel(staff, mrp, "Creates and manages production demand in") +Rel(owner, mrp, "Reviews readiness and production priorities in") + +Rel(mrp, datarepo, "Reads BOM and production reference data from") +Rel(mrp, inventory, "Requests material allocation and availability check from") +Rel(inventory, mrp, "Returns stock and shortage status to") +Rel(mrp, api, "Publishes work-order and production demand event through") +Rel(mrp, inventory, "Consumes allocated materials and updates finished goods status in") +Rel(api, notify, "Triggers shortage, exception, or readiness notifications through") +Rel(api, audit, "Logs workflow events to") +Rel(inventory, audit, "Logs stock movement and material consumption events to") +Rel(mrp, audit, "Logs work-order and production events to") + +@enduml \ No newline at end of file diff --git a/docs/architecture/dynamic/inventory-to-production.md b/docs/architecture/dynamic/inventory-to-production.md new file mode 100644 index 0000000..bb6da12 --- /dev/null +++ b/docs/architecture/dynamic/inventory-to-production.md @@ -0,0 +1,32 @@ +# Inventory-to-Production Workflow + +This diagram shows the dynamic workflow used to evaluate inventory availability, initiate production demand, allocate materials, execute work orders, and record readiness updates across the Kell Creations platform. + +## Purpose + +This view explains how inventory management, manufacturing / MRP, shared data, API orchestration, notifications, and audit logging work together to move from material availability to production execution and finished-goods readiness. + +## Diagram Source + +The source for this diagram is maintained as architecture code in: + +`architecture/workspace/dynamic-inventory-to-production.puml` + +## Diagram + +![Inventory-to-Production Workflow](../../images/dynamic-inventory-to-production.svg) + +## Included Workflow Participants + +- Operations Staff +- Business Owner +- Inventory Application +- Craft Manufacturing / MRP +- Shared Data Repository +- API Orchestrator +- Notification Service +- Audit & Logging Service + +## Notes + +This dynamic workflow establishes the operational pattern that connects inventory availability to production execution in the Kell Creations platform. Future refinements should distinguish between normal material allocation, shortage handling, work-order prioritization, make-to-stock versus make-to-order logic, and finished-goods readiness transitions. \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index ed2d6a8..e2187ea 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -54,6 +54,7 @@ nav: - Order to Fulfillment: "architecture/dynamic/order-to-fulfillment.md" - Product Publishing Workflow: "architecture/dynamic/product-publishing.md" - Social Campaign Publishing Workflow: "architecture/dynamic/social-campaign-publishing.md" + - Inventory-to-Production Workflow: "architecture/dynamic/inventory-to-production.md" - Decisions: - ADR Index: "architecture/decisions/index.md" - Policies: