feat(admin): 商品配置与系统公告管理接口，id 以字符串下发

- /admin/products 六个接口 + 校验（code 唯一、store_product_id 同平台唯一、
  COIN_PACK 需 coin_amount>0、VIP 需 vip_days>0、VIP 只建不启）
- /admin/notices 六个接口，与 C 端 /app/notices 共用 OpsNoticeService.pageForApp 一套筛选口径
- 权限点 product:list/product:update/notice:list/notice:update + 菜单 31/32/33（sql/data-phase1.sql 幂等）
- 雪花 id 超过 JS 安全整数范围：id 以字符串下发，避免浏览器四舍五入导致回查 200002
- C 端商品查询收敛到 ProductService.findForStore，OrderService 不再自带一份
- 测试：module-commerce 33 / admin-api 16 / app-api 49 / worker 12，共 110 条全过

docs/api-phase1.md

@@ -742,6 +742,84 @@ GET /app/notices?pageIndex=1&pageSize=20
 | --- | --- | --- | --- |
 | GET | `/admin/creator-center/impersonation/targets` | `creator-center:impersonate` | 代看目标下拉的数据源（id / 名称 / 状态） |
 
+### 2.11 商品（金币包）配置（已实现）
+
+> 背景：`product` 表 16 个字段早就建好，但后台一直没有入口，运营只能改库；而 C 端 `/app/orders/verify`
+> 依赖 `store_product_id` 对齐商店商品（对不上就是 `200002 该商品未在后台配置`）。本节补齐 CRUD。
+> **不改表结构。**
+
+| 方法 | 路径 | 权限点 | 说明 |
+| --- | --- | --- | --- |
+| GET | `/admin/products/page` | `product:list` | 分页检索（`type` / `status` / `platform` / `keyword`，分页沿用 `{total,list}`） |
+| GET | `/admin/products/{id}` | `product:list` | 商品详情 |
+| POST | `/admin/products` | `product:update` | 新建 |
+| PUT | `/admin/products/{id}` | `product:update` | 编辑 |
+| PUT | `/admin/products/{id}/status` | `product:update` | 上架 / 下架（`status`：1 上架、0 下架） |
+| DELETE | `/admin/products/{id}` | `product:update` | 删除（逻辑删除） |
+
+**字段**（与表一致，响应里额外带 `statusText` / `typeText`，前端不再写死中文）：
+
+| 字段 | 说明 |
+| --- | --- |
+| `code` | 商品编码，**全局唯一** |
+| `name` | 展示名 |
+| `type` | `COIN_PACK`（金币包）/ `VIP`（会员，第二阶段） |
+| `platform` | `ALL` / `GOOGLE` / `APPLE` |
+| `storeProductId` | 商店商品 id，**同一 `platform` 下唯一**（空串表示未绑定，允许多个） |
+| `coinAmount` / `bonusCoin` | 金币数与赠送（`type=COIN_PACK` 时 `coinAmount > 0`） |
+| `priceAmount` / `currency` / `displayPrice` | 价格与展示价 |
+| `regionCodes` | 生效区域，逗号分隔，空=全区域 |
+| `vipDays` | 会员天数（`type=VIP` 时 `> 0`） |
+| `sort` / `status` | 排序 / 上下架 |
+| `effectiveAt` / `expireAt` | 生效与失效时间（可空） |
+
+> **⚠️ `id` 以字符串下发**（2026-10-16 实测补充）：S0 换雪花主键后 id 已超过 JS 的安全整数范围
+> （2^53-1 = 9007199254740991）。直接下发数字会被浏览器四舍五入（实测 `2111011206851596290`
+> 在 JS 里变成 `2111011206851596300`），页面拿这个 id 回查就是"商品不存在"。
+> 因此**本节所有响应里的 `id`（含新建返回的新 id）都是字符串**，前端原样拼进 URL 即可。
+
+**校验与错误码**：
+
+| 场景 | 结果 |
+| --- | --- |
+| `code` 已存在 | `200001 商品编码已存在：{code}` |
+| `storeProductId` 在同 `platform` 下已存在 | `200001 该平台下商店商品 id 已被占用：{id}` |
+| `type=COIN_PACK` 但 `coinAmount <= 0` | `400 金币包的金币数量必须大于 0` |
+| `type=VIP` 但 `vipDays <= 0` | `400 会员商品的会员天数必须大于 0` |
+| **`type=VIP` 且要启用**（`status=1`） | `400 会员商品在订阅功能上线前不能启用（可先建档，上线后再上下架）` |
+| 商品不存在 | `200002 商品不存在` |
+
+> **VIP 口径（2026-10-16 定，与 B1-1「VIP 订阅本轮不做」一致）**：**允许创建、不允许启用**。
+> 运营可以先录好商品与商店 product id，等 B2 上线后直接上下架；**启用**才是会误导客户端的动作，拦在这里。
+
+### 2.12 系统公告管理（已实现）
+
+> 背景：`ops_notice` 表 0 行、契约原先写着"没有产出方"；E1 已交付 C 端 `GET /app/notices`（匿名只读）。
+> 本节补齐后台写入。**不改表结构。**
+
+| 方法 | 路径 | 权限点 | 说明 |
+| --- | --- | --- | --- |
+| GET | `/admin/notices/page` | `notice:list` | 分页检索（`status` / `target` / `type` / `keyword`） |
+| GET | `/admin/notices/{id}` | `notice:list` | 公告详情 |
+| POST | `/admin/notices` | `notice:update` | 新建 |
+| PUT | `/admin/notices/{id}` | `notice:update` | 编辑 |
+| PUT | `/admin/notices/{id}/status` | `notice:update` | 发布（`status=1`）/ 下架（`status=0`） |
+| DELETE | `/admin/notices/{id}` | `notice:update` | 删除（逻辑删除） |
+
+**字段**：`title` / `content` / `target`（`ALL` / `USER` / `CREATOR`）/ `type`（`SYSTEM` / `AUDIT` / `PAYMENT` / `ACTIVITY`）/
+`status` / `publishAt` / `expireAt`；响应另带 `statusText` / `targetText` / `typeText`。
+
+> **⚠️ `id` 以字符串下发**：同 §2.11 —— 雪花 id 超过 JS 安全整数范围，数字下发会被浏览器四舍五入，
+> 导致"下架/编辑"回查不到记录。本节的 `id`（含新建返回的新 id）一律是字符串。
+
+**与 C 端口径严格对齐（同一条查询实现）**：C 端 `GET /app/notices` 只返回
+`status=1` 且 `target ∈ {ALL, USER}`、`publish_at` 为空或 `<= now`、`expire_at` 为空或未过期的公告，
+按 `publish_at desc, id desc` 排序。**后台发布即 C 端可见；下架或过期后 C 端不可见。**
+（实现上收敛在 `OpsNoticeService.pageForApp(...)` 一处，避免两端条件漂移。）
+
+**筛选与错误码**：`title` 必填（1–128）；`content` 最长 2000；公告不存在 → `200002 公告不存在`；
+`status` 只接受 0/1，其他值 → `400`。
+
 ## 3. 契约与实现状态对照
 
 > 最后更新：2026-10-16（`develop` 分支）。未完成项汇总见仓库根 `README.md`「尚未完成」。