Files
portal/docs/architecture
Дмитрий 431117087f docs(arch): code-derived C4 component-layer diagram from deptrac (gap 4)
docs/architecture/c4-component-layers.md — the Level-3 layer
dependency graph generated by `deptrac analyse --formatter=mermaidjs`
(code-derived, drift-proof). Closes the A6 «C4 drift» gap at the
component level. README diagram index + regenerate note updated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 11:15:34 +03:00
..

docs/architecture — system diagrams and models

C4 and architecture diagrams for Лидерра, written as Mermaid source. Generated and maintained with the mermaid skill (.claude/skills/mermaid/).

Boundaries

  • docs/architecture/ (here) — visual models: C4 diagrams, system context, container and component views. Not normative.
  • docs/adr/ — Architecture Decision Records: the decisions and their rationale. An ADR may reference a diagram here.
  • docs/Открытые_вопросы_v8_3.mdopen product/business/legal questions.

See ADR-000 for the full boundary rule.

Diagrams

File View Mermaid type
c4-context.md System Context — Лидерра and its actors / external systems C4Context
c4-component-layers.md Component — backend layer dependency graph (deptrac-generated, drift-proof) flowchart

Regenerating

Mermaid blocks render natively on GitHub. To author or revise a diagram, invoke the mermaid skill and describe the view; it reads the matching syntax reference (.claude/skills/mermaid/references/) and emits a ```mermaid block. No local renderer (mmdc) is required.

For pattern guidance when shaping a new subsystem, the architecture-patterns skill covers Clean / Hexagonal / layered architecture and Domain-Driven Design.

The component-layer diagram (c4-component-layers.md) is not hand-authored — deptrac generates it from code (cd app && php vendor/bin/deptrac analyse --formatter=mermaidjs), so it cannot drift. Regenerate it after any change to the layer model in app/deptrac.yaml.