# 新需求提交模板

编码、安全、权限、数据库、租户和验证等强制规则统一遵循 [`../AGENTS.md`](../AGENTS.md)，本模板不重复展开。不得填写或转述配置内容；依赖配置才能判断时填写“需授权人员线下确认”。

## 1. 必填信息

- 需求名称：
- 业务背景与目标结果：
- 需求/验收人：
- 影响范围摘要：
- 期望完成时间：
- 优先级：普通 / 紧急 / 阻断

## 2. 应用与租户

- 所属活动应用：跑街后台（`admin`） / 目录后台（`admins`） / 目录助手 API（`api`） / 目录助手（`apps`） / 跑街CRM（`crm`） / 跑街商城（`home`）
- 页面、路由或接口业务标识：
- 目标用户：访客 / 会员 / 店铺主 / 店铺员工 / 代理 / CRM / 平台管理员 / 外部系统
- 停止使用且不维护：`daili` / `app` / `na`；涉及这些目录时须由用户先明确处置范围
- 租户类型：跑街店铺（`shop`） / 联动版目录（`gzh`） / 公众号目录（`super`） / 代理店铺（`dshop`）
- 需求范围：全部租户 / 指定租户 / 新租户模板 / 不涉及租户
- 指定租户及共享/私有覆盖影响：

## 3. 功能、复用与函数粒度

- 正常流程：
- 异常与兼容要求：
- 关键输入、输出和副作用：
- 已检查的现有公共函数/业务方法：
- 复用结论：直接复用 / 小范围扩展 / 无可复用实现；依据：
- 是否需要新增或拆分函数：否 / 是；必要性：

## 4. 接口（如涉及）

- 接口名称：
- 业务标识与方法：
- 调用方：Web / 第三方回调 / 定时任务 / CLI / 其他
- 请求字段与校验：
- 成功/失败返回约定：
- 认证、幂等和兼容要求：

## 5. 权限（如涉及）

- 谁可以查看：
- 谁可以新增/修改/删除：
- 权限依据：
- 未登录和无权限的预期行为：
- 敏感数据与审计要求：

## 6. 数据库（如涉及）

- 数据责任域（仅填写业务名称，不填写配置标识）：
- 数据访问封装：模块现有 `XXXBase.class.php` / 现有 `XXXBaseDb.class.php` / `mod_base/BaseDb.class.php`
- 计划复用的现有 Base 方法：
- 涉及表及读写操作：
- 事务、数据量和索引要求：
- 回滚方案：

## 7. 验收标准

1. `<填写>`
2. `<填写>`
3. `<填写>`

- 必验场景：正常 / 失败 / 未登录或无权限 / 非法参数：
- PHP 7.3、接口、数据库及租户验证结果：
- 未验证范围与原因：