Add system landscape architecture diagram and documentation

This commit is contained in:
Mike Kell 2026-03-28 21:38:34 -04:00
parent f0d214f277
commit 17706a5d58
2 changed files with 69 additions and 1 deletions

View File

@ -0,0 +1,33 @@
@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
LAYOUT_WITH_LEGEND()
title Kell Creations - System Landscape
Person(owner, "Business Owner", "Oversees operations and governance")
Person(staff, "Operations Staff", "Uses internal business applications")
System_Boundary(kc, "Kell Creations Platform") {
System(platform, "Kell Creations Platform", "Unified applications, services, policies, and workflows")
}
System_Ext(wordpress, "WordPress", "www.kellcreations.com")
System_Ext(n8n, "n8n", "n8n.kellsupport.com")
System_Ext(mail, "Mail Server", "mail.kellcreations.com")
System_Ext(git, "Git Service", "git.kellsupport.com")
System_Ext(facebook, "Facebook", "@kellcreation")
System_Ext(instagram, "Instagram", "@kellcreations")
System_Ext(xsocial, "X", "@kellcreations")
Rel(owner, platform, "Governs and uses")
Rel(staff, platform, "Uses")
Rel(platform, wordpress, "Publishes content and syncs data")
Rel(platform, n8n, "Triggers and receives automations")
Rel(platform, mail, "Sends notifications and approvals")
Rel(platform, git, "Stores controlled source and documents")
Rel(platform, facebook, "Publishes campaigns")
Rel(platform, instagram, "Publishes campaigns")
Rel(platform, xsocial, "Publishes campaigns")
@enduml

View File

@ -1,3 +1,38 @@
# System Landscape
The Kell Creations platform connects internal applications, shared services, WordPress, mail, social platforms, and automation workflows.
This diagram shows the Kell Creations platform at the highest level.
It identifies the primary business users, the central Kell Creations platform, and the major external systems it depends on for publishing, automation, communications, and source control.
## Scope
This view is intended to provide a management-level understanding of the platform ecosystem. It is the starting point for more detailed context, container, component, deployment, and workflow diagrams.
## Diagram Source
The source for this diagram is maintained as architecture code in:
`architecture/workspace/system-landscape.puml`
## Included Systems
- Kell Creations Platform
- WordPress at `www.kellcreations.com`
- n8n at `n8n.kellsupport.com`
- Mail services at `mail.kellcreations.com`
- Git services at `git.kellsupport.com`
- Facebook `@kellcreation`
- Instagram `@kellcreations`
- X `@kellcreations`
## Notes
This landscape view will evolve as the internal applications are broken out into:
- Inventory
- Social Media Management
- WordPress Management
- Craft Manufacturing / MRP
- Financial Analysis
- Transaction Database
- Shared services for authentication, data, API orchestration, and common UI patterns