Add platform context architecture diagram and documentation

This commit is contained in:
Mike Kell 2026-03-28 21:45:36 -04:00
parent 17706a5d58
commit 6a53aeb0e3
2 changed files with 72 additions and 1 deletions

View File

@ -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

View File

@ -1,3 +1,43 @@
# Platform Context # 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