Skip to content

Add logical Onion C4 architecture diagram from current code - #9117

Open
jeffreypalermo wants to merge 1 commit into
masterfrom
cursor/logical-arch-diagram-697f
Open

Add logical Onion C4 architecture diagram from current code#9117
jeffreypalermo wants to merge 1 commit into
masterfrom
cursor/logical-arch-diagram-697f

Conversation

@jeffreypalermo

Copy link
Copy Markdown
Contributor

Submitter checklist

  • Issue is clearly tagged (docs / architecture)
  • Narrate status of the branch (feature complete — docs-only)
  • You expect the approval checklist to be satisfied

Summary

Adds a logical Onion architecture C4 component diagram derived from the current src/**/*.csproj project-reference graph (not aspirational).

Files

  • arch/logical-c4.puml — PlantUML C4 source (stdlib <C4/C4_Component>)
  • arch/logical-c4.png — rendered diagram
  • arch/README.md — index entry

Layers reflected

  1. Core — domain, queries, state commands (zero project refs)
  2. Infrastructure — DataAccess (Core only), Database (DbUp), LlmGateway
  3. Shared — UI.Shared, ServiceDefaults
  4. Hosts — UI.Server, UI.Client, UI.Api, Worker, McpServer
  5. Orchestration — AppHost
  6. Externals — SQL Server / Azure SQL, Azure OpenAI / Ollama

Docs-only change; no application code or dependency changes.

Open in Web Open in Cursor 

Documents ChurchBulletin.sln layers (Core, DataAccess, hosts, LLM/MCP)
from verified .csproj references, with rendered PNG.
Copilot AI lite review requested due to automatic review settings August 26, 2026 03:37
@jeffreypalermo
jeffreypalermo marked this pull request as ready for review August 26, 2026 03:42

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an architecture-documentation artifact: a C4 Component diagram representing the solution’s logical Onion layering based on the current src/**/*.csproj project-reference graph.

Changes:

  • Adds arch/logical-c4.puml PlantUML source for the logical Onion architecture component diagram.
  • Adds rendered output arch/logical-c4.png for quick viewing.
  • Updates arch/README.md to index the new diagram.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 2 comments.

File Description
arch/README.md Adds an index entry for the new logical architecture diagram.
arch/logical-c4.puml Introduces the C4 Component diagram source describing the solution’s logical Onion layering and key relationships.
arch/logical-c4.png Adds the rendered diagram image corresponding to logical-c4.puml.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread arch/logical-c4.puml

Boundary(ring_hosts, "Outer - Hosts / Composition Roots") {
Component(uiServer, "UI.Server", "ASP.NET Core 10", "Hosts Blazor WASM, UI.Api, gRPC WorkOrders, in-process MCP /mcp, NServiceBus endpoint UI.Server", $tags="host")
Component(worker, "Worker", ".NET Worker", "NServiceBus endpoint WorkOrderProcessing; refs DataAccess + LlmGateway", $tags="host")
Comment thread arch/logical-c4.puml
title Church Bulletin Work Orders - Logical Architecture (Onion)

AddElementTag("core", $bgColor="#D5F5E3", $borderColor="#196F3D", $legendText="Core - no project refs")
AddElementTag("infra", $bgColor="#D6EAF8", $borderColor="#1A5276", $legendText="Infrastructure - refs Core only")
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants