docs: 性能整改落地文档——structs 补缓存层与部署参数说明、报告标注 P0 实施进度、AGENTS 沉淀切片缓存陷阱与 bullseye 跑测经验

docs/references/structs.md

@@ -47,6 +47,13 @@ inkreach-official/
   `v2-postgres`（数据卷 `deploy-v2_pgdata` external 引用，v2 数据未迁移）。
 - 域名路由：`/v2/admin/`（SPA）、`/v2-api/`（小程序/后台 API，去前缀转发）、`/public/`
   （H5 同源 API）、`/uploads/`、`/assets/` 均由 v2-api 服务；`/` 302 到 `/v2/admin/`。
+- 性能整改 P0（2026-09-03，plans/refactor/public-capacity-10k-refactor.md）：边缘 nginx
+  主配置改为仓库文件 `deploy/nginx/nginx.conf`（worker_connections 16384 + gzip + 访问日志，
+  经 admin.Dockerfile COPY，改后须重建镜像）；admin.conf 含 upstream keepalive/限流(429)/
+  代理超时/静态缓存头；v2-postgres 显式参数（statement_timeout=10s、max_connections=200、
+  shared_buffers=512MB）；v2-api 的 DATABASE_URL 带 `connection_limit=50&pool_timeout=3`
+  （pool_timeout 单位为秒）；admin 服务 ulimits nofile 65536。改 PG 参数/重启前按全局约束
+  先 pg_dump + 配置快照落 `deploy/backups/<时间戳>/`。
 - v1（旧 api+postgres，曾支撑 `/public/` 与旧后台）已退役：切换时容器停用未删，
   库终档与全部配置快照及回滚手册见 `deploy/backups/consolidation-*/RESTORE.md`。
 - 原 v2 独立栈（`docker-compose.v2.yml`、`/opt/inkreach-v2` 检出）已并入单栈并删除，
@@ -76,7 +83,7 @@ apps/api/
 │   ├── product-families/          # 产品族（SPU 层）：CRUD / auto-group（并入已有族优先，familyNameKey 族语义键）/ attachToMatchingFamily（单链接自动归族）/ consolidateFragments（碎片族合并）/ 成员管理 / 自定义成员 / 价格覆盖 / 重算 / 按链接名称派生标签（auto-tag-rules，含 热转印→烫画 别名）。数据约定（2026-09-03 起）：光板/不打印链接不入族、矩阵不计算不打印工艺；auto-group/organize/人工改标签会把散链接回挂，运行前须排查（备份见 deploy/backups/20260903-noprint-removal/）
 │   ├── goods/                     # 商品 CRUD + 批量优先级 + 批量创建 + 展示名规范化（品名 SKU，剥 ASCII 型号限定词，纯款号按 SDS 分类名补描述）
 │   ├── sync/                      # SDS 同步：分类 / 商品 / 同步日志
-│   ├── public/                    # 公开 API：分类树 / 国家 / 商品分页 / 商品详情
+│   ├── public/                    # 公开 API：分类树 / 国家 / 商品分页 / 商品详情；public-cache.service.ts 为进程内分域缓存（meta/goods/matrix 版本域 + TTL 兜底 + in-flight 合并，P0-1 性能整改），全部写路径（admin CRUD/sync/族重算/整理）事务提交后 bump 对应域即时失效；env 开关 PUBLIC_CACHE_DISABLED / PUBLIC_CACHE_TTL_MS / PUBLIC_CACHE_MAX_ENTRIES
 │   └── common/                    # 全局装饰器 / 过滤器 / 拦截器
 │       ├── decorators/current-user.decorator.ts
 │       ├── filters/http-exception.filter.ts