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.mddocs/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.mddocs/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.mddocs/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.mddocs/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:
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
Standards documents¶
- No formal standards documents exist; 10 candidate standards identified — see Standards Overview
Operational procedures¶
- No operational runbooks exist; 5 candidate procedures identified — see Operations Overview
Integration documentation¶
- Only WooCommerce integration is implemented; 5 additional integrations architecturally defined — see Integrations Overview
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_orderspackage 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.