docs: update lite deployment and feature docs

README.md

@@ -1,6 +1,6 @@
 # J-Board Lite
 
-J-Board Lite 是 J-Board 的轻量版本，面向 1C1G 小机器和低资源 Docker 环境优化。它保留代理订阅售卖、流媒体共享、支付、订阅交付、工单、邮件、公告、审计、探测展示与订阅风控等核心功能，同时使用 SQLite 和进程内限流，避免 Postgres、Redis 等额外服务带来的部署负担。
+J-Board Lite 是 J-Board 的轻量版本，面向 1C1G 小机器和低资源 Docker 环境优化。它保留代理订阅售卖、流媒体共享、钱包余额、充值卡、套餐 Push、支付、订阅交付、工单、邮件、公告、审计、探测展示与订阅风控等核心功能，同时使用 SQLite 和进程内限流，避免 Postgres、Redis 等额外服务带来的部署负担。
 
 J-Board Lite 的定位很明确：它是 J-Board 的轻量化部署版本，不是新的节点控制面，也不替代 3x-ui。节点实际运行、入站协议、Xray 客户端配置仍由 3x-ui 维护；面板负责售卖、开通、订阅交付、售后和风险审查，并通过只读 Agent 从节点侧采集延迟、路由和 Xray access log 证据。
 
@@ -32,7 +32,9 @@ J-Board Lite 只保存售卖和展示需要的节点镜像数据。入站协议
 - 支持 Cloudflare Turnstile 人机验证。
 - 代理套餐和流媒体套餐购买、续费、增流量。
 - 购物车、订单、支付状态查询和支付方式切换。
+- 钱包余额充值、余额支付、余额卡兑换和套餐卡兑换。
 - 代理订阅查看、订阅链接下载、订阅访问重置。
+- 套餐 Push：输入接收方邮箱和当前密码即可发起转让，接收方需在 24 小时内确认。
 - 线路体验展示：三网延迟、延迟历史、三网路由追踪。
 - 流媒体订阅凭据展示。
 - 通知中心、工单售后、账号资料、邀请码。
@@ -43,7 +45,9 @@ J-Board Lite 只保存售卖和展示需要的节点镜像数据。入站协议
 - 3x-ui 节点管理：保存面板地址、账号、密码，测试连接并同步入站。
 - 本地入站展示名维护，套餐绑定同步后的入站线路。
 - 探测 Token 管理：用于 Agent 上报延迟、路由和节点日志。
-- 用户、订单、套餐、订阅、流媒体服务、支付配置。
+- 用户、订单、充值订单、套餐、订阅、流媒体服务、支付配置。
+- 钱包与卡密：生成余额充值卡、套餐充值卡，查看兑换详情，删除卡密；套餐卡会占用/释放套餐库存。
+- 套餐 Push 管理：配置总开关、固定转让费、单周期次数、最低剩余天数和最低剩余流量，查看和删除历史记录。
 - SMTP 邮件服务设置、注册邮箱验证开关、邮件模板发送。
 - 公告、工单、系统设置、审计日志、任务中心、备份恢复。
 - 日志清理：审计、任务、流量、延迟和风控日志支持手动删除与自动过期清理。
@@ -328,11 +332,13 @@ server {
 2. 配置 SMTP 邮件服务并点击“测试发信”。
 3. 按需要开启注册邮箱验证。忘记密码和邮箱变更也会使用 SMTP。
 4. 进入“支付配置”，填写并启用至少一种支付方式。
-5. 添加 3x-ui 节点，测试连接并同步入站。
-6. 创建代理套餐，绑定入站；或创建流媒体服务和套餐。
-7. 在节点页生成探测 Token，安装 Agent。
-8. 用普通用户注册、下单、支付、查看订阅，走一遍完整流程。
-9. 进入“订阅风控”，确认地图、IP、分析日志、人工操作按钮都能正常展示。
+5. 如需钱包，确认余额支付开启，并用低金额测试余额充值和余额支付。
+6. 添加 3x-ui 节点，测试连接并同步入站。
+7. 创建代理套餐，绑定入站；或创建流媒体服务和套餐。
+8. 按需配置充值卡、套餐 Push、三网推荐和线路体验。
+9. 在节点页生成探测 Token，安装 Agent。
+10. 用普通用户注册、下单、支付、查看订阅，走一遍完整流程。
+11. 进入“订阅风控”，确认地图、IP、分析日志、人工操作按钮都能正常展示。
 
 可以展示给用户的常用入口：
 
@@ -341,6 +347,8 @@ server {
 - 套餐商店：`https://你的域名/store`
 - 用户中心：`https://你的域名/dashboard`
 - 订阅列表：`https://你的域名/subscriptions`
+- 钱包：`https://你的域名/wallet`
+- 套餐 Push：`https://你的域名/subscriptions/push`
 - 工单中心：`https://你的域名/support`
 
 ## 邮件与邮箱验证
@@ -361,6 +369,7 @@ SMTP 配置在后台“系统设置”中完成，密码会加密保存在数据
 
 | 支付方式 | 适用场景 | 必填信息 | 回调 / 查询说明 |
 | --- | --- | --- | --- |
+| 余额支付 | 默认启用，适合用户用钱包余额支付订单 | 可选显示名称 | 不走外部网关。关闭时后台会提示确认，普通订单不能再选择余额支付；余额充值本身不能使用余额支付。 |
 | 易支付 | 第三方聚合支付，常用于支付宝/微信通道 | API 地址、商户 ID、商户密钥、启用渠道 | 通知地址为 `https://你的域名/api/payment/notify/epay`。支持 `alipay`、`wxpay` 渠道。 |
 | 支付宝当面付 | 支付宝官方扫码支付 | App ID、应用私钥、支付宝公钥、网关地址 | 通知地址为 `https://你的域名/api/payment/notify/alipay_f2f`，也支持订单查询兜底。 |
 | USDT TRC20 | 加密货币收款 | TRC20 钱包地址、汇率，可选 TronGrid API Key | 没有传统回调，系统按订单金额查询近期 TRC20 入账。建议配置 TronGrid API Key 提高稳定性。 |
@@ -373,6 +382,27 @@ SMTP 配置在后台“系统设置”中完成，密码会加密保存在数据
 - 支付宝密钥可以填写纯 key 内容或 PEM 格式；系统会自动补 PEM 包装。
 - USDT TRC20 按金额匹配入账，测试时避免短时间出现多笔完全相同金额。
 
+## 钱包、充值卡与套餐 Push
+
+钱包在用户端 `/wallet` 使用。用户可以创建余额充值订单，选择除余额支付外的外部支付方式完成充值；充值订单可取消，管理员可在订单页的“充值订单”标签查看。普通商品订单支持余额支付，余额不足时会给出可读错误。
+
+充值卡在后台“商业配置”中生成：
+
+- 余额充值卡：兑换后立即入账用户余额。
+- 套餐充值卡：只能绑定已有套餐，兑换后立即激活套餐。
+- 套餐卡生成时会立即占用套餐库存；删除尚未兑换且未过期的套餐卡会释放库存。
+- 卡密列表支持分页、每页数量选择、查看兑换人和兑换时间。
+
+套餐 Push 在用户端 `/subscriptions/push` 使用，后台在“系统设置 -> 套餐 Push”配置：
+
+- 可单独开启或关闭套餐 Push。
+- 可设置固定转让费，支持转出方支付或接收方支付。
+- 可设置同一订阅周期内最多 Push 次数。续费后进入新周期，次数重新计算。
+- 可设置低于多少天到期、剩余多少 GB 流量时不可 Push。
+- 发起后套餐会暂停并禁用 3x-ui client；接收方 24 小时内确认后才转入。
+- 接收成功会删除旧 3x-ui client，给接收方生成新的 client；过期、拒收或取消会恢复原套餐并退回已扣手续费。
+- 管理端 `/admin/subscription-transfers` 可查看详情并删除历史记录。待接收记录被管理员删除时，会先取消转让、恢复套餐并退费。
+
 ## 节点、3x-ui 与 Agent
 
 节点接入流程：