docs: README 补单容器入口与 perf-bench、套件计数 18→25;改名文档登记历史方案存档

仓库审计(提交后)发现的三处文档漂移:
· README 快速开始缺单容器路径入口(runbook 第七节写了但门面没指路);
· README 验证段缺 perf-bench(性能口径工具,动热路径前后各跑一次);
· README 套件计数停留在 18,实际 25(本次全量跑出来的实数);
· rename-inkwatch.md 未登记 docs/ 下两个带旧名的历史方案文档
  (pmon-v4-架构方案-V4.0.html / 商业化实施方案V4.0.docx)——
  内容是 PMon 时代原文,刻意保留文件名作历史存档,登记备查。

TODO/FIXME 全库零命中;架构文档为纯设计定位,部署内容以 runbook
为准(第七节已含与 V4.0 第 11 章的互切说明),不强制对称。
This commit is contained in:
PMon Dev committed 2026-10-16 22:57:42 +08:00
1 parent 42ad9ffae5
commit 1238e5d530
2 files changed
+15 -1

No files matched your search

+14 -1
View File
@@ -125,6 +125,18 @@ POSTGRES_IMAGE=postgres:15-alpine docker compose up -d --build
> 凭据经 `.env` 注入,默认值为本地开发用。生产务必覆盖 `POSTGRES_PASSWORD`。
**想一个容器跑全部?** 单容器路径(postgres + redis + gateway + business
四进程一个容器,supervisord 各自守护;数据卷同名,与四容器随时互切、
数据不动):
```bash
cd deploy
docker compose -f docker-compose.all.yml up -d --build
docker exec pmon-app-1 supervisorctl status # 四进程 RUNNING
```
动机与取舍见 `docs/deploy-tencent-runbook.md` 第七节。
### 方式 B:本地开发(不走容器)
```bash
@@ -163,7 +175,7 @@ cd server/business && npm install && \
cd rust-core && cargo test --release # Rust 核心单测(59 项)
cd tests && npm install
bash run-all.sh # 一把梭:18 个套件(9 个离线 + 9 个需起服务)
bash run-all.sh # 一把梭:25 个套件(离线即可跑 + 需起服务)
# 离线套件(无需任何外部依赖)
node dockerfile-coverage-test.js # ★ 镜像 COPY 覆盖性(按 require 图)
node uplink-msgpack-test.js # ★ 上行 msgpack 解包顺序契约
@@ -187,6 +199,7 @@ node e2e-smoke.js # 端到端冒烟
node persistence-restart.js # 持久化与重启恢复(自带启停网关)
node race-residue.js # 断连竞态残留
ROUNDS=500 node leak-check.js # 泄漏专项(约 80s)
node perf-bench.js # ★ 性能基准(动网关热路径前后各跑一次,数字存 docs/perf-baseline-*.json)
```
> ⚠️ 改过 `shared/metrics-schema.js` 后**必须重启网关**:白名单在进程启动时载入并缓存,
+1
View File
@@ -37,6 +37,7 @@
| `docker compose` project name | `name: pmon` | ⚠️ **它是卷名锚点**(`pmon_pg_data`)。改成 `inkwatch` → compose 去找一套新的空卷 → **生产数据库等于被清库** |
| 数据库名 / 连接串 | `pmon` / `.../pmon` | 同上,且要迁移数据 |
| 测试文件与用例前缀 | `pmon_*` | 不影响用户,改了只会制造 diff |
| 历史方案文档文件名 | `docs/pmon-v4-架构方案-V4.0.html`、`docs/全平台设备性能监控系统商业化实施方案V4.0.docx` | 这两份是 PMon 时代的方案原文,**内容本身带旧名**(正文里的产品名、界面名都是当时的写法)。改名文件只会造出"新文件名 + 旧内容"的另一种不一致;留作历史存档,2026-10-16 审计登记在此,后来者不必反复怀疑"是不是漏改了" |
⚠️ **因此 `deploy/docker-compose.yml` 的 `name: pmon` 上方加了防呆注释**:
后来者看到"项目已改名墨观",最顺手的动作就是把这行也改掉 —— 那一下就是清库。