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 <noreply@anthropic.com>
This commit is contained in:
55
CLAUDE.md
Normal file
55
CLAUDE.md
Normal file
@@ -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/<datei>.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.
|
||||
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user