update

app/AGENTS.md

@@ -10,6 +10,9 @@
 - `routers/todos.py`：Todo 管理接口。
 - `routers/temples.py`：寺院管理接口。
 - `routers/products.py`：商品管理接口，按寺院隔离。
+- `routers/feature_icons.py`：图标管理接口，按寺院隔离，支持跨寺院复制图标。
+- `routers/ad_slots.py`：广告位管理接口，按寺院隔离，只维护广告位置定义。
+- `routers/ads.py`：广告管理接口，按寺院隔离，广告内容绑定到广告位。
 - `routers/orders.py`：订单管理接口，按寺院隔离。
 - `routers/payments.py`：微信支付接口，按寺院隔离发起 JSAPI 预下单并处理支付通知。
 - `routers/deploy.py`：自动部署 webhook 接口，校验 Gitea 签名或部署 token 后触发前端构建脚本。
@@ -68,6 +71,14 @@ total_spent     总消费
 名称、单价、库存、排序、是否超度
 ```
 
+## 图标与广告位模型
+
+- 图标存储在 `feature_icons` 表，字段包含图标名称、图标地址、跳转类型、跳转链接、关联商品、排序号、是否启用，并按 `temple_id` 隔离。
+- 图标跳转类型为 `link` 或 `app`；`link` 必须填写跳转地址，`app` 必须选择当前寺院商品。
+- 图标支持从其他寺院复制到当前寺院；应用类型图标复制后不直接跨寺院关联来源商品，需要重新选择当前寺院商品。
+- 广告位存储在 `ad_slots` 表，表示首页广告、详情页广告、支付页广告等位置定义，字段包含名称、编码、说明、排序号、是否启用，并按 `temple_id` 隔离。
+- 广告内容存储在 `ads` 表，字段包含广告位、广告名称、广告图、跳转类型、跳转链接、关联商品、排序号、是否启用，并按 `temple_id` 隔离。
+
 ## 上传与 OSS 配置
 
 图片上传接口为 `/uploads/images`，用于商品封面、商品图片等图片资源。OSS 配置预留在 `config.py`，可直接填写或通过同名环境变量覆盖：
@@ -114,3 +125,5 @@ OSS_ENDPOINT、OSS_BUCKET_NAME、OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、OSS
 - 2026-07-23：新增微信支付 JSAPI 预下单和支付通知处理，增加 `payment_transactions` 支付流水表、微信支付 API v3 签名/通知验签/回调解密工具和配置占位；`requirements.txt` 新增 `cryptography`。验证：后端编译通过，真实预下单和通知验签待填写微信商户配置后联调。
 - 2026-07-27：新增自动部署 webhook 模块，`/deploy/webhook` 支持 Gitea HMAC 签名校验、部署分支过滤、并发锁和构建脚本超时控制，`scripts/deploy_front.sh` 负责拉取代码并构建前端。验证：后端编译通过，webhook 密钥与 Gitea 签名校验测试通过。
 - 2026-07-27：自动部署 webhook 改为后台执行构建，接口在签名校验、分支检查和加锁后立即返回 `202 accepted`，后台任务将构建结果写入部署日志，避免 Gitea Delivery 因等待响应超时。验证：后端编译通过，webhook 后台任务触发测试通过。
+- 2026-07-27：新增图标管理和广告位管理后端模块，增加 `feature_icons`、`ad_slots` 表和 `/feature-icons`、`/ad-slots` 寺院隔离 CRUD 接口，图标支持从其他寺院复制。验证：后端编译通过。
+- 2026-07-27：广告模型拆分为广告位和广告，`ad_slots` 改为位置定义，新增 `ads` 表和 `/ads` CRUD 接口，广告内容必须绑定当前寺院广告位。验证：后端编译通过，广告位与广告接口冒烟测试通过。