From 3ae7321865854a1b9abd2e12f1fed511993adac0 Mon Sep 17 00:00:00 2001 From: Christoph Emsenhuber Date: Mon, 15 Jun 2026 10:45:42 +0200 Subject: [PATCH] CLAUDE.md: auto-geladener Session-Kontext (VLAN, HW, Tooling, Gotchas) Ersetzt manuelles Referenzieren von Zusatzdateien beim Sessionstart. HANDOVER.md als Archiv-Dokument markiert; teilprojekte.md bleibt kanonisch. Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++ HANDOVER.md | 4 ++-- 2 files changed, 57 insertions(+), 2 deletions(-) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..1ff6adf --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,55 @@ +# BF-Netzwerk — Projekt-Kontext (auto-read) + +**Standort BF:** VLAN-segmentiertes Heimnetz auf MikroTik/RouterOS. Ziel: CAKE/QoS gegen Bufferbloat, +DNS/DHCP-Ablösung, WLAN via CAPsMAN, Firewall Least-Privilege, Multi-Site VPN. + +**Für jede TP-Session: zuerst `docs/teilprojekte.md` lesen** — enthält kanonischen Stand, Scope, Abhängigkeiten +und Reihenfolge aller Teilprojekte. Kein anderer Kontext nötig. + +--- + +## VLAN-Modell (kanonisch) +| VLAN | Name | Subnetz | Zweck | +|---|---|---|---| +| 10 | MAIN | 10.40.10.0/24 | Trusted (Handy/Laptop) | +| 20 | INFRA | 10.40.20.0/24 | NAS/VMs/Docker/HA | +| 30 | IOT | 10.40.30.0/24 | Smart-Home | +| 40 | MEDIA | 10.40.40.0/24 | Sonos/AppleTV/TV/Cast | +| 50 | UNTRUSTED | 10.40.50.0/24 | Konsole/Low-Trust | +| 90 | GUEST | 10.40.90.0/24 | nur Internet | +| 99 | MGMT | 10.40.99.0/24 | Switch/AP/Hypervisor-Mgmt | +| 100 | WAN | (FB-Transfer) | zur FritzBox | + +GW je VLAN = `.1` · APs: ap1=`.1`, ap2=`.2` · Switches: ALLNET=`.11`, Omada=`.12` + +--- + +## Hardware & Zugang +| Gerät | IP | Zugang | +|---|---|---| +| ALLNET Core-Switch (sw1) | 10.40.41.239 (interim) | `telnet 10.40.41.239` · User: `claudecode` · PW: `switch/.secrets` | +| hAP ax² #1 (ap1) | 10.40.41.1 | MikroMCP (live) | +| hAP ax² #2 (ap2) | 10.40.41.2 | MikroMCP (live) | +| NAS (nas-bf) | 10.40.41.10 | SSH | +| pve (Mac mini) | 10.40.41.167 | `ssh 10.40.41.167` | +| FritzBox 6660 | 10.40.41.254 | Web-UI (Telefon bleibt dort) | + +--- + +## Tooling +- **MikroTik (hAP ax²):** MikroMCP-Server live verbunden → `mcp__mikromcp__*`-Tools verwenden. + Reads immer safe; Writes mit `dryRun:true` previwen, dann `apply_plan`. +- **ALLNET-Switch:** kein MCP — nur Telnet-CLI (IOS-artig, FW 2.2.1). Runner: + `cd ~/dev/bf-network-r6/switch && . ./.secrets && expect cli/run-cli.exp cli/.cli` + Klickanleitungen in `switch/ui-guides/` für manuelle Schritte. +- **Omada-Switch:** noch standalone, kein Controller; Creds in `omada/.secrets`. + +--- + +## Kritische Gotchas +- **ALLNET: nur 1 Telnet-VTY** — stale Sessions blockieren ~15 min. Sauber ausloggen (`exit exit`), nie hammern. +- **`save` nicht vergessen** nach ALLNET-Änderungen (sonst nach Reboot weg). +- **hAP ax² hat 128 MB Flash, kein USB** → Container NICHT auf dem Router; Container laufen auf NAS/pve. +- **ALLNET vlan40 heißt noch UNTRUSTED (alt)** — beim nächsten Switch-Schritt umbenennen zu MEDIA + vlan50 anlegen. +- **Mesh = NEIN** (beide APs haben wired Trunk-Uplink → Loop-Risiko). +- mgmt-VLAN-Wechsel am Switch = Lockout-Risiko: VLAN muss existieren + Port muss es tragen, in einem Schritt. diff --git a/HANDOVER.md b/HANDOVER.md index 44ddf88..91a7484 100644 --- a/HANDOVER.md +++ b/HANDOVER.md @@ -1,7 +1,7 @@ # BF-Netzwerk — Übergabe (Netzwerk · Routing · VLAN · Sprachtelefonie) -> **Single Source of Truth** für die Nachfolge-Session. Diese übernimmt **Implementierung** (jetzt Phase A) -> **und die weitere Planung** (Phasen B–D + Backlog). Alles Nötige steht hier; tiefere Historie nur als Referenz. +> **Archiv-Dokument** (Stand: Phase A abgeschlossen). Aktuelle Projektsteuerung → `docs/teilprojekte.md`. +> Session-Kontext → `CLAUDE.md` (wird automatisch geladen). > > **Referenzen (Historie, optional):** Ursprungs-Vergleich `~/.claude/plans/welche-kosteng-nstigen-alternativen-zu-memoized-sparkle.md` · > Projekt-Memory `project_bf_network_r6` · Repo `~/dev/bf-network-r6/` (Git).