diff --git a/architecture/workspace/containers-enterprise-services.puml b/architecture/workspace/containers-enterprise-services.puml new file mode 100644 index 0000000..60d2026 --- /dev/null +++ b/architecture/workspace/containers-enterprise-services.puml @@ -0,0 +1,47 @@ +@startuml +!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml + +LAYOUT_WITH_LEGEND() + +title Kell Creations - Enterprise Shared Services + +Person(owner, "Business Owner") +Person(staff, "Operations Staff") + +System_Boundary(platform, "Kell Creations Platform") { + + Container(auth, "Authentication Service", "Identity Service", "Centralized authentication, identity, and access control") + + Container(datarepo, "Shared Data Repository", "Data Service", "Provides unified access to core business entities and reference data") + + Container(api, "API Orchestrator", "API Gateway / Service Layer", "Central integration layer for internal services and external systems") + + Container(notify, "Notification Service", "Messaging Service", "Handles email alerts, approvals, reminders, and workflow notifications") + + Container(policyrepo, "Policy Repository", "Document Service", "Manages controlled policies, procedures, standards, and records") + + Container(audit, "Audit & Logging Service", "Observability Service", "Captures logs, events, and audit trails across all applications") + +} + +System_Ext(mail, "Mail Server", "mail.kellcreations.com") +System_Ext(git, "Forgejo Git", "git.kellsupport.com") +System_Ext(n8n, "n8n", "Automation and workflow engine") + +Rel(owner, auth, "Authenticates through") +Rel(staff, auth, "Authenticates through") + +Rel(api, n8n, "Triggers workflows and receives automation events from") +Rel(notify, mail, "Sends messages through") +Rel(policyrepo, git, "Stores version-controlled documents in") + +Rel(api, datarepo, "Reads/Writes business data through") +Rel(api, auth, "Validates identity through") +Rel(api, notify, "Triggers notifications through") +Rel(api, audit, "Logs events to") + +Rel(datarepo, audit, "Logs access events to") +Rel(auth, audit, "Logs authentication events to") +Rel(policyrepo, audit, "Logs document changes to") + +@enduml \ No newline at end of file diff --git a/docs/architecture/containers/enterprise-services.md b/docs/architecture/containers/enterprise-services.md new file mode 100644 index 0000000..610586e --- /dev/null +++ b/docs/architecture/containers/enterprise-services.md @@ -0,0 +1,44 @@ +# Enterprise Shared Services + +This diagram shows the common enterprise services that support all Kell Creations platform applications. + +## Purpose + +This view defines the shared service backbone for the Kell Creations platform. It establishes the common identity, data, integration, notification, policy, and audit capabilities that all business applications should use. + +## Diagram Source + +The source for this diagram is maintained as architecture code in: + +`architecture/workspace/containers-enterprise-services.puml` + +## Included Shared Services + +- Authentication Service +- Shared Data Repository +- API Orchestrator +- Notification Service +- Policy Repository +- Audit & Logging Service + +## Connected External Systems + +- Mail Server at `mail.kellcreations.com` +- Forgejo Git at `git.kellsupport.com` +- n8n automation at `n8n.kellsupport.com` + +## Architectural Role + +These shared services provide the enterprise foundation for: + +- Inventory +- Social Media Management +- WordPress Management +- Craft Manufacturing / MRP +- Financial Analysis +- Transaction Database +- Controlled policy and process governance + +## Notes + +All future application and component diagrams should align to this enterprise services model. New applications should authenticate through the Authentication Service, exchange data through the Shared Data Repository and API Orchestrator, use the Notification Service for alerts and approvals, and generate auditable records through the Audit & Logging Service. \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 2db11d0..1cfc6f1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -37,6 +37,7 @@ nav: - Platform Context: "architecture/context/platform.md" - Containers: - Platform Containers: "architecture/containers/platform-containers.md" + - Enterprise Shared Services: "architecture/containers/enterprise-services.md" - Components: - Inventory Components: "architecture/components/inventory.md" - Deployment: