V0.9 会员与内容运营

本文档用于记录 V0.9 阶段的发布前复验目标、当前结果和后续边界。V0.9 的目标是在 V0.7 用户端视图和 V0.8 全栈联调基础上，复验并深化常规 App 的商业化、余额账本和内容运营能力。

版本号：0.9.0-SNAPSHOT

发布状态：发布前复验中。

截至 0.8.0 主线，会员积分、Money 账本、多资产余额、内容付费、CMS / Blog / Forum / Mall、Distribution 和 B2B2C Mall 基础 contract 已提前落地。本页只描述 V0.9 继续复验和深化的方向，不代表这些能力当前缺失。

阶段定位

V0.9 是“用户端商业化与运营复验版”：

• 复验 VIP / SVIP / Plus / Pro 等会员产品与 Entitlement / Payment / Money 的真实联动。
• 复验付费开通、续费、升级、降级、到期和退款撤销的运营体验。
• 深化多国家法币和 Web3 币种余额、充值、提现、账单和资金审计。
• 深化文章、公告、通知、轮播图、首页导航和内容付费在 App / PC / Admin 的一致体验。

会员体系规划

会员不建议简单做成 RBAC 角色。RBAC 解决后台权限，会员解决用户权益、有效期、订阅和商业化。

推荐模型：

能力	说明
会员等级	vip、svip、plus、pro 等可配置计划
会员权益	功能次数、折扣、专属内容、客服、存储空间、AI 调用额度等
订阅记录	记录用户当前计划、开始时间、结束时间、来源订单和状态
权益快照	购买时保存权益快照，避免后续套餐调整影响历史订单
IAM 联动	用户仍使用统一账号体系，会员状态作为用户权益，不直接替代角色
Payment 联动	支付成功后激活会员，退款或关闭订单时按规则处理会员状态

推荐会员状态：

• pending
• active
• expired
• cancelled
• refunded
• frozen

推荐开通流程：

1. 用户选择会员计划。
2. 创建会员订单。
3. 调用 Payment 发起支付。
4. 支付回调幂等确认。
5. 写入会员订阅和权益快照。
6. 写入账单和操作审计。
7. 用户端刷新会员状态。

余额系统规划

余额系统必须按账本思路设计，不建议只在用户表放一个 balance 字段。

推荐模型：

模型	说明
资产	法币和 Web3 币种统一抽象，例如 fiat:CNY、fiat:USD、evm:bsc:USDT
账户	每个用户可拥有多个资产账户
可用余额	用户可消费金额
冻结余额	下单、提现、风控、退款处理中冻结
账本流水	所有余额变化必须写流水
用户账单	面向用户展示的账单，可由账本流水聚合或映射
业务单号	每条流水必须关联支付订单、退款单、充值单、提现单或业务单号

资产字段建议：

字段	说明
assetType	fiat 或 crypto
currency	ISO 4217 法币，如 CNY、USD、EUR
chain	Web3 链，如 bsc、ethereum
tokenAddress	Token 合约地址，原生币为空
symbol	USDT、BNB、ETH 等
decimals	精度

账本原则：

• 金额使用高精度 decimal，不使用 double。
• 任何余额变化都必须有流水。
• 同一业务单号必须幂等。
• 可用余额和冻结余额分开。
• 账单展示不等于账本原始数据，账单可更偏用户可读。
• Web3 链上资产和平台内余额必须区分：链上余额来自链查询，平台余额来自数据库账本。

内容运营规划

V0.9 补齐常规应用内容能力：

能力	说明
文章	分类、标签、封面、摘要、正文、发布时间、上下架
公告	系统公告、弹窗公告、阅读状态
通知	复用 Notification，用户端展示站内信和消息中心
轮播图	图片、标题、跳转链接、排序、有效期、上下架
首页导航	图标、文字、跳转、排序、权限或登录要求

前端要求：

• views/app 首页展示轮播图、导航、公告和推荐内容。
• views/pc 首页展示轮播图、文章、公告、登录入口和会员入口。
• 文章详情支持富文本或 Markdown 渲染。
• 公告支持已读状态。
• 通知中心复用 V0.8 消息中心基础能力。

B2B2C Mall 边界

B2B2C Mall 基础 contract 已进入主线，不再作为 V0.9 的“待补底层能力”重复规划。V0.9 若继续推进电商，只聚焦真实运营复验和行业深水能力：

• 真实商户 / 店铺 / 商品 / 订单 / 库存 / 售后 / 结算链路 smoke。
• 商户控制台和平台后台之间的权限、数据范围和结算审计。
• 真实支付、退款、分账和资金对账 Provider 验收。
• 行业化运营报表、风控规则和异常补偿。

发布前复验结果

截至 2026-07-06，本地发布前复验已完成以下检查：

领域	当前结果
会员 / 权益	Entitlement 已覆盖套餐、用户权益、配额、当前用户权益查询、退款撤销联动、Admin 管理和 App / PC 用户入口；Blog / Forum 已接入付费、会员可见、VIP / SVIP / Plus / Pro、限免和会员折扣等访问策略。
余额 / 账本	Money 已覆盖多资产账户、可用 / 冻结余额、账本流水、用户账单、充值、提现、Web3 充值 / 提现、兑换、管理员调账和审计；Web3 资产以 evm:<chain>:<symbol> / token 元数据表达链、合约、symbol 和 decimals。
内容运营	CMS 已提供首页聚合、Banner、导航、公告、内容中心和 Admin 维护；Blog / Forum / CMS 已具备 App / PC / Admin 入口，付费内容解锁与 Entitlement / Payment / Money 联动。
Mall / 商家	B2B2C Mall 基础 contract 已进入主线，商家入驻、后台审核、商家控制台、订单、售后、评价、结算到商户主账号余额等本地 contract 已闭口；真实支付、退款、分账和资金对账仍按外部 Provider 验收清单复验。
迁移 / 安装	V0.9 发布前生成了 release checklist、dry-run、changelog draft、API compat、migration freeze 和 install smoke 报告；迁移静态检查通过，安装模块后端测试和安装端构建通过。

本地复验不替代真实外部厂商和真实链路验收。真实支付、Web3 真实链交易、外部 Provider 凭据、Maven Central 凭据和生产部署证据仍按 外部 Provider 验收清单 记录。

验收标准

项目	标准
会员	可购买、续费、到期，用户端可查看当前权益
支付	会员订单能通过 Payment 模块完成支付闭环
余额	用户有多资产账户、余额流水、账单查询、充值提现和资金审计
Web3 币种	可表达链、token、symbol 和 decimals，不与法币混淆
内容	文章、公告、轮播图、首页导航具备后台维护和用户端展示
文档	会员、余额、账单和内容运营有正式使用说明

发布前检查清单

• [x] 生成 0.9.0 本地 release checklist / dry-run / changelog draft / API compat / migration freeze / install smoke 报告。
• [x] 执行 V0.9 核心后端范围测试：Entitlement、Money、Cashier、CMS、Blog、Forum、Mall 及其依赖链通过。
• [x] 执行安装模块后端测试和安装端 Maven 构建。
• [x] 执行 Admin typecheck、PC typecheck、App H5 build。
• [x] 执行 Docs Maven 构建。
• [x] 执行 .ai/scripts/check all、git diff --check 和 Docker 静态 smoke。
• [ ] 维护者确认是否把全局版本从 0.8.0 切入 0.9.0 正式发布，或继续保留 0.9.0-SNAPSHOT 规划口径。
• [ ] 真实外部支付 / Web3 / Provider 凭据环境按验收清单复验并归档证据。

不阻塞项

• 完整订阅自动扣费。
• 复杂营销系统。
• 复杂佣金和分账。
• 多级分销深水区。Distribution 已是独立模块，不放入 Mall。
• 完整财务对账系统。
• B2B2C 电商完整业务。

V0.9 之后

V0.9 发布后，建议先进入稳定版准备；B2B2C 电商、会员、余额、支付和内容运营如需继续深化，应从模块记忆重新拆成可领取功能簇。