Skip to content

Replace architecture Mermaid diagrams with SVG#12

Merged
neuromechanist merged 1 commit into
mainfrom
docs/architecture-svg
Mar 10, 2026
Merged

Replace architecture Mermaid diagrams with SVG#12
neuromechanist merged 1 commit into
mainfrom
docs/architecture-svg

Conversation

@neuromechanist

Copy link
Copy Markdown
Member

Summary

  • Replace all Mermaid diagrams in architecture page with two SVG diagrams (overview + detailed)
  • Split architecture into two pages: Overview and Details
  • Correct inaccurate components that were never implemented (router agent, PostgreSQL, Redis, vector store, multiple instances, background workers)
  • All diagrams now reflect the actual deployed system

Changes

  • architecture.md: Rewritten as overview page with high-level SVG and accurate component descriptions
  • architecture-details.md: New page with detailed infrastructure SVG, request flow, community routing, model selection, knowledge system, security, and CI/CD
  • architecture-overview.svg: High-level diagram (researchers -> clients -> edge -> platform -> services)
  • architecture-diagram.svg: Detailed infrastructure diagram with orthogonal arrow routing
  • mkdocs.yml: Architecture nav expanded to Overview + Details

What was corrected

  • Removed Router Agent / Supervisor pattern (not implemented)
  • Removed PostgreSQL, Redis, Vector Store (actual: SQLite + FTS5, in-memory sessions)
  • Removed multiple FastAPI instances / load balancer (actual: single instance)
  • Removed background workers (actual: CLI-driven knowledge sync)
  • Added actual Apache reverse proxy setup
  • Added accurate BYOK authentication flow
  • Added CI/CD pipeline details

Test plan

  • mkdocs build succeeds with no errors
  • Verify SVGs render correctly on the docs site
  • Check dark mode appearance

Split architecture into overview and details pages with accurate
SVG diagrams reflecting the actual deployed system. Removes
aspirational components (router agent, PostgreSQL, Redis, vector
store, multiple instances) that were never implemented.
@neuromechanist
neuromechanist merged commit 8b35ba2 into main Mar 10, 2026
@neuromechanist
neuromechanist deleted the docs/architecture-svg branch April 23, 2026 15:23
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.

1 participant