feat: 方案设计、数据库和接口设计基本完成

2026-09-02 14:47:18 +08:00
parent a3fe066a5f
commit 04c94e75db
30 changed files with 3305 additions and 122 deletions
@@ -14,18 +14,18 @@

 ### 2.1 注册

-注册页字段只有手机号和密码，均为必填：
+注册页字段只有邮箱和密码，均为必填：

 | 字段 | 规则 |
 |---|---|
-| 手机号 | 使用国家区号 + 手机号的标准化格式保存；同一手机号只能注册一个账户。首期注册页默认中国区号，但数据模型和界面需支持后续扩展。 |
+| 邮箱 | 去除首尾空格后以不区分大小写的形式保存；同一邮箱只能注册一个账户。首期仅校验基本邮箱格式，不发送验证邮件。 |
 | 密码 | 由后续安全设计确定最终长度与复杂度；页面需要二次输入密码并提示规则。密码只可安全散列存储，绝不回显。 |

-首期注册成功即可登录使用。短信验证和风控验证不在首期流程执行，但要预留“手机号是否已验证”和“注册/登录风控结果”的状态，未来加功能时不改变账户主流程。
+首期注册成功即可登录使用。邮箱验证和注册/登录风控不在首期流程执行，但数据模型预留 `email_verified_at`；后续可增加邮箱验证。手机号、短信验证、短信登录也不在首期范围，未来通过新增可选手机号凭据和验证流程扩展，不影响邮箱账户主流程。

 ### 2.2 登录与会话

-用户用手机号和密码登录。登录成功进入默认工作空间与首页；若后续一个账户拥有多个工作空间，再增加切换入口。首期需要提供退出登录；忘记密码、短信登录、第三方登录、设备管理和多因素认证均不在本轮范围。
+用户用邮箱和密码登录。登录成功进入默认工作空间与首页；若后续一个账户拥有多个工作空间，再增加切换入口。首期需要提供退出登录；忘记密码、短信登录、第三方登录、设备管理和多因素认证均不在本轮范围。

 ### 2.3 全局平台与当前店铺上下文

@@ -78,9 +78,9 @@

 - 店铺名称：只读，不可修改。
 - 水印：下拉列表，包含当前账户可用的水印模板，也可以选择“暂不绑定”。
- 确认后，该店铺后续上架商品时默认使用此模板处理商品图片；已有图片不会被自动重写。
+- 确认后，该店铺保存一个推荐水印模板；已有图片不会被自动重写。首期它不在发布时自动处理商品图片，用户须在商品编辑页对具体图片的“编辑 → 添加水印”中主动选择模板并生成派生图。

-一个店铺首期只可绑定一个默认水印；同一水印模板可以绑定给多个店铺。
+一个店铺首期只可绑定一个推荐水印；同一水印模板可以绑定给多个店铺。后期可将它用作图片弹窗的默认预选、批量添加或自动添加策略，但这些自动行为不属于首期。

 ### 3.4 编辑与删除

@@ -133,20 +133,20 @@

 “查看效果”使用模板当前配置和固定演示底图打开预览。

-### 4.3 上架时的默认加水印规则
+### 4.3 商品编辑时主动加水印规则

-当用户选择的目标店铺已经绑定水印模板时，点击“上架至 Ozon”后，系统在上传每张商品图片前生成一份带水印的派生图，并把派生图上传给 Ozon；未绑定模板则上传原选图。规则如下：
+用户在商品编辑页的已选图片上悬浮，点击“编辑 → 添加水印”，在弹窗选择一个工作空间水印模板。确认后系统对这张图片生成一份带水印的派生图，并以派生图替换此 SKU 当前图片位置。规则如下：

- 商品级图片与每个 SKU 已选图片都适用，最终以实际要提交给 Ozon 的图片集合为准。
- 原始图片和编辑页已选图片不被改写；水印处理产物是一次独立的、可追溯的上传副本。
- 上传任务固化水印模板版本、位置、缩放/字体和不透明度；模板后续编辑不影响已上架商品。
- 用户在具体上架任务中应能查看“将应用的水印模板”；是否允许该次上架临时取消或更换模板，留待发布流程需求确认。
+- 商品级候选图片与每个 SKU 已选图片都可处理；最终仅提交用户明确选中的图片集合。
+- 原始图片不被改写；水印处理产物是独立、可追溯的派生素材，用户可在编辑弹窗恢复使用原图。
+- 派生任务固化水印模板版本、位置、缩放/字体和不透明度；模板后续编辑不影响已生成的派生图。
+- 首期不在上架任务中自动加水印，也不允许发布时临时替换；后续另行支持绑定水印的默认预选、批量添加或自动添加。

 ## 5. 本轮待确认事项

 1. 商品限额的 Ozon 数据来源与刷新频率仍待平台接口/真实店铺联调确认；在此之前固定显示 `—`。
 2. 账户是否从首期就允许多人共享同一工作空间/协作店铺？如果不做，首期仍按“一个账户一个工作空间”使用，但架构会保留扩展空间。
-3. 上架任务是否允许临时取消或替换门店默认水印？
+3. 后续“推荐水印”是仅在图片弹窗中预选，还是支持批量/自动生成派生图？

 ## 6. 非功能性约束