docs: record style-order semantics, container-run pitfalls and lessons

plans/feature/category-sort-feature.md

@@ -28,13 +28,19 @@
   - 运行容器快照：镜像 `inkreach-api-snapshot:20260901`（docker commit 自 deploy-v2-api-1，含当前代码与依赖）
   - 代码回滚 = 删 feature 分支
 
-**执行环境（宿主机无 node，统一用容器跑）：**
+**执行环境（宿主机无 node；已验证的正确方式——挂仓库根 + 复用运行镜像）：**
 
 ```bash
-# 测试 / prisma 命令统一模板（挂载源码 + 加入 postgres 网络）
+# ⚠️ 两个坑（实测踩过）：
+# 1) pnpm 的 node_modules 是相对符号链接指向根 .pnpm store，
+#    只挂 apps/api:/app 会断链（Cannot find module）——必须挂整个仓库根
+# 2) node:20-alpine 缺 libssl1.1，Prisma engine 加载失败——
+#    直接用项目运行镜像 deploy-v2-api（libssl 已匹配）
 docker run --rm --network deploy-v2_default \
   -e DATABASE_URL='postgresql://inkreach:2628adbdf875727ae1b5556b08cb00452bb4e1f80490f6b6@postgres:5432/inkreach' \
-  -v /opt/inkreach-v2/apps/api:/app -w /app node:20-alpine npx <命令>
+  -v /opt/inkreach-v2:/repo -w /repo/apps/api deploy-v2-api npx <prisma|jest|tsc ...>
+# 只读 prisma 元数据（migrate status 等）也可轻量挂载：
+#   -v /opt/inkreach-v2/apps/api/prisma:/app/prisma deploy-v2-api npx prisma migrate status
 ```
 
 **排序键定义（getGoods DEFAULT，商品经 origin_goods.sds_category_id 定位到款）：**