# Traceability Index This index provides a structured mapping between Kell Creations business domains, architecture views, dynamic workflows, and controlled governance documents. ## Purpose The purpose of this index is to: - connect business domains to architecture artifacts - show which enterprise views support which applications - show which workflows are documented - link governance documents to the platform areas they control - identify coverage gaps for future documentation ## How to Use This Index Use this page to answer questions such as: - Which architecture views apply to a given business domain? - Which workflows have been documented for a given application? - Which policies govern a given platform capability? - What major architecture or governance gaps still need documentation? --- ## 1. Enterprise Architecture Traceability | Enterprise View | File | Supports Domains | | --------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | System Landscape | `docs/architecture/system-landscape.md` | All domains | | Platform Context | `docs/architecture/context/platform.md` | All domains | | Platform Containers | `docs/architecture/containers/platform-containers.md` | All domains | | Enterprise Shared Services | `docs/architecture/containers/enterprise-services.md` | All domains | | Enterprise Data Architecture | `docs/architecture/containers/enterprise-data-architecture.md` | Inventory, MRP, WordPress, Social Media, Financial Analysis, Policy Repository | | Enterprise Identity & Access Architecture | `docs/architecture/containers/enterprise-identity-access-architecture.md` | All application and governance domains | | Enterprise Integration & Orchestration Architecture | `docs/architecture/containers/enterprise-integration-orchestration-architecture.md` | WordPress, Social Media, MRP, Inventory, Financial Analysis, Policy Repository | | Enterprise Audit, Logging & Compliance Architecture | `docs/architecture/containers/enterprise-audit-logging-compliance-architecture.md` | All application and governance domains | | Deployment Architecture | `docs/architecture/deployment/production.md` | All domains | --- ## 2. Application Component Traceability | Application Domain | Component View | File | Related Enterprise Views | | ------------------------- | ------------------------------------ | --------------------------------------------------------- | ------------------------------------------------------------ | | Inventory | Inventory Components | `docs/architecture/components/inventory.md` | Shared Services, Data, Identity & Access, Audit, Integration | | Craft Manufacturing / MRP | Craft Manufacturing / MRP Components | `docs/architecture/components/mrp.md` | Shared Services, Data, Identity & Access, Audit, Integration | | WordPress Management | WordPress Management Components | `docs/architecture/components/wordpress-management.md` | Shared Services, Data, Identity & Access, Integration, Audit | | Social Media Management | Social Media Management Components | `docs/architecture/components/social-media-management.md` | Shared Services, Data, Identity & Access, Integration, Audit | | Financial Analysis | Financial Analysis Components | `docs/architecture/components/financial-analysis.md` | Shared Services, Data, Identity & Access, Audit | --- ## 3. Dynamic Workflow Traceability | Workflow | File | Primary Domains | Related Component Views | | --------------------------------------- | --------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------ | | Order to Fulfillment | `docs/architecture/dynamic/order-to-fulfillment.md` | WordPress, Inventory, MRP, Financial Analysis | Inventory, MRP, WordPress, Financial Analysis | | Product Publishing Workflow | `docs/architecture/dynamic/product-publishing.md` | WordPress Management, Shared Data | WordPress Management | | Social Campaign Publishing Workflow | `docs/architecture/dynamic/social-campaign-publishing.md` | Social Media Management, Integration | Social Media Management | | Inventory-to-Production Workflow | `docs/architecture/dynamic/inventory-to-production.md` | Inventory, MRP | Inventory, MRP | | Policy Approval and Retirement Workflow | `docs/architecture/dynamic/policy-approval-retirement.md` | Governance, Policy Repository | Enterprise Audit, Identity & Access, Policy Repository | --- ## 4. Governance Document Traceability | Governance Document | File | Governs Domains | Related Workflows / Views | | -------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------ | | Document Control Policy | `docs/policies/governance/KC-POL-GOV-001-document-control-policy.md` | Governance, Policy Repository | Policy Approval and Retirement Workflow, Audit & Compliance Architecture | | Policy Review and Retirement Procedure | `docs/policies/governance/KC-PRO-GOV-001-policy-review-and-retirement-procedure.md` | Governance, Policy Repository | Policy Approval and Retirement Workflow, Audit & Compliance Architecture | --- ## 5. Domain-to-Artifact Mapping ### Inventory - Component View: - `docs/architecture/components/inventory.md` - Dynamic Workflows: - `docs/architecture/dynamic/order-to-fulfillment.md` - `docs/architecture/dynamic/inventory-to-production.md` - Related Enterprise Views: - Shared Services - Data Architecture - Identity & Access - Audit & Compliance - Integration & Orchestration ### Craft Manufacturing / MRP - Component View: - `docs/architecture/components/mrp.md` - Dynamic Workflows: - `docs/architecture/dynamic/order-to-fulfillment.md` - `docs/architecture/dynamic/inventory-to-production.md` - Related Enterprise Views: - Shared Services - Data Architecture - Identity & Access - Audit & Compliance - Integration & Orchestration ### WordPress Management - Component View: - `docs/architecture/components/wordpress-management.md` - Dynamic Workflows: - `docs/architecture/dynamic/order-to-fulfillment.md` - `docs/architecture/dynamic/product-publishing.md` - Related Enterprise Views: - Shared Services - Data Architecture - Identity & Access - Integration & Orchestration - Audit & Compliance - Deployment ### Social Media Management - Component View: - `docs/architecture/components/social-media-management.md` - Dynamic Workflows: - `docs/architecture/dynamic/social-campaign-publishing.md` - Related Enterprise Views: - Shared Services - Data Architecture - Identity & Access - Integration & Orchestration - Audit & Compliance ### Financial Analysis - Component View: - `docs/architecture/components/financial-analysis.md` - Dynamic Workflows: - `docs/architecture/dynamic/order-to-fulfillment.md` - Related Enterprise Views: - Shared Services - Data Architecture - Identity & Access - Audit & Compliance ### Governance / Policy Repository - Governance Documents: - `docs/policies/governance/KC-POL-GOV-001-document-control-policy.md` - `docs/policies/governance/KC-PRO-GOV-001-policy-review-and-retirement-procedure.md` - Dynamic Workflows: - `docs/architecture/dynamic/policy-approval-retirement.md` - Related Enterprise Views: - Shared Services - Identity & Access - Audit & Compliance - Deployment --- ## 6. Current Coverage Gaps The following areas are strong candidates for future documentation: !!! info "Last analyzed: 2026-05-22" ### Additional component views - Policy Repository internal components - Notification Service internal components - API Orchestrator internal components - Shared Data Repository internal components - Documentation Platform internal components (MkDocs, PlantUML server, Forgejo runners) ### Additional dynamic workflows - Financial close / reporting workflow - Website change management workflow - Exception handling workflow - Marketing campaign analytics workflow - Product image / media synchronization workflow - Local development setup workflow - Incident response workflow ### Additional governance documents - Access Control Policy - Social Media Publishing Standard - Product Publishing Procedure - Work Order Management Procedure - Inventory Adjustment Procedure - Financial Record Retention Policy - Website Change Management Procedure - Exception Management Standard ### Architecture decisions - No formal ADRs exist; 7 candidate ADRs identified — see [ADR Index](decisions/index.md) ### Standards documents - No formal standards documents exist; 10 candidate standards identified — see [Standards Overview](../standards/index.md) ### Operational procedures - No operational runbooks exist; 5 candidate procedures identified — see [Operations Overview](../operations/index.md) ### Integration documentation - Only WooCommerce integration is implemented; 5 additional integrations architecturally defined — see [Integrations Overview](../integrations/index.md) ### Documentation quality issues - Enterprise Data Architecture page references wrong SVG diagram — **fixed 2026-05-22** - Three architecture pages were missing "Diagram Source" references — **fixed 2026-05-22** - Policy register CSVs are empty (header only) despite 2 active governance documents - `feature_orders` package is missing standard scaffolding files (`.gitignore`, `.metadata`, `CHANGELOG.md`, `LICENSE`, `README.md`) present in all other packages --- ## 7. Maintenance Rules This traceability index should be updated whenever any of the following occur: - a new enterprise architecture view is added - a new component view is added - a new dynamic workflow is added - a new controlled governance document is published - a major domain or capability is renamed or restructured ## Summary This traceability index is the navigation and governance bridge between architecture, workflows, business domains, and controlled documentation in the Kell Creations platform repository.