docs: drop 8 unused diagram variants

After user picked svg-adaptive as the winner, remove:
- mermaid.md, svg-embedded.md, svg-sized.md, svg-inline.md, svg-object.md,
  standalone.svg, standalone.html, ascii.txt

Kept:
- standalone-adaptive.svg + svg-adaptive.md
- README.md (will be refreshed in next commit)
This commit is contained in:
hermes
2026-08-27 17:08:18 +00:00
parent 8672f0db37
commit d500dc04cc
8 changed files with 0 additions and 961 deletions
-49
View File
@@ -1,49 +0,0 @@
Production architecture — ASCII variant
=====================================
Snapshot: 2026-08-27
Sources: docker_socket_proxy + gitea admin API + gitea_server logs
EXTERNAL (LAN 192.168.1.0/24) DOCKER SWARM CLUSTER
+------------------------------+ +-----------------------------------------------+
| | | |
| ( Client ) | | odroid (manager) · 192.168.1.96 · arm64 |
| | | | |
| v | | +------------+ +------------------+ |
| +---------+ +---------+ | | | ingress | | Stacks | |
| |Tailscale|-->|Keenetic |---+-----------> | 10.0.0.2 |----->| | |
| | (subnet)| |DNS+TLS | | | +------------+ | +----+ +----+ | |
| +---------+ +---------+ | | | | |git | |herm| | |
| | | | | | ea | | es | | |
| | | v | +----+ +----+ | |
| | | +---------------+ | | |
+------------------------------+ | | gitea_server | | (7 stacks total) | |
| | .235 / 3000 | | | |
| +---------------+ +------------------+ |
| |
| nginx_nginx (dead) — Replicas: 0 |
| |
| xu4 (worker) |
| worker tasks: (пусто в снапшоте) |
+-----------------------------------------------+
Flow:
Client → Tailscale (subnet router) → Keenetic (DNS, Let's Encrypt TLS term)
→ plain HTTP → swarm ingress-endpoint (10.0.0.2) → gitea_server
Brencher deploys: gitea, immich, hermes_infra (через git pull + docker stack deploy)
Overlay networks (22 total):
ingress 10.0.0.0/24 ← все сервисы на swarm mesh
gitea_gitea 10.0.17.0/24 ← gitea_stack
nginx_ingress 10.0.3.0/24 ← для nginx-proxy (но Replicas=0)
immich 10.0.2.0/24
hermes_infra_* 10.0.12-15.0/24
brencher* 10.0.5-7.0/24
Nodes:
odroid manager j9bljgaqh9qc Linux 5.15 ARM64 192.168.1.96
xu4 worker u2ynmimtl0lu (tasks empty in snapshot)
Dead/disabled:
nginx_nginx jwilder/nginx-proxy Replicas=0 (overlay-сеть nginx_ingress жива)
-89
View File
@@ -1,89 +0,0 @@
# Production architecture — variant 1: Mermaid
> **Формат:** Mermaid внутри Markdown. Рендерится прямо в Gitea (preview в PR, page view).
> Diff-friendly, версионируется вместе с кодом, не требует внешних тулзов.
## Level 1: Cluster overview
```mermaid
flowchart TB
Client(["Client<br/>из tailscale-сети"])
subgraph EXT["External (LAN 192.168.1.0/24)"]
Keenetic["Keenetic router<br/>192.168.1.1<br/>DNS + Let's Encrypt<br/>TLS termination"]
Tailscale["Tailscale<br/>subnet router на odroid<br/>только транспорт"]
end
subgraph SWARM["Docker Swarm cluster"]
subgraph ODROID["Node: odroid (manager)<br/>192.168.1.96 · arm64 · Linux 5.15"]
direction TB
Ingress["swarm ingress-endpoint<br/>10.0.0.2<br/>(routing mesh)"]
subgraph STACKS["Stacks"]
direction LR
Gitea["gitea stack<br/>gitea_server (3000)<br/>gitea_runner<br/>gitea_gitea 10.0.17/24"]
Hermes["hermes stack<br/>hermes-agent<br/>hermes-gateway"]
HermesInfra["hermes_infra stack<br/>squid · sarg · hermes-ui<br/>docker_socket_proxy<br/>brencher-state-proxy"]
Immich["immich stack<br/>server · db · redis · ml<br/>10.0.2.0/24"]
Brencher["brencher · brencher2<br/>deploy tools"]
GmailMCP["gmail_mcp<br/>gmail + telegram MCP"]
Torrserv["torrserv_proxy<br/>reverseproxy · fileserver"]
end
NginxDead["nginx_nginx<br/>jwilder/nginx-proxy<br/>Replicas: 0 (dead)"]
end
subgraph XU4["Node: xu4 (worker)"]
Worker["worker tasks<br/>(пусто в снапшоте)"]
end
end
Client -->|"https://gitea.rudolf.keenetic.link<br/>(tailscale subnet)"| Tailscale
Tailscale -->|"HTTPS"| Keenetic
Keenetic -->|"plain HTTP после TLS term"| Ingress
Ingress -->|"swarm routing<br/>(endpoint.Ports stale)"| Gitea
Ingress --> Immich
Ingress --> Hermes
NginxDead -.->|"сеть есть<br/>контейнеров нет"| Ingress
Brencher -.->|"deploys"| Gitea
Brencher -.->|"deploys"| Immich
Brencher -.->|"deploys"| HermesInfra
classDef external fill:#1e293b,stroke:#94a3b8,color:#e2e8f0
classDef node fill:#0f172a,stroke:#fbbf24,color:#fef3c7
classDef stack fill:#0c4a6e,stroke:#22d3ee,color:#cffafe
classDef dead fill:#1f1717,stroke:#fb7185,color:#fecaca,stroke-dasharray: 4 4
classDef edge fill:#064e3b,stroke:#34d399,color:#d1fae5
class Client,Keenetic,Tailscale external
class ODROID,XU4 node
class STACKS stack
class Gitea,Hermes,HermesInfra,Immich,Brencher,GmailMCP,Torrserv stack
class NginxDead dead
class Ingress edge
```
## Плюсы / минусы
**+** Рендерится в Gitea сразу, без дополнительных инструментов.
**+** Plain text, mergeable, diff-friendly.
**+** Легко править — текстовый формат.
**+** Gitea поддерживает `classDef`, subgraphs, разные стрелки.
**-** Стиль Mermaid спартанский (не dark theme by default — нужны `classDef`).
**-** Большие графы плохо помещаются в PR preview.
**-** Сложные layout-ы (force-directed) не поддерживаются.
## Известные неточности в данных
1. `endpoint.Ports` у gitea_server пустое, но ingress маршрутизирует — legacy endpoint или ручной `service update --publish-add`.
2. `xu4` worker пуст в снапшоте 2026-08-27 — перепроверить перед фиксацией.
3. `nginx_nginx` Replicas=0 — "dead" блок показан отдельно.
4. Tailscale роль: subnet router (транспорт), не MagicDNS — но это требует подтверждения.
## Связанные файлы
- `standalone.svg` — тот же граф в raw SVG (вариант 2)
- `standalone.html` — тот же граф в HTML-обёртке (вариант 3)
- `../README.md` — обзор всех вариантов
-304
View File
@@ -1,304 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Production architecture · Cluster overview</title>
<style>
/* No external dependencies, no JS. Single file.
Open in any browser, share as-is, embed in docs. */
:root {
--bg: #020617;
--fg: #e2e8f0;
--muted: #94a3b8;
--external-fill: rgba(30, 41, 59, 0.5);
--external-stroke: #94a3b8;
--node-stroke: #fbbf24;
--stack-fill: rgba(8, 51, 68, 0.4);
--stack-stroke: #22d3ee;
--dead-fill: rgba(136, 19, 55, 0.4);
--dead-stroke: #fb7185;
--edge-fill: rgba(6, 78, 59, 0.4);
--edge-stroke: #34d399;
--arrow: #cbd5e1;
}
html, body {
margin: 0; padding: 0;
background: var(--bg);
color: var(--fg);
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
.wrap {
max-width: 1500px; margin: 0 auto; padding: 32px 24px;
}
.header {
display: flex; align-items: center; gap: 12px;
margin-bottom: 8px;
}
.pulse {
width: 10px; height: 10px; border-radius: 50%;
background: #34d399;
box-shadow: 0 0 0 0 rgba(52, 211, 153, 0.7);
animation: pulse 2s infinite;
}
@keyframes pulse {
0% { box-shadow: 0 0 0 0 rgba(52, 211, 153, 0.7); }
70% { box-shadow: 0 0 0 12px rgba(52, 211, 153, 0); }
100% { box-shadow: 0 0 0 0 rgba(52, 211, 153, 0); }
}
h1 { margin: 0; font-size: 22px; font-weight: 600; }
.subtitle { color: var(--muted); font-size: 12px; margin-bottom: 24px; }
.card {
background: #0f172a;
border: 1px solid #1e293b;
border-radius: 12px;
padding: 24px;
overflow-x: auto;
}
.cards {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 16px;
margin-top: 24px;
}
@media (max-width: 900px) {
.cards { grid-template-columns: 1fr; }
}
.info-card {
background: #0f172a;
border: 1px solid #1e293b;
border-radius: 12px;
padding: 18px 20px;
}
.info-card h3 {
margin: 0 0 10px 0;
font-size: 13px;
color: var(--muted);
font-weight: 600;
letter-spacing: 0.5px;
text-transform: uppercase;
}
.info-card ul {
margin: 0; padding-left: 16px;
font-size: 12px;
line-height: 1.7;
color: var(--fg);
}
.info-card li::marker { color: var(--edge-stroke); }
.footer {
margin-top: 24px;
color: #475569;
font-size: 10px;
text-align: right;
}
</style>
</head>
<body>
<div class="wrap">
<div class="header">
<span class="pulse"></span>
<h1>Production architecture · Cluster overview</h1>
</div>
<div class="subtitle">
Snapshot 2026-08-27 · sources: docker_socket_proxy (read-only) + gitea admin API + gitea_server logs
</div>
<div class="card">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1400 900" font-size="12">
<title>Production architecture · Cluster overview</title>
<defs>
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#cbd5e1"/>
</marker>
<marker id="arrow-dashed" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#fb7185"/>
</marker>
<pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="0.5" fill="#1e293b"/>
</pattern>
</defs>
<rect width="1400" height="900" fill="#020617"/>
<rect width="1400" height="900" fill="url(#grid)"/>
<!-- External -->
<rect x="40" y="130" width="260" height="220" rx="12" fill="#1e293b" fill-opacity="0.5" stroke="#94a3b8" stroke-width="1.5"/>
<text x="60" y="155" fill="#94a3b8" font-size="11" font-weight="bold">EXTERNAL (LAN 192.168.1.0/24)</text>
<rect x="60" y="175" width="220" height="44" rx="22" fill="#1e293b" stroke="#94a3b8" stroke-width="1.5"/>
<text x="170" y="193" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Client</text>
<text x="170" y="210" text-anchor="middle" fill="#94a3b8" font-size="10">из tailscale-сети</text>
<rect x="60" y="235" width="105" height="44" rx="6" fill="#0f172a" stroke="#94a3b8" stroke-width="1.5"/>
<text x="112" y="253" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Tailscale</text>
<text x="112" y="270" text-anchor="middle" fill="#94a3b8" font-size="9">subnet router</text>
<rect x="175" y="235" width="105" height="44" rx="6" fill="#0f172a" stroke="#94a3b8" stroke-width="1.5"/>
<text x="227" y="253" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Keenetic</text>
<text x="227" y="267" text-anchor="middle" fill="#94a3b8" font-size="9">DNS + TLS term</text>
<text x="227" y="277" text-anchor="middle" fill="#94a3b8" font-size="9">192.168.1.1</text>
<!-- Arrows client→tailscale→keenetic -->
<path d="M 112 219 L 112 235" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<path d="M 167 257 L 175 257" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<!-- Swarm cluster -->
<rect x="340" y="130" width="720" height="740" rx="12" fill="none" stroke="#fbbf24" stroke-width="1" stroke-dasharray="8 4"/>
<text x="360" y="155" fill="#fbbf24" font-size="11" font-weight="bold">DOCKER SWARM CLUSTER</text>
<!-- odroid node -->
<rect x="360" y="175" width="680" height="460" rx="10" fill="none" stroke="#fbbf24" stroke-width="1.5"/>
<text x="380" y="200" fill="#fef3c7" font-size="12" font-weight="bold">Node: odroid (manager)</text>
<text x="380" y="216" fill="#94a3b8" font-size="10">192.168.1.96 · arm64 · Linux 5.15 · id=j9bljgaqh9qc</text>
<!-- ingress -->
<rect x="380" y="235" width="180" height="50" rx="6" fill="#064e3b" stroke="#34d399" stroke-width="1.5"/>
<text x="470" y="255" text-anchor="middle" fill="#d1fae5" font-size="12" font-weight="bold">swarm ingress</text>
<text x="470" y="270" text-anchor="middle" fill="#a7f3d0" font-size="10">10.0.0.2</text>
<text x="470" y="281" text-anchor="middle" fill="#a7f3d0" font-size="9">(routing mesh)</text>
<!-- Stacks label -->
<text x="380" y="315" fill="#22d3ee" font-size="11" font-weight="bold">STACKS</text>
<!-- stack boxes -->
<g font-size="12">
<rect x="380" y="330" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="460" y="350" text-anchor="middle" fill="#cffafe" font-weight="bold">gitea</text>
<text x="460" y="366" text-anchor="middle" fill="#cffafe" font-size="9">gitea_server (3000)</text>
<text x="460" y="378" text-anchor="middle" fill="#cffafe" font-size="9">gitea_runner</text>
<text x="460" y="392" text-anchor="middle" fill="#cffafe" font-size="9">gitea_gitea 10.0.17/24</text>
<text x="460" y="404" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.235</text>
<rect x="555" y="330" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="635" y="350" text-anchor="middle" fill="#cffafe" font-weight="bold">hermes</text>
<text x="635" y="366" text-anchor="middle" fill="#cffafe" font-size="9">hermes-agent</text>
<text x="635" y="378" text-anchor="middle" fill="#cffafe" font-size="9">hermes-gateway</text>
<text x="635" y="392" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.204</text>
<rect x="730" y="330" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="810" y="350" text-anchor="middle" fill="#cffafe" font-size="11" font-weight="bold">hermes_infra</text>
<text x="810" y="364" text-anchor="middle" fill="#cffafe" font-size="8">squid · sarg · hermes-ui</text>
<text x="810" y="375" text-anchor="middle" fill="#cffafe" font-size="8">docker_socket_proxy</text>
<text x="810" y="386" text-anchor="middle" fill="#cffafe" font-size="8">brencher-state-proxy</text>
<text x="810" y="400" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.106/108</text>
<rect x="905" y="330" width="115" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="962" y="350" text-anchor="middle" fill="#cffafe" font-weight="bold">immich</text>
<text x="962" y="366" text-anchor="middle" fill="#cffafe" font-size="9">server · db</text>
<text x="962" y="378" text-anchor="middle" fill="#cffafe" font-size="9">redis · ml</text>
<text x="962" y="392" text-anchor="middle" fill="#cffafe" font-size="9">10.0.2.0/24</text>
<text x="962" y="404" text-anchor="middle" fill="#cffafe" font-size="9">.225 / .13</text>
<rect x="380" y="425" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="460" y="445" text-anchor="middle" fill="#cffafe" font-weight="bold">brencher · brencher2</text>
<text x="460" y="461" text-anchor="middle" fill="#cffafe" font-size="9">deploy tools</text>
<text x="460" y="473" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.105</text>
<text x="460" y="485" text-anchor="middle" fill="#cffafe" font-size="9"> 10.0.0.102</text>
<rect x="555" y="425" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="635" y="445" text-anchor="middle" fill="#cffafe" font-weight="bold">gmail_mcp</text>
<text x="635" y="461" text-anchor="middle" fill="#cffafe" font-size="9">gmail-mcp-server</text>
<text x="635" y="473" text-anchor="middle" fill="#cffafe" font-size="9">telegram-mcp-server</text>
<text x="635" y="485" text-anchor="middle" fill="#cffafe" font-size="9">10.0.0.6 / 10</text>
<rect x="730" y="425" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="810" y="445" text-anchor="middle" fill="#cffafe" font-weight="bold">torrserv_proxy</text>
<text x="810" y="461" text-anchor="middle" fill="#cffafe" font-size="9">reverseproxy</text>
<text x="810" y="473" text-anchor="middle" fill="#cffafe" font-size="9">fileserver</text>
<text x="810" y="485" text-anchor="middle" fill="#cffafe" font-size="9">.15 / .12</text>
</g>
<!-- Dead nginx_nginx -->
<rect x="380" y="525" width="280" height="50" rx="6" fill="#1f1717" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="6 3"/>
<text x="520" y="545" text-anchor="middle" fill="#fecaca" font-size="12" font-weight="bold">nginx_nginx (dead)</text>
<text x="520" y="560" text-anchor="middle" fill="#fecaca" font-size="9">jwilder/nginx-proxy · Replicas: 0</text>
<text x="520" y="571" text-anchor="middle" fill="#fecaca" font-size="9">контейнеров нет, overlay-сеть nginx_ingress жива</text>
<!-- xu4 worker -->
<rect x="360" y="660" width="680" height="180" rx="10" fill="none" stroke="#fbbf24" stroke-width="1.5"/>
<text x="380" y="685" fill="#fef3c7" font-size="12" font-weight="bold">Node: xu4 (worker)</text>
<text x="380" y="700" fill="#94a3b8" font-size="10">id=u2ynmimtl0lu</text>
<rect x="500" y="725" width="400" height="60" rx="6" fill="#0f172a" stroke="#fbbf24" stroke-width="1.5" fill-opacity="0.5"/>
<text x="700" y="750" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="bold">worker tasks</text>
<text x="700" y="767" text-anchor="middle" fill="#94a3b8" font-size="10">(пусто в снапшоте 2026-08-27 — перепроверить)</text>
<!-- Legend -->
<g id="legend">
<rect x="40" y="660" width="260" height="180" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
<text x="60" y="685" fill="#e2e8f0" font-size="11" font-weight="bold">LEGEND</text>
<rect x="60" y="700" width="20" height="14" rx="3" fill="#1e293b" stroke="#94a3b8" stroke-width="1"/>
<text x="90" y="711" fill="#cbd5e1" font-size="10">external</text>
<rect x="60" y="720" width="20" height="14" rx="3" fill="#0f172a" stroke="#fbbf24" stroke-width="1"/>
<text x="90" y="731" fill="#cbd5e1" font-size="10">node</text>
<rect x="60" y="740" width="20" height="14" rx="3" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1"/>
<text x="90" y="751" fill="#cbd5e1" font-size="10">stack</text>
<rect x="60" y="760" width="20" height="14" rx="3" fill="#064e3b" stroke="#34d399" stroke-width="1"/>
<text x="90" y="771" fill="#cbd5e1" font-size="10">edge / routing</text>
<rect x="60" y="780" width="20" height="14" rx="3" fill="#1f1717" stroke="#fb7185" stroke-width="1" stroke-dasharray="3 2"/>
<text x="90" y="791" fill="#cbd5e1" font-size="10">dead / disabled</text>
<line x1="60" y1="810" x2="80" y2="810" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="90" y="814" fill="#cbd5e1" font-size="10">solid = flow</text>
<line x1="60" y1="828" x2="80" y2="828" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<text x="90" y="832" fill="#cbd5e1" font-size="10">dashed = deploy</text>
</g>
<!-- Arrows (drawn last for z-order) -->
<path d="M 280 257 L 360 257" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="290" y="250" fill="#cbd5e1" font-size="9">plain HTTP</text>
<text x="290" y="262" fill="#cbd5e1" font-size="9">post TLS term</text>
<path d="M 470 285 L 470 330" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="475" y="305" fill="#cbd5e1" font-size="9">to gitea</text>
<path d="M 540 260 Q 750 260 962 330" fill="none" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#arrow)"/>
<path d="M 530 255 Q 600 280 635 330" fill="none" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#arrow)"/>
<path d="M 460 425 L 460 410" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<path d="M 540 455 Q 700 455 962 410" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<text x="700" y="448" fill="#fb7185" font-size="9">deploys</text>
<path d="M 540 460 Q 680 495 810 410" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<path d="M 520 525 L 520 285" fill="none" stroke="#fb7185" stroke-width="1" stroke-dasharray="4 3" stroke-opacity="0.5" marker-end="url(#arrow-dashed)"/>
<text x="528" y="425" fill="#fb7185" font-size="9" stroke-opacity="0.6">overlay-сеть жива,<br/>контейнеров нет</text>
</svg>
</div>
<!-- Summary cards -->
<div class="cards">
<div class="info-card">
<h3>Что показывает</h3>
<ul>
<li>2 swarm nodes (odroid manager, xu4 worker)</li>
<li>7 stacks on odroid (gitea, hermes, hermes_infra, immich, brencher, gmail_mcp, torrserv_proxy)</li>
<li>External: Keenetic router, Tailscale subnet, Client</li>
<li>Dead component: nginx_nginx (Replicas=0)</li>
<li>Deploy flow: brencher → stacks (dashed arrows)</li>
</ul>
</div>
<div class="info-card">
<h3>Чего НЕ показывает</h3>
<ul>
<li>Каждый отдельный контейнер в overlay-сетях</li>
<li>Volume mounts и где лежат данные</li>
<li>Swarm secrets (LFS_JWT_SECRET, JWT_SECRET)</li>
<li>DNS-резолвинг (search anoa-bebop.ts.net)</li>
<li>Traffic flow отдельных сервисов</li>
</ul>
</div>
<div class="info-card">
<h3>Известные TODO</h3>
<ul>
<li>endpoint.Ports у gitea_server пустое, но ingress маршрутизирует — legacy</li>
<li>xu4 worker пуст в снапшоте 2026-08-27</li>
<li>nginx_nginx Replicas=0 — dead</li>
<li>Tailscale роль требует подтверждения (subnet vs MagicDNS)</li>
<li>Дополнительные уровни: networks, secrets, deploy flow</li>
</ul>
</div>
</div>
<div class="footer">
generated 2026-08-27 · sources: docker_socket_proxy + gitea admin API · single-file HTML, no JS, no external deps
</div>
</div>
</body>
</html>
-233
View File
@@ -1,233 +0,0 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1400 900" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12">
<title>Production architecture · Cluster overview (snapshot 2026-08-27)</title>
<desc>Dark-themed SVG showing 2 swarm nodes (odroid manager + xu4 worker), 7 stacks on odroid (gitea, hermes, hermes_infra, immich, brencher, gmail_mcp, torrserv_proxy), external entities (Keenetic, Tailscale, Client), and a dead nginx_nginx service with Replicas=0.</desc>
<!--
Production architecture — variant 2: standalone SVG
Same graph as variant 1 (Mermaid), but rendered as raw SVG.
Open in any browser, embed in docs, share as-is.
Color palette (semantic):
external: slate #1e293b stroke #94a3b8
node: amber #0f172a stroke #fbbf24
stack: cyan #0c4a6e stroke #22d3ee
dead: rose #1f1717 stroke #fb7185 dashed
edge: emerald #064e3b stroke #34d399
-->
<defs>
<!-- Arrowheads -->
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#cbd5e1"/>
</marker>
<marker id="arrow-dashed" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#fb7185"/>
</marker>
<!-- Subtle dot grid background -->
<pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="0.5" fill="#1e293b"/>
</pattern>
<!-- Reusable component style via <use> would be overkill — inline styles used instead -->
</defs>
<!-- Background -->
<rect width="1400" height="900" fill="#020617"/>
<rect width="1400" height="900" fill="url(#grid)"/>
<!-- Title -->
<text x="40" y="40" fill="#e2e8f0" font-size="20" font-weight="bold">
Production architecture · Cluster overview
</text>
<text x="40" y="60" fill="#94a3b8" font-size="11">
Source: docker_socket_proxy (read-only) + gitea API + gitea_server logs · Snapshot 2026-08-27
</text>
<!-- ============================================================== -->
<!-- External subnet (LAN) -->
<!-- ============================================================== -->
<g id="external">
<rect x="40" y="90" width="260" height="220" rx="12" fill="#1e293b" fill-opacity="0.5" stroke="#94a3b8" stroke-width="1.5"/>
<text x="60" y="115" fill="#94a3b8" font-size="11" font-weight="bold">EXTERNAL (LAN 192.168.1.0/24)</text>
<!-- Client -->
<rect x="60" y="135" width="220" height="44" rx="22" fill="#1e293b" stroke="#94a3b8" stroke-width="1.5"/>
<text x="170" y="153" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Client</text>
<text x="170" y="170" text-anchor="middle" fill="#94a3b8" font-size="10">из tailscale-сети</text>
<!-- Tailscale -->
<rect x="60" y="195" width="105" height="44" rx="6" fill="#0f172a" stroke="#94a3b8" stroke-width="1.5"/>
<text x="112" y="213" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Tailscale</text>
<text x="112" y="230" text-anchor="middle" fill="#94a3b8" font-size="9">subnet router</text>
<!-- Keenetic -->
<rect x="175" y="195" width="105" height="44" rx="6" fill="#0f172a" stroke="#94a3b8" stroke-width="1.5"/>
<text x="227" y="213" text-anchor="middle" fill="#e2e8f0" font-size="12" font-weight="bold">Keenetic</text>
<text x="227" y="227" text-anchor="middle" fill="#94a3b8" font-size="9">DNS + TLS term</text>
<text x="227" y="237" text-anchor="middle" fill="#94a3b8" font-size="9">192.168.1.1</text>
</g>
<!-- Arrows: Client → Tailscale → Keenetic -->
<path d="M 112 179 L 112 195" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<path d="M 167 217 L 175 217" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="120" y="190" fill="#cbd5e1" font-size="9">tails</text>
<!-- ============================================================== -->
<!-- Swarm cluster -->
<!-- ============================================================== -->
<g id="swarm">
<rect x="340" y="90" width="720" height="780" rx="12" fill="none" stroke="#fbbf24" stroke-width="1" stroke-dasharray="8 4" fill-opacity="0"/>
<text x="360" y="115" fill="#fbbf24" font-size="11" font-weight="bold">DOCKER SWARM CLUSTER</text>
<!-- ============================================================ -->
<!-- Node: odroid (manager) -->
<!-- ============================================================ -->
<rect x="360" y="135" width="680" height="500" rx="10" fill="none" stroke="#fbbf24" stroke-width="1.5" fill-opacity="0"/>
<text x="380" y="160" fill="#fef3c7" font-size="12" font-weight="bold">Node: odroid (manager)</text>
<text x="380" y="176" fill="#94a3b8" font-size="10">192.168.1.96 · arm64 · Linux 5.15 · id=j9bljgaqh9qc</text>
<!-- Swarm ingress-endpoint -->
<rect x="380" y="195" width="180" height="50" rx="6" fill="#064e3b" stroke="#34d399" stroke-width="1.5"/>
<text x="470" y="215" text-anchor="middle" fill="#d1fae5" font-size="12" font-weight="bold">swarm ingress</text>
<text x="470" y="230" text-anchor="middle" fill="#a7f3d0" font-size="10">10.0.0.2</text>
<text x="470" y="241" text-anchor="middle" fill="#a7f3d0" font-size="9">(routing mesh)</text>
<!-- Stack boxes -->
<text x="380" y="275" fill="#22d3ee" font-size="11" font-weight="bold">STACKS</text>
<!-- gitea -->
<rect x="380" y="290" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="460" y="310" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">gitea</text>
<text x="460" y="326" text-anchor="middle" fill="#cffafe" font-size="9">gitea_server (3000)</text>
<text x="460" y="338" text-anchor="middle" fill="#cffafe" font-size="9">gitea_runner</text>
<text x="460" y="352" text-anchor="middle" fill="#cffafe" font-size="9">gitea_gitea 10.0.17/24</text>
<text x="460" y="364" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.235</text>
<!-- hermes -->
<rect x="555" y="290" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="635" y="310" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">hermes</text>
<text x="635" y="326" text-anchor="middle" fill="#cffafe" font-size="9">hermes-agent</text>
<text x="635" y="338" text-anchor="middle" fill="#cffafe" font-size="9">hermes-gateway</text>
<text x="635" y="352" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.204</text>
<!-- hermes_infra -->
<rect x="730" y="290" width="160" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="810" y="310" text-anchor="middle" fill="#cffafe" font-size="11" font-weight="bold">hermes_infra</text>
<text x="810" y="324" text-anchor="middle" fill="#cffafe" font-size="8">squid · sarg · hermes-ui</text>
<text x="810" y="335" text-anchor="middle" fill="#cffafe" font-size="8">docker_socket_proxy</text>
<text x="810" y="346" text-anchor="middle" fill="#cffafe" font-size="8">brencher-state-proxy</text>
<!-- immich -->
<rect x="905" y="290" width="115" height="80" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="962" y="310" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">immich</text>
<text x="962" y="326" text-anchor="middle" fill="#cffafe" font-size="9">server · db</text>
<text x="962" y="338" text-anchor="middle" fill="#cffafe" font-size="9">redis · ml</text>
<text x="962" y="352" text-anchor="middle" fill="#cffafe" font-size="9">10.0.2.0/24</text>
<!-- brencher -->
<rect x="380" y="390" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="460" y="410" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">brencher · brencher2</text>
<text x="460" y="426" text-anchor="middle" fill="#cffafe" font-size="9">deploy tools</text>
<text x="460" y="438" text-anchor="middle" fill="#cffafe" font-size="9">ingress: 10.0.0.105</text>
<text x="460" y="450" text-anchor="middle" fill="#cffafe" font-size="9"> 10.0.0.102</text>
<!-- gmail_mcp -->
<rect x="555" y="390" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="635" y="410" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">gmail_mcp</text>
<text x="635" y="426" text-anchor="middle" fill="#cffafe" font-size="9">gmail-mcp-server</text>
<text x="635" y="438" text-anchor="middle" fill="#cffafe" font-size="9">telegram-mcp-server</text>
<text x="635" y="450" text-anchor="middle" fill="#cffafe" font-size="9">10.0.0.6 / 10</text>
<!-- torrserv_proxy -->
<rect x="730" y="390" width="160" height="70" rx="6" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1.5"/>
<text x="810" y="410" text-anchor="middle" fill="#cffafe" font-size="12" font-weight="bold">torrserv_proxy</text>
<text x="810" y="426" text-anchor="middle" fill="#cffafe" font-size="9">reverseproxy</text>
<text x="810" y="438" text-anchor="middle" fill="#cffafe" font-size="9">fileserver</text>
<!-- Dead: nginx_nginx -->
<rect x="380" y="500" width="280" height="50" rx="6" fill="#1f1717" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="6 3"/>
<text x="520" y="520" text-anchor="middle" fill="#fecaca" font-size="12" font-weight="bold">nginx_nginx (dead)</text>
<text x="520" y="535" text-anchor="middle" fill="#fecaca" font-size="9">jwilder/nginx-proxy · Replicas: 0</text>
<text x="520" y="546" text-anchor="middle" fill="#fecaca" font-size="9">контейнеров нет, overlay-сеть nginx_ingress жива</text>
<!-- ============================================================ -->
<!-- Node: xu4 (worker) -->
<!-- ============================================================ -->
<rect x="360" y="660" width="680" height="180" rx="10" fill="none" stroke="#fbbf24" stroke-width="1.5" fill-opacity="0"/>
<text x="380" y="685" fill="#fef3c7" font-size="12" font-weight="bold">Node: xu4 (worker)</text>
<text x="380" y="700" fill="#94a3b8" font-size="10">id=u2ynmimtl0lu</text>
<rect x="500" y="725" width="400" height="60" rx="6" fill="#0f172a" stroke="#fbbf24" stroke-width="1.5" fill-opacity="0.5"/>
<text x="700" y="750" text-anchor="middle" fill="#fbbf24" font-size="12" font-weight="bold">worker tasks</text>
<text x="700" y="767" text-anchor="middle" fill="#94a3b8" font-size="10">(пусто в снапшоте 2026-08-27 — перепроверить)</text>
</g>
<!-- ============================================================== -->
<!-- Legend (внизу, за пределами swarm-boundary) -->
<!-- ============================================================== -->
<g id="legend">
<rect x="40" y="660" width="260" height="180" rx="8" fill="#0f172a" stroke="#334155" stroke-width="1"/>
<text x="60" y="685" fill="#e2e8f0" font-size="11" font-weight="bold">LEGEND</text>
<rect x="60" y="700" width="20" height="14" rx="3" fill="#1e293b" stroke="#94a3b8" stroke-width="1"/>
<text x="90" y="711" fill="#cbd5e1" font-size="10">external</text>
<rect x="60" y="720" width="20" height="14" rx="3" fill="#0f172a" stroke="#fbbf24" stroke-width="1"/>
<text x="90" y="731" fill="#cbd5e1" font-size="10">node</text>
<rect x="60" y="740" width="20" height="14" rx="3" fill="#0c4a6e" stroke="#22d3ee" stroke-width="1"/>
<text x="90" y="751" fill="#cbd5e1" font-size="10">stack</text>
<rect x="60" y="760" width="20" height="14" rx="3" fill="#064e3b" stroke="#34d399" stroke-width="1"/>
<text x="90" y="771" fill="#cbd5e1" font-size="10">edge / routing</text>
<rect x="60" y="780" width="20" height="14" rx="3" fill="#1f1717" stroke="#fb7185" stroke-width="1" stroke-dasharray="3 2"/>
<text x="90" y="791" fill="#cbd5e1" font-size="10">dead / disabled</text>
<line x1="60" y1="810" x2="80" y2="810" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="90" y="814" fill="#cbd5e1" font-size="10">solid arrow = flow</text>
<line x1="60" y1="828" x2="80" y2="828" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<text x="90" y="832" fill="#cbd5e1" font-size="10">dashed arrow = deploy</text>
</g>
<!-- ============================================================== -->
<!-- Arrows (drawn LAST so they appear on top of fills, but routed through clear gaps) -->
<!-- ============================================================== -->
<!-- Keenetic → swarm ingress -->
<path d="M 280 217 L 360 217" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="290" y="210" fill="#cbd5e1" font-size="9">plain HTTP</text>
<text x="290" y="222" fill="#cbd5e1" font-size="9">post TLS term</text>
<!-- swarm ingress → gitea -->
<path d="M 470 245 L 470 290" fill="none" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#arrow)"/>
<text x="475" y="265" fill="#cbd5e1" font-size="9">to gitea_server</text>
<!-- swarm ingress → immich -->
<path d="M 540 220 Q 750 220 962 290" fill="none" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#arrow)"/>
<!-- swarm ingress → hermes -->
<path d="M 530 215 Q 600 240 635 290" fill="none" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#arrow)"/>
<!-- brencher → gitea (deploy) -->
<path d="M 460 390 L 460 370" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<text x="465" y="382" fill="#fb7185" font-size="9">deploys</text>
<!-- brencher → immich (deploy) -->
<path d="M 540 420 Q 700 420 962 380" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<text x="700" y="412" fill="#fb7185" font-size="9">deploys</text>
<!-- brencher → hermes_infra (deploy) -->
<path d="M 540 425 Q 680 460 810 370" fill="none" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#arrow-dashed)"/>
<!-- nginx_nginx → ingress (dead, dashed) -->
<path d="M 520 500 L 520 245" fill="none" stroke="#fb7185" stroke-width="1" stroke-dasharray="4 3" stroke-opacity="0.5" marker-end="url(#arrow-dashed)"/>
<text x="528" y="400" fill="#fb7185" font-size="9" stroke-opacity="0.6">overlay-сеть жива,<br/>контейнеров нет</text>
<!-- Footer note -->
<text x="40" y="880" fill="#475569" font-size="10">
generated 2026-08-27 · sources: docker_socket_proxy + gitea admin API · single file, no external deps
</text>
</svg>

Before

Width:  |  Height:  |  Size: 15 KiB

-75
View File
@@ -1,75 +0,0 @@
# Production architecture (SVG-embedded variant)
> Этот файл — **вариант №4**: SVG-картинка, встроенная в Markdown.
> Выбери этот вариант если хочешь чтобы диаграмма была видна прямо в README/PR preview,
> но при этом SVG-файл лежал отдельно и его можно было экспортировать/редактировать независимо.
## Как это работает
```markdown
![Production architecture](./standalone.svg)
```
Gitea 1.27 (наш self-hosted) рендерит это как `<img src="standalone.svg">` — SVG отображается
как картинка, можно зумить и качать правой кнопкой.
## Диаграмма
![Production architecture](./standalone.svg)
## Плюсы / минусы этого подхода
**+** Файл `.md` остаётся читаемым (одна строчка `![alt](path)`).
**+** SVG-файл редактируется отдельно — diff читаемый в обоих файлах.
**+** Работает в любом markdown-рендерере (Gitea, GitHub, GitLab, VS Code preview).
**+** SVG можно переиспользовать в `standalone.html`, в slack, в презентации.
**-** В Gitea preview SVG рендерится как картинка, не inline. Чтобы изменить — нужно править `standalone.svg`.
**-** Размер preview в PR фиксированный (по умолчанию Gitea ресайзит большие SVG до 800px по ширине).
## Альтернативы (если этот не зайдёт)
### Inline SVG прямо в .md
Вместо ссылки можно вставить весь SVG в файл:
```html
<details>
<summary>Inline SVG (нажми чтобы раскрыть)</summary>
<svg viewBox="0 0 1400 900" xmlns="http://www.w3.org/2000/svg">
...весь SVG здесь...
</svg>
</details>
```
**+** Можно зумить, выделять элементы прямо в Gitea UI.
**-** Файл `.md` раздувается до сотен строк SVG-кода.
**-** Diff нечитаемый — каждое изменение в geometry ломает review.
**-** Дублирование: один и тот же SVG в двух местах репо.
### HTML `<img>` вместо markdown
```html
<img src="./standalone.svg" alt="Production architecture" width="100%">
```
**+** Можно управлять размером (`width`, `height`).
**-** Ничего не даёт по сравнению с markdown-вариантом в Gitea 1.27.
## Где какой вариант использовать
| Сценарий | Рекомендация |
|---|---|
| README на главной странице репо | `![arch](path.svg)` — этот файл |
| PR preview в Gitea | `![arch](path.svg)` работает в "Files changed" → preview |
| Wiki-страница | `![arch](path.svg)` |
| Внешний share (email, slack) | `standalone.svg` как attachment |
| Презентация / документ | `standalone.html` (открыть в браузере) |
| PR-описание | `standalone.svg` как attachment в комментарий |
## Связанные файлы
- `mermaid.md` — вариант с Mermaid flowchart
- `standalone.svg` — собственно SVG-файл, на который ссылается этот .md
- `standalone.html` — HTML-обёртка с inline SVG и summary cards
- `README.md` — обзор всех вариантов
-119
View File
@@ -1,119 +0,0 @@
# Production architecture (inline SVG variant)
> **Вариант №6:** SVG **целиком inline** в markdown, обёрнут в `<details>` чтобы md-файл
> остался читаемым. Раскрываешь — видишь интерактивный SVG с возможностью зума.
## Зачем
- SVG можно зумить в браузере (Ctrl+Scroll)
- Можно выделять элементы, copy-paste текст
- Нет зависимости от внешнего файла
<details>
<summary>📊 Click to expand inline SVG (snapshot 2026-08-27)</summary>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 700" font-family="ui-monospace, SFMono-Regular, monospace" font-size="11">
<title>Production architecture (compact)</title>
<rect width="800" height="700" fill="#020617"/>
<!-- External -->
<rect x="20" y="20" width="160" height="160" rx="10" fill="#1e293b" fill-opacity="0.5" stroke="#94a3b8" stroke-width="1"/>
<text x="100" y="40" text-anchor="middle" fill="#94a3b8" font-size="10" font-weight="bold">EXTERNAL</text>
<ellipse cx="100" cy="80" rx="60" ry="22" fill="#1e293b" stroke="#94a3b8"/>
<text x="100" y="85" text-anchor="middle" fill="#e2e8f0" font-size="11">Client</text>
<rect x="30" y="120" width="65" height="40" rx="5" fill="#0f172a" stroke="#94a3b8"/>
<text x="62" y="140" text-anchor="middle" fill="#e2e8f0" font-size="10">Tailscale</text>
<rect x="105" y="120" width="65" height="40" rx="5" fill="#0f172a" stroke="#94a3b8"/>
<text x="137" y="140" text-anchor="middle" fill="#e2e8f0" font-size="10">Keenetic</text>
<!-- Swarm -->
<rect x="210" y="20" width="570" height="660" rx="12" fill="none" stroke="#fbbf24" stroke-dasharray="8 4"/>
<text x="495" y="40" text-anchor="middle" fill="#fbbf24" font-size="10" font-weight="bold">DOCKER SWARM CLUSTER</text>
<!-- odroid node -->
<rect x="230" y="55" width="540" height="400" rx="8" fill="none" stroke="#fbbf24"/>
<text x="500" y="75" text-anchor="middle" fill="#fef3c7" font-size="11" font-weight="bold">odroid (manager) · 192.168.1.96</text>
<!-- ingress -->
<rect x="250" y="95" width="120" height="40" rx="5" fill="#064e3b" stroke="#34d399"/>
<text x="310" y="115" text-anchor="middle" fill="#d1fae5" font-size="11" font-weight="bold">swarm ingress</text>
<text x="310" y="128" text-anchor="middle" fill="#a7f3d0" font-size="9">10.0.0.2</text>
<!-- Stack boxes -->
<g fill="#0c4a6e" stroke="#22d3ee">
<rect x="250" y="155" width="120" height="60" rx="5"/>
<rect x="385" y="155" width="120" height="60" rx="5"/>
<rect x="520" y="155" width="120" height="60" rx="5"/>
<rect x="655" y="155" width="105" height="60" rx="5"/>
<rect x="250" y="230" width="120" height="55" rx="5"/>
<rect x="385" y="230" width="120" height="55" rx="5"/>
<rect x="520" y="230" width="120" height="55" rx="5"/>
</g>
<g fill="#cffafe" text-anchor="middle" font-size="10">
<text x="310" y="175" font-weight="bold">gitea</text>
<text x="310" y="190" font-size="8">server · runner</text>
<text x="310" y="202" font-size="8">.235 / .17.13</text>
<text x="445" y="175" font-weight="bold">hermes</text>
<text x="445" y="190" font-size="8">agent · gateway</text>
<text x="445" y="202" font-size="8">.204</text>
<text x="580" y="175" font-weight="bold">hermes_infra</text>
<text x="580" y="186" font-size="8">squid · sarg</text>
<text x="580" y="196" font-size="8">docker_proxy</text>
<text x="580" y="208" font-size="8">brencher-state</text>
<text x="707" y="175" font-weight="bold">immich</text>
<text x="707" y="190" font-size="8">server · db</text>
<text x="707" y="202" font-size="8">redis · ml</text>
<text x="310" y="250" font-weight="bold">brencher</text>
<text x="310" y="265" font-size="8">.105 / .102</text>
<text x="310" y="277" font-size="8">deploys ↓</text>
<text x="445" y="250" font-weight="bold">gmail_mcp</text>
<text x="445" y="265" font-size="8">gmail · tg</text>
<text x="445" y="277" font-size="8">.6 / .10</text>
<text x="580" y="250" font-weight="bold">torrserv</text>
<text x="580" y="265" font-size="8">proxy · fs</text>
<text x="580" y="277" font-size="8">.15 / .12</text>
</g>
<!-- dead -->
<rect x="250" y="305" width="380" height="50" rx="5" fill="#1f1717" stroke="#fb7185" stroke-dasharray="6 3"/>
<text x="440" y="325" text-anchor="middle" fill="#fecaca" font-size="11" font-weight="bold">nginx_nginx (dead) · Replicas: 0</text>
<text x="440" y="340" text-anchor="middle" fill="#fecaca" font-size="9">jwilder/nginx-proxy · overlay-сеть nginx_ingress жива</text>
<text x="440" y="351" text-anchor="middle" fill="#fecaca" font-size="9">контейнеров нет</text>
<!-- xu4 worker -->
<rect x="230" y="475" width="540" height="180" rx="8" fill="none" stroke="#fbbf24"/>
<text x="500" y="495" text-anchor="middle" fill="#fef3c7" font-size="11" font-weight="bold">xu4 (worker)</text>
<rect x="320" y="525" width="360" height="50" rx="5" fill="#0f172a" stroke="#fbbf24" fill-opacity="0.5"/>
<text x="500" y="548" text-anchor="middle" fill="#fbbf24" font-size="11" font-weight="bold">worker tasks</text>
<text x="500" y="563" text-anchor="middle" fill="#94a3b8" font-size="9">(пусто в снапшоте 2026-08-27)</text>
<!-- Arrows -->
<defs>
<marker id="a" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto">
<path d="M 0 0 L 10 5 L 0 10 z" fill="#cbd5e1"/>
</marker>
</defs>
<line x1="170" y1="140" x2="210" y2="115" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#a)"/>
<line x1="310" y1="135" x2="310" y2="155" stroke="#cbd5e1" stroke-width="1.5" marker-end="url(#a)"/>
<line x1="310" y1="135" x2="445" y2="155" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#a)"/>
<line x1="310" y1="135" x2="707" y2="155" stroke="#cbd5e1" stroke-width="1" stroke-opacity="0.4" marker-end="url(#a)"/>
<line x1="310" y1="215" x2="310" y2="230" stroke="#fb7185" stroke-width="1.5" stroke-dasharray="4 3" marker-end="url(#a)"/>
<text x="40" y="700" fill="#475569" font-size="9">compact inline variant · same data as standalone.svg</text>
</svg>
</details>
## Плюсы / минусы
**+** Можно зумить, выделять элементы прямо в Gitea preview.
**+** Нет зависимости от внешнего файла (один .md — всё в нём).
**+** Спасает если SVG-файл случайно удалят.
**-** `.md` файл становится в ~2 раза длиннее.
**-** Diff нечитаемый — каждое изменение в geometry SVG ломает review.
**-** Дублирование данных: один и тот же граф в standalone.svg И в этом .md.
## Когда использовать
- Хочешь чтобы диаграмма точно была видна даже если файл `standalone.svg` случайно удалят
- Превью в PR preview без загрузки внешних ресурсов
- Когда диаграмма маленькая и diff читаемый
-45
View File
@@ -1,45 +0,0 @@
# Production architecture (`<object>` variant)
> **Вариант №7:** использует `<object data="..." type="image/svg+xml">` вместо `<img>`.
> Семантически отличается — `<object>` это embeded content, не изображение.
## Что это даёт по сравнению с `<img>`
| Свойство | `<img src="x.svg">` | `<object data="x.svg">` |
|---|---|---|
| В Gitea preview | рендерится как image | **вырезается** санитайзером (проверено через `/api/v1/markdown`) |
| Можно зумить в браузере | да | да |
| Загружает CSS внутри SVG | да | да |
| Загружает `<script>` внутри SVG | **нет** (XSS protection) | **да** (если SVG не sandboxed) |
| Fallback content | через `alt` атрибут | через `<object>...fallback...</object>` |
> **⚠️ ВАЖНО:** Gitea 1.27 вырезает `<object>` через goldmark санитайзер.
> Этот вариант **не работает** в нашем Gitea UI, но может работать в других рендерерах
> (GitHub, GitLab, Obsidian). Оставлен для сравнения.
## Диаграмма
<object data="./standalone.svg" type="image/svg+xml" width="1200" style="max-width:100%;">
Your browser does not support SVG embedding via &lt;object&gt;.
<a href="./standalone.svg">Download SVG file</a> instead.
</object>
## Плюсы / минусы
**+** Семантически правильнее для «embedded content» (SVG это не просто image, это документ).
**+** Можно использовать fallback-контент (текст, ссылка на скачивание).
**-** В Gitea preview может рендериться иначе (например, с дополнительным border/background).
**-** Если хочешь SVG-фильтры/анимации — может работать не так как `<img>`.
**-** Минимальная практическая разница для статичных диаграмм.
## Когда использовать
- Когда SVG содержит интерактивные элементы (анимация, hover)
- Когда хочешь fallback для старых браузеров
- В остальных случаях `<img>` проще и работает идентично
## Связанные
- `svg-embedded.md` — `<img>` без sizing
- `svg-sized.md` — `<img>` с sizing
- `svg-inline.md` — inline SVG в `<details>`
-47
View File
@@ -1,47 +0,0 @@
# Production architecture (sized SVG variant)
> **Вариант №5:** SVG-картинка в Markdown, но с **контролем размера** через HTML-тег `<img>`.
> Полезно если хочется ограничить максимальную ширину или принудительно растянуть.
## Чем отличается от svg-embedded.md
`svg-embedded.md` использует чистый markdown `![arch](path.svg)` — Gitea сама решает
как ресайзить. Здесь я явно указываю размеры:
```html
<img src="./standalone.svg" alt="Production architecture" width="1200" />
```
## Диаграмма (фиксированная ширина 1200px)
<img src="./standalone.svg" alt="Production architecture" width="1200" />
## Альтернативный вариант (responsive через width=100%)
```html
<img src="./standalone.svg" alt="Production architecture" width="100%" />
```
> **Примечание:** Gitea 1.27 санитизирует `style="..."` атрибуты через goldmark.
> Поэтому `style="max-width:100%; height:auto;"` **не сработает** — атрибут будет вырезан.
> Вместо этого использую `width="100%"` — это тоже работает и переживает санитайзер.
<img src="./standalone.svg" alt="Production architecture" width="100%" />
## Плюсы / минусы
**+** Контроль над размером — большие SVG не раздувают preview.
**+** `max-width:100%` — адаптивно для мобильных.
**-** Это HTML в Markdown — некоторые plain-MD рендереры не поймут.
**-** Если указать фиксированный `width` слишком маленьким, SVG потеряет читаемость.
## Когда использовать
- Большие диаграммы (2000+ px) — фиксируй `max-width:1000px`
- Маленькие диаграммы — `width="600"` чтобы не было мелко
- Когда хочешь чтобы SVG растягивался в широких preview — `style="max-width:100%; height:auto;"`
## Связанные файлы
- `svg-embedded.md` — простой markdown вариант без sizing
- `standalone.svg` — собственно файл