diff --git a/architecture/workspace/context-kellcreations-platform.puml b/architecture/workspace/context-kellcreations-platform.puml new file mode 100644 index 0000000..3c3c1a8 --- /dev/null +++ b/architecture/workspace/context-kellcreations-platform.puml @@ -0,0 +1,31 @@ +@startuml +!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml + +LAYOUT_WITH_LEGEND() + +title Kell Creations Platform - System Context + +Person(owner, "Business Owner", "Oversees business operations, governance, and growth") +Person(staff, "Operations Staff", "Supports production, publishing, fulfillment, and administration") + +System(platform, "Kell Creations Platform", "Unified business applications, policies, workflows, and shared services") + +System_Ext(wordpress, "WordPress", "Website and content publishing platform") +System_Ext(n8n, "n8n", "Workflow automation and AI-enabled process orchestration") +System_Ext(mail, "Mail Server", "Business notifications, approvals, and communications") +System_Ext(git, "Forgejo Git", "Source control and auditable documentation history") +System_Ext(facebook, "Facebook", "Social media publishing and engagement") +System_Ext(instagram, "Instagram", "Social media publishing and engagement") +System_Ext(xsocial, "X", "Social media publishing and engagement") + +Rel(owner, platform, "Uses to govern and manage") +Rel(staff, platform, "Uses for daily operations") +Rel(platform, wordpress, "Publishes content, product updates, and site changes to") +Rel(platform, n8n, "Sends and receives workflow automation tasks with") +Rel(platform, mail, "Sends notifications, reminders, and approval messages through") +Rel(platform, git, "Stores controlled source, documentation, and policy history in") +Rel(platform, facebook, "Publishes campaigns and content to") +Rel(platform, instagram, "Publishes campaigns and content to") +Rel(platform, xsocial, "Publishes campaigns and content to") + +@enduml \ No newline at end of file diff --git a/docs/architecture/context/platform.md b/docs/architecture/context/platform.md index bf133f2..490060f 100644 --- a/docs/architecture/context/platform.md +++ b/docs/architecture/context/platform.md @@ -1,3 +1,43 @@ # Platform Context -This page describes the Kell Creations platform in relation to business users and external services. +This diagram shows the Kell Creations Platform in relation to its primary users and connected external systems. + +## Purpose + +This view explains how the platform interacts with the surrounding business environment. It is intended to provide a clear context for later container, component, deployment, and workflow views. + +## Diagram Source + +The source for this diagram is maintained as architecture code in: + +`architecture/workspace/context-kellcreations-platform.puml` + +## Included Elements + +### Internal platform +- Kell Creations Platform + +### Business users +- Business Owner +- Operations Staff + +### External connected systems +- WordPress +- n8n +- Mail Server +- Forgejo Git +- Facebook +- Instagram +- X + +## Notes + +This context view will later be decomposed into container-level diagrams for: + +- Inventory +- Social Media Management +- WordPress Management +- Craft Manufacturing / MRP +- Financial Analysis +- Transaction Database +- Shared services for authentication, data repository, API orchestration, notifications, and audit support \ No newline at end of file