Add platform context architecture diagram and documentation
This commit is contained in:
parent
17706a5d58
commit
6a53aeb0e3
|
|
@ -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
|
||||||
|
|
@ -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
|
||||||
Loading…
Reference in New Issue