MSuMshk
ab59e2e3e2
App：新增 operation_logs/quota_packages/tenant_payments/tenant_quota_package_purchases 表 Identity：修正 Avatar 字段类型（varchar(256)->text），保持现有数据不变
4.0 KiB
4.0 KiB
TakeoutSaaS 开发 TODO（自动维护）
说明：该文档用于记录本仓库待办与进度。我会在完成每个任务后更新标记状态，并尽量保持“一个功能点一个原子提交”。
状态标记：[x] 已完成 / [~] 部分完成 / [ ] 未开始
一期：套餐管理 MVP（已落地 + 待收口）
[x] 1. 套餐增删改：新建/编辑/复制套餐，支持草稿保存
- 新建套餐（表单：基础信息 + 定价 + 权益配额）
- 编辑套餐（同新增表单）
- 复制套餐（基于现有套餐快速创建新套餐）
- 删除套餐（软删）
- 草稿保存（草稿/发布状态、草稿发布、回滚草稿）
- 修复“保存草稿却变发布”根因（EF 默认值哨兵导致 insert 省略字段，已将发布状态默认值调整为草稿并补齐哨兵配置）
[x] 2. 上架体系：上架/下架、是否对外可见、是否允许新租户购买
- 上架/下架（启用/禁用套餐，含二次确认与提示）
- 是否对外可见（展示与可售解耦）
- 是否允许新租户购买（可售开关与可见开关解耦）
- 修复“新增时开关 false 无法落库”根因（EF 默认值哨兵导致 insert 省略字段，已将哨兵改为 true）
[~] 3. 价格与计费周期：月付/年付、阶梯价/按量计费
- 月付/年付价格（
monthlyPrice/yearlyPrice） - 阶梯价/按量计费
[x] 4. 权益/配额配置：功能开关 + 数值配额（门店/账号/存储/短信/配送单量/更多）
- 数值配额（门店数、账号数、存储、短信、配送单量）
- 功能策略（
featurePoliciesJson：可视化编辑 + JSON 预览，保留未知字段） - 商品/菜单上限
- API 调用次数
- 报表/导出权限
- 打印/小票能力
- 营销功能（优惠券/满减/会员/积分等开关）
[~] 5. 展示配置：卖点文案、推荐标识、排序、标签、对比页字段
- 排序（
sortOrder） - [~] 卖点/描述（
description） - 推荐标识（Recommended）
- 标签（推荐/性价比/旗舰）
- （已移除）对比页展示字段配置（对比维度/顺序）
- 自助入驻选套餐页展示推荐/标签（公共套餐列表接口返回 isRecommended/tags + 前端展示/置顶）
[x] 6. 订阅关联视图：当前使用该套餐的租户数量、MRR/ARR 粗看、到期分布（运营常用）
- 订阅/租户数量：活跃订阅数、总订阅数、使用租户数
- 使用租户列表入口：抽屉列表（支持分页与搜索）
- MRR/ARR 粗看
- 到期分布（7/15/30 天到期租户数、到期列表入口）
[x] 7. 后端接口补齐（套餐使用统计/使用租户分页查询等）
[x] 8. 前端联调与回归（包含权限、空态、错误提示）
二期：上架与配置完善（建议）
- 1. 草稿保存与发布流程（草稿/发布、回滚到草稿）
- 2. 可见性/可售开关拆分（对外可见、允许新租户购买、已订阅不受影响说明）
- 4. 权益/配额可视化编辑器（JSON 结构化编辑、Schema 校验、预设模板）
- 5. 更多常用配额字段补齐（商品/菜单、API 次数、导出/报表、打印等）
三期：计费与权益策略（建议）
- 1. 阶梯价/按量计费（超配计费、账单明细）
- 2. 权益变更影响说明：升配/降配规则（立即/次周期）、影响范围提示
- 3. 超配策略（禁止/只读/按量计费/宽限期）
四期：商业化与合规增强（建议）
- 1. 附加计费（Add-ons）：短信包、存储包、额外门店/账号包、配送单量包（可叠加、单独定价）
- 2. 版本与历史：套餐版本号、变更记录、回滚、对已订阅租户的影响范围提示
- 3. 购买限制：可购买地区/行业、仅邀请可见、最大购买数量、是否允许叠加订阅
- 4. 订阅关联视图增强：MRR/ARR、到期分布、续费转化漏斗（运营常用）
- 5. 操作审计：谁改了套餐、何时改、改了什么（合规必备）