From 27fe9c078e55981c7fb4d043c3b86c5d88310657 Mon Sep 17 00:00:00 2001 From: windyboy Date: Sat, 22 Aug 2026 19:34:05 +0800 Subject: [PATCH] docs: archive historical planning documents and fix references Move self-described historical/upstream docs to docs/archive/: - agent-runbook-guide.md - lan-core-switch-upgrade-plan.md - lan-rb5009-upgrade.md - se5420-review-claim-verification-2026-08.md Update archive/README.md manifest and fix relative links in active docs and archived docs. Update AGENTS.md docs/ layout description. --- AGENTS.md | 2 +- RUNBOOKS.md | 2 +- docs/archive/README.md | 4 ++++ docs/{ => archive}/agent-runbook-guide.md | 2 +- .../lan-core-switch-upgrade-plan.md | 20 +++++++++---------- docs/{ => archive}/lan-rb5009-upgrade.md | 12 +++++------ ...e5420-review-claim-verification-2026-08.md | 2 +- docs/lan-erx-se5420-network.md | 2 +- docs/lan-overview.md | 2 +- docs/lan-se5420-deployment-guide.md | 6 +++--- 10 files changed, 29 insertions(+), 25 deletions(-) rename docs/{ => archive}/agent-runbook-guide.md (98%) rename docs/{ => archive}/lan-core-switch-upgrade-plan.md (91%) rename docs/{ => archive}/lan-rb5009-upgrade.md (97%) rename docs/{ => archive}/se5420-review-claim-verification-2026-08.md (96%) diff --git a/AGENTS.md b/AGENTS.md index b373a5f..5468f3b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -165,6 +165,6 @@ ansible/ # playbooks, roles, sanitized control-plane inventory compose/ # repo-owned non-secret Compose sources (+ .env.example) hosts/ # per-host facts runbooks/ # step-by-step ops (README.md = index, _template.md = template) -docs/ # upstream doc indexes / design notes +docs/ # upstream refs / design notes / research records (active + archive/) scripts/validate-repo.sh # repo-wide validation (run before merging) ``` diff --git a/RUNBOOKS.md b/RUNBOOKS.md index f8a4423..ec9b52e 100644 --- a/RUNBOOKS.md +++ b/RUNBOOKS.md @@ -1,6 +1,6 @@ # RUNBOOKS — 仓库级规范 -本文件统一所有 Runbook 的字段、命名、评审与变更规则。上游参考：[docs/agent-runbook-guide.md](docs/agent-runbook-guide.md)。 +本文件统一所有 Runbook 的字段、命名、评审与变更规则。上游参考：[docs/archive/agent-runbook-guide.md](docs/archive/agent-runbook-guide.md)。 ## 目录结构 diff --git a/docs/archive/README.md b/docs/archive/README.md index f4accc0..16d3b0a 100644 --- a/docs/archive/README.md +++ b/docs/archive/README.md @@ -8,6 +8,10 @@ | 文件 | 归档日期 | 原位置 | 说明 | |------|---------|--------|------| | `lan-dns-alternatives.md` | 2026-08-17 | `docs/` | DNS 技术选型调研，零引用，无在途决策 | +| `agent-runbook-guide.md` | 2026-08-22 | `docs/` | 上游参考存档；仓库落地规范为 `RUNBOOKS.md` | +| `lan-core-switch-upgrade-plan.md` | 2026-08-22 | `docs/` | SE5420 历史规划参考；执行以 `docs/lan-se5420-deployment-guide.md` 为准 | +| `lan-rb5009-upgrade.md` | 2026-08-22 | `docs/` | 未采购的 ER-X→RB5009 休眠备选方案；其中 PVE 透传与 VLAN10 调研仍可参考 | +| `se5420-review-claim-verification-2026-08.md` | 2026-08-22 | `docs/` | 一次性评审复核调研（现场只读复核结论） | > 购物类文档（打印机购买指南、交换机选型调研）已按整改计划移入 Obsidian > vault（`~/Documents/vault/my-vault/02_Areas/House/`），不在本目录。 diff --git a/docs/agent-runbook-guide.md b/docs/archive/agent-runbook-guide.md similarity index 98% rename from docs/agent-runbook-guide.md rename to docs/archive/agent-runbook-guide.md index cd07382..d49c71b 100644 --- a/docs/agent-runbook-guide.md +++ b/docs/archive/agent-runbook-guide.md @@ -2,7 +2,7 @@ > **定位**：本指南用于把团队的重复性运维、交付与故障处理经验写成可由 Agent 安全执行的流程。它适用于以 Git 仓库为中心的工程协作模式，优先采用 **Markdown + Git 版本控制 + 明确的 Agent 路由规则**，而不是一开始引入复杂的自动化平台。 -> 本文件为上游参考存档。仓库内落地规范见 [`RUNBOOKS.md`](../RUNBOOKS.md)，标准模板见 [`runbooks/_template.md`](../runbooks/_template.md)，索引见 [`runbooks/README.md`](../runbooks/README.md)。 +> 本文件为上游参考存档。仓库内落地规范见 [`RUNBOOKS.md`](../../RUNBOOKS.md)，标准模板见 [`runbooks/_template.md`](../../runbooks/_template.md)，索引见 [`runbooks/README.md`](../../runbooks/README.md)。 ## 1. 什么是 Agent Runbook diff --git a/docs/lan-core-switch-upgrade-plan.md b/docs/archive/lan-core-switch-upgrade-plan.md similarity index 91% rename from docs/lan-core-switch-upgrade-plan.md rename to docs/archive/lan-core-switch-upgrade-plan.md index 31dca61..6cafefb 100644 --- a/docs/lan-core-switch-upgrade-plan.md +++ b/docs/archive/lan-core-switch-upgrade-plan.md @@ -1,13 +1,13 @@ # LAN 核心交换机升级计划（保留 ER-X） -**状态：** SE5420 **已采购**（2026-08-09）。**实施与验证以 [lan-se5420-deployment-guide.md](lan-se5420-deployment-guide.md) 为准**； +**状态：** SE5420 **已采购**（2026-08-09）。**实施与验证以 [lan-se5420-deployment-guide.md](../lan-se5420-deployment-guide.md) 为准**； 本文为历史规划参考，**不得作为现场执行步骤**；所有实际操作均以部署指南为准。 **锁定硬件：** TP-Link **`TL-SE5420`**（16 × 2.5GbE RJ45 + 4 × 10GbE SFP+）。 **目标：** SE5420 承接全部 LAN 物理接入与二层转发；ER-X 继续承担公网、NAT、防火墙、 LAN66/LAN55 网关与 DHCP。 **拓扑与流量的详细说明**（职责、逻辑网、流量路径、Wi-Fi 分工、验收边界）见： -[lan-erx-se5420-network.md](lan-erx-se5420-network.md)。 +[lan-erx-se5420-network.md](../lan-erx-se5420-network.md)。 SE5420 官方资料：静态功耗 8 W、最大功耗 32 W；VLAN、LACP、STP/RSTP/MSTP、ACL、 CLI/SNMP、配置导入导出与固件下载。无 PoE——AP 使用本地取电 + 普通网线。 @@ -65,7 +65,7 @@ VLAN tag。 ``` 完整端口表、流量路径与 Wi-Fi 分工见 -[lan-erx-se5420-network.md](lan-erx-se5420-network.md)。 +[lan-erx-se5420-network.md](../lan-erx-se5420-network.md)。 ## VLAN 与端口设计 @@ -124,8 +124,8 @@ VLAN tag。 ### 阶段 4：VLAN10 升级专用 Wi-Fi（独立项目） 不与本次 Done 捆绑。仅 U6；网关 `gfw`；详见 -[lan-erx-se5420-network.md](lan-erx-se5420-network.md) 第 6.5 / 8 节与 -[unifi-network.md](unifi-network.md)。 +[lan-erx-se5420-network.md](../lan-erx-se5420-network.md) 第 6.5 / 8 节与 +[unifi-network.md](../unifi-network.md)。 ## 性能预期与不变瓶颈 @@ -148,9 +148,9 @@ VLAN tag。 ## 参考 -- [ER-X + SE5420 网络与拓扑说明](lan-erx-se5420-network.md) -- [LAN 概览](lan-overview.md) -- [ER-X 配置记录](edgerouter-x-configuration.md) -- [UniFi 网络](unifi-network.md) -- [`gfw`](../hosts/gfw.windy.lan.md) +- [ER-X + SE5420 网络与拓扑说明](../lan-erx-se5420-network.md) +- [LAN 概览](../lan-overview.md) +- [ER-X 配置记录](../edgerouter-x-configuration.md) +- [UniFi 网络](../unifi-network.md) +- [`gfw`](../../hosts/gfw.windy.lan.md) - [TL-SE5420 官方规格](https://www.tp-link.com.cn/product_2899.html?v=specification) diff --git a/docs/lan-rb5009-upgrade.md b/docs/archive/lan-rb5009-upgrade.md similarity index 97% rename from docs/lan-rb5009-upgrade.md rename to docs/archive/lan-rb5009-upgrade.md index 3e8f187..e647883 100644 --- a/docs/lan-rb5009-upgrade.md +++ b/docs/archive/lan-rb5009-upgrade.md @@ -2,7 +2,7 @@ **状态：** 规划文档（未采购、未接线、未改生产配置）。 **重要变更（2026-08-09）：** **SE5420 已采购**，网络升级改为「保留 ER-X + SE5420 核心」路径—— -实施与验证以 [lan-se5420-deployment-guide.md](lan-se5420-deployment-guide.md) 为准。 +实施与验证以 [lan-se5420-deployment-guide.md](../lan-se5420-deployment-guide.md) 为准。 本文保留为「ER-X 网关未来替换为 RB5009」的备选方案；其中 PVE 透传调研与 VLAN10 实现方法仍适用。 --- @@ -389,9 +389,9 @@ logread -e netifd ## 8. 参考 -- 现网地图：[lan-overview.md](lan-overview.md) -- ER-X 现状：[edgerouter-x-configuration.md](edgerouter-x-configuration.md)、[hosts/gw.md](../hosts/gw.md) -- UniFi：[unifi-network.md](unifi-network.md)、[hosts/ubnt.md](../hosts/ubnt.md) -- `gfw`：[hosts/gfw.windy.lan.md](../hosts/gfw.windy.lan.md) -- 作废方案（**不再实施**）：[lan-erx-se5420-network.md](lan-erx-se5420-network.md)、[lan-core-switch-upgrade-plan.md](lan-core-switch-upgrade-plan.md) +- 现网地图：[lan-overview.md](../lan-overview.md) +- ER-X 现状：[edgerouter-x-configuration.md](../edgerouter-x-configuration.md)、[hosts/gw.md](../../hosts/gw.md) +- UniFi：[unifi-network.md](../unifi-network.md)、[hosts/ubnt.md](../../hosts/ubnt.md) +- `gfw`：[hosts/gfw.windy.lan.md](../../hosts/gfw.windy.lan.md) +- 作废方案（**不再实施**）：[lan-erx-se5420-network.md](../lan-erx-se5420-network.md)、[lan-core-switch-upgrade-plan.md](lan-core-switch-upgrade-plan.md) - MikroTik RB5009 官方：、RouterOS v7 手册 diff --git a/docs/se5420-review-claim-verification-2026-08.md b/docs/archive/se5420-review-claim-verification-2026-08.md similarity index 96% rename from docs/se5420-review-claim-verification-2026-08.md rename to docs/archive/se5420-review-claim-verification-2026-08.md index 3b4557f..544fd7d 100644 --- a/docs/se5420-review-claim-verification-2026-08.md +++ b/docs/archive/se5420-review-claim-verification-2026-08.md @@ -1,6 +1,6 @@ # SE5420 实施评审主张核实（2026-08-10） -> **核对基准（历史快照）：** 本文于 2026-08-10 针对 [lan-se5420-deployment-guide.md](lan-se5420-deployment-guide.md) 的**评审前版本**（`35577d0`）撰写。该指南自 `ffb37a9`（"finalize SE5420 deployment guide per review"）起已按本评审修订，当前 `origin/main` 章节已重组：旧 §3.3 → §4.3、旧 §6（gfw）→ §11、旧 §7（SSID）→ §12、旧 §9（验收/IPv6）→ §13 + §11.4。文末「当前指南处理情况」列出各主张的现行状态；实施以部署指南现行为准。 +> **核对基准（历史快照）：** 本文于 2026-08-10 针对 [lan-se5420-deployment-guide.md](../lan-se5420-deployment-guide.md) 的**评审前版本**（`35577d0`）撰写。该指南自 `ffb37a9`（"finalize SE5420 deployment guide per review"）起已按本评审修订，当前 `origin/main` 章节已重组：旧 §3.3 → §4.3、旧 §6（gfw）→ §11、旧 §7（SSID）→ §12、旧 §9（验收/IPv6）→ §13 + §11.4。文末「当前指南处理情况」列出各主张的现行状态；实施以部署指南现行为准。 **范围。** 本文核对对 `lan-se5420-deployment-guide.md` 的评审意见。结论分为 “已证实”（规范/一手资料直接支持）、“基本证实”（架构推论成立但仍须读取现场配置）和 diff --git a/docs/lan-erx-se5420-network.md b/docs/lan-erx-se5420-network.md index 4f3aeb6..e0f4171 100644 --- a/docs/lan-erx-se5420-network.md +++ b/docs/lan-erx-se5420-network.md @@ -307,7 +307,7 @@ VLAN10 / 升级 SSID / 客人 SSID **失败或未做，不否决**本次核心 ## 13. 参考 -- 实施阶段与清单：[lan-core-switch-upgrade-plan.md](lan-core-switch-upgrade-plan.md) +- 实施阶段与清单：[lan-core-switch-upgrade-plan.md](archive/lan-core-switch-upgrade-plan.md) - 现网地图：[lan-overview.md](lan-overview.md) - ER-X：[edgerouter-x-configuration.md](edgerouter-x-configuration.md)、[hosts/gw.md](../hosts/gw.md) - UniFi / VLAN10 前置：[unifi-network.md](unifi-network.md) diff --git a/docs/lan-overview.md b/docs/lan-overview.md index 035199b..4acaca5 100644 --- a/docs/lan-overview.md +++ b/docs/lan-overview.md @@ -47,7 +47,7 @@ from each section below. > 交换），全量点只能靠 SE5420 port mirroring。迁移状态见部署计划 > [lan-se5420-deployment-guide.md](lan-se5420-deployment-guide.md). Design/planning refs: > [lan-erx-se5420-network.md](lan-erx-se5420-network.md), -> [lan-core-switch-upgrade-plan.md](lan-core-switch-upgrade-plan.md). +> [lan-core-switch-upgrade-plan.md](archive/lan-core-switch-upgrade-plan.md). --- diff --git a/docs/lan-se5420-deployment-guide.md b/docs/lan-se5420-deployment-guide.md index 568405a..ae3f68f 100644 --- a/docs/lan-se5420-deployment-guide.md +++ b/docs/lan-se5420-deployment-guide.md @@ -462,7 +462,7 @@ ssh -4 root@192.168.66.1 'uci show network; uci show firewall; uci show dhcp; ip - 每次实质变更后在 Linear `vps` 项目记录 scope / action / verification / 遗留 follow-up。 - 本仓库不记录 SE5420 口令、ER-X 配置快照（含 PPPoE/口令）、gfw 凭据。 -- 实施前先读 `se5420-review-claim-verification-2026-08.md` 的现场只读复核结论。 +- 实施前先读 `archive/se5420-review-claim-verification-2026-08.md` 的现场只读复核结论。 ## 16. 回滚 @@ -486,10 +486,10 @@ ssh -4 root@192.168.66.1 'uci show network; uci show firewall; uci show dhcp; ip ## 参考 - 设计说明：[lan-erx-se5420-network.md](lan-erx-se5420-network.md) -- 评审核实：[se5420-review-claim-verification-2026-08.md](se5420-review-claim-verification-2026-08.md) +- 评审核实：[se5420-review-claim-verification-2026-08.md](archive/se5420-review-claim-verification-2026-08.md) - 现网地图：[lan-overview.md](lan-overview.md) - 官方安装手册（Markdown 版）：[se5420-official-manuals/tl-se5420-install-manual.md](se5420-official-manuals/tl-se5420-install-manual.md) - 官方 PDF： - 规格 / 固件： · - Omada VLAN 指南： · -- ER-X：[edgerouter-x-configuration.md](edgerouter-x-configuration.md)；gfw：[hosts/gfw.windy.lan.md](../hosts/gfw.windy.lan.md)；PVE VLAN10：[lan-rb5009-upgrade.md#阶段-5-附pve-上-vlan10-透传实现-调研-2026-08-09](lan-rb5009-upgrade.md#阶段-5-附pve-上-vlan10-透传实现-调研-2026-08-09) +- ER-X：[edgerouter-x-configuration.md](edgerouter-x-configuration.md)；gfw：[hosts/gfw.windy.lan.md](../hosts/gfw.windy.lan.md)；PVE VLAN10：[lan-rb5009-upgrade.md#阶段-5-附pve-上-vlan10-透传实现-调研-2026-08-09](archive/lan-rb5009-upgrade.md#阶段-5-附pve-上-vlan10-透传实现-调研-2026-08-09)