philipp.info/architecture
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
15 commits 1 branch 0 tags 493 KiB
Find a file
Exact
philipp 0e6e5c4b00 [infra-hosts-ansible] fixup in arch
2026-01-02 21:01:44 +01:00
adr [infra-hosts-ansible] Update architecture 2026-01-02 20:41:30 +01:00
architecture [architecture] add overview 2025-12-22 00:17:46 +01:00
policies [arch] Update repo-strategy 2025-12-27 21:37:59 +01:00
runbooks [infra-hosts-ansible] fixup in arch 2026-01-02 21:01:44 +01:00
templates [architecture] init base 2025-12-21 19:11:45 +01:00
.editorconfig [architecture] init base 2025-12-21 19:11:45 +01:00
.gitignore [architecture] add overview 2025-12-22 00:17:15 +01:00
.markdownlint-cli2.jsonc [architecture] init base 2025-12-21 19:11:45 +01:00
.pre-commit-config.yaml [architecture] init base 2025-12-21 19:11:45 +01:00
.vale.ini [architecture] init base 2025-12-21 19:11:45 +01:00
inventory.yaml [infra-hosts-ansible] fixup in arch 2026-01-02 21:01:44 +01:00
overview.md [arch] Update repo-strategy 2025-12-27 21:37:59 +01:00
README.md [arch] Update repo-strategy 2025-12-27 21:37:59 +01:00

README.md

architecture

Docs-only repository for the philipp.info platform architecture.

This repo is the source of truth for:

  • Architecture overview and diagrams
  • ADRs (Architecture Decision Records)
  • Policies (repo boundaries, PR gates, conventions)
  • Service/host inventory (inventory.yaml)
  • Runbooks that are cross-cutting (platform-level)

Start here

  • Architecture overview: overview.md
  • Inventory (ports, deps, SLOs): inventory.yaml
  • Diagrams: architecture/
    • 00-system-overview.drawio
    • 01-network-zones.drawio
  • Repo boundaries / agent routing: policies/repo-layout.md
  • ADRs: adr/

Local checks

This repo uses pre-commit to run Markdown linting and prose checks.

Setup (macOS)

  • Install pre-commit and vale
  • Run:
    • pre-commit install
    • pre-commit run -a

Last updated: 2025-12-27