LSE LotteryEcosystem - 彩票生态系统 V1.0.0

# LotteryEcosystem v1.0.0
面向 LeviLamina 的服务器内虚拟经济彩票系统。
命令：`/lottery`
## 这版相对 v1 的核心变化
1. **不再直接写 PrivateBankSelf 的 JSON。**
所有银行读写都通过 `ll.exports / ll.imports` Remote Function Call 完成。
2. 彩票数据改为 `_state_v2` 单状态 JSON 字符串写入，减少同一插件内部多 key 分步写入导致的状态撕裂。
3. 资金操作增加 wallet journal。若恰好在 LLMoney 加减款和状态落盘之间崩服，不会自动盲目重试，而是进入 OP 人工对账。
4. 审计流水采用 SHA-256 链式校验；彩票开奖保存 seed、seedHash、snapshotHash，并可保留完整彩票快照。
5. 开奖先形成完整奖金计划并校验，再执行派奖。
6. 增加彩票公会、中奖纪念凭证、预言家排行榜、购票公益捐赠比例、完整份额彩票定期开奖、银行彩票多奖级。
## 完整玩法
### 传统高阶乐透
- 6/35。
- 每日开奖。
- 一等奖、二等奖、三等奖、四等奖。
- 一等奖滚存封顶。
- 一等奖封顶溢出进入二等奖。
- 二等奖再次超过封顶进入公益金库。
- 无人中的高等奖滚存。
- 服务器每期注入最低保障奖金。
- Extra 加码：中低等奖获得额外奖金，一等奖不加倍。
- Extra 费用拆为 Extra 奖励池与公益金。
- 单份奖金封顶，超过部分滚存回总奖池。
- 先生成完整派奖计划并核对可用池，再发款。
### 永续超级大奖
- 默认 7 天一开奖。
- 无人命中长期滚存。
- `cap=0` 表示无封顶。
- 主页面实时显示当前超级头奖。
### 份额彩票
- 默认票价 10000。
- 60% 本金购买后立即返还。
- 40% 进入奖池。
- 每票获得 1-100 号码。
- 每日定时开奖。
- 命中者平分奖池；无人命中滚存。
### 竞技预测
- OP 可视化创建事件与多个选项。
- 页面显示动态估算赔率。
- 采用最终资金比例的 pari-mutuel 结算，避免服务器产生无法覆盖的固定赔率负债。
- 未分胜负全额退款。
- 正确次数进入预言家排行榜。
### 银行联名彩票
- 必须安装 PrivateBankSelf v2。
- 银行已开股市。
- 银行总资金 >= 400000。
- 行长提交申请，OP 审批。
- 默认发行费 50000，可由 OP 配置为 0 或其他数值。
- 只有本行储户可购买。
- 银行可设置最低信誉门槛。
- 合金/钻石/黄金客户享票价折扣。
- 支持 LLMoney 购买。
- 支持直接从该银行活期存款托管扣款。
- 每笔购票：75% 奖池、20% 银行盈利、5% 公益；主动捐赠额 100% 入公益。
- 6中6 / 6中5 / 6中4 三档。
- 无人中奖档位资金继续滚入下一期。
- 彩票营收/赔付通过 RPC 写回银行 `lotteryPnl` 和 `lotteryStockWeight`。
- 私人银行次日股票刷新自行读取权重并衰减。
- 开奖公告通过银行 RPC 写入银行公告板。
发行费使用 `PrivateBankSelf::lotteryChargeIssueFee` 专用幂等 RPC，在 **OP 批准时从该银行盈利池扣除**。该接口只用于银行彩票发行费，并限制单次扣费上限，避免开放任意负数入账接口。
### 二级市场
- 未开奖的个人彩票可以挂牌。
- 自定义售价。
- 买家支付、卖家到账后所有权转移。
- 可撤单。
- 开奖前 30 分钟停止二级市场交易。
- 默认开奖前 120 秒停止新购票并生成 SHA-256 安全快照；开奖时再次计算有效票快照，若不一致立即停止开奖并通知 OP。
- 手续费默认 1%，范围 0.5%-2%。
- AAA / AA 市场手续费减免。
- OP 可关闭整个二级市场、冻结彩票、强制下架订单。
- 行情页显示近期成交。
### 财团合买
- 玩家创建合买目标与每份价格。
- 资金进入冻结托管池。
- 发起人无权提现托管资金。
- 达标自动购买传统乐透。
- 未达标到期自动全额退款。
- 中奖后按认购份额自动分红。
- 合金客户免合买创建费。
- 历史永久留痕。
### 彩票公会
- OP 可以全局关闭公会金库。
- 创建公会与加入公会。
- 成员向公共金库存款。
- 会长/管理员用公共金库批量采购传统乐透。
- 公会中奖彩票奖金自动进入公会金库。
- 管理员可把指定奖金总额平均分给全部活跃成员。
- 管理员无法直接把公会金库提现给自己。
- OP 可以冻结违规公会。
- 所有存款、购票、中奖、分配都有流水。
### 中奖纪念凭证
- 每次中奖自动产生一个永久收藏记录。
- 包含凭证 ID、彩票、期号、类型、奖金与时间。
- **无经济价值、不可交易**，只是你要求的“NFT 凭证”式纪念收藏，不接区块链。
### 公益捐赠
- 传统乐透、超级大奖、份额彩票、竞技预测、银行彩票购买前都可选择额外捐赠比例。
- 默认档位 0% / 1% / 2% / 5% / 10%。
- 捐赠直接进入服务器公益金库。
### 风控
- AAA/AA/A/B/C/E 读取 PrivateBankSelf 信誉。
- E 级禁止彩票。
- AAA / AA 提高单期购票上限。
- B / C 降低上限。
- 钻石额外 +50% 单期上限。
- 24h 投注总额限制。
- 二级市场单日交易额限制。
- 高频点击冷却。
- 大额投注二次确认。
- 7 日累计亏损预警。
- 达更高阈值触发 24h 冷静期。
- 全服单日奖金达到阈值触发当日熔断。
### OP 后台
- 多彩票独立票价/周期/封顶配置。
- 竞猜创建与结算。
- 银行彩票审批。
- 彩票/市场/公会总开关。
- 风险监控仪表盘。
- 公益金全服或指定玩家福利。
- 玩家彩票封禁。
- 彩票冻结。
- 市场订单强制下架。
- 合买与公会监管。
- 开奖快照。
- 审计日志检索。
- SHA-256 审计链校验。
- LLMoney 不确定交易人工对账。
## 崩服安全模型
LLMoney 与 JSON 文件之间没有数据库事务，因此无法在纯 QuickJS 插件中获得严格意义的跨系统 ACID。
v1 的策略是：
- 操作前写 `prepared` journal。
- 执行 LLMoney。
- 成功后写 `done`。
- 如果服务器恰好在 LLMoney 已执行、`done` 尚未写入时崩溃，下次启动不会自动再扣/再发。
- 该操作进入 OP `/lottery` → `钱包人工对账`。
- OP 查看 LLMoney 实际记录后选择“标记已完成”或“确认未执行，重试一次”。
这是为了优先防止重复扣款和重复派奖。
## 银行插件要求
请同时安装本包所必需的依赖前置 `PrivateBankSelf v2.0.0`。
它导出：
- `PrivateBankSelf::getBankCatalog`
- `PrivateBankSelf::getClientProfile`
- `PrivateBankSelf::getOwnerBanks`
- `PrivateBankSelf::lotteryPurchaseFromDeposit`
- `PrivateBankSelf::lotteryAddProfit`
- `PrivateBankSelf::lotteryChargeIssueFee`
- `PrivateBankSelf::lotteryAdjust`
- `PrivateBankSelf::creditDemand`
资金 RPC 使用 reqId 幂等键。
## 生产服上线前
强烈建议复制正式服经济数据到测试服后测试：
- 4+ 玩家同期开奖。
- 开奖过程中强制结束 BDS。
- LLMoney 扣款后立即崩服。
- 银行 RPC 插件被卸载/未加载。
- 二级市场成交过程中崩服。
- 公会批量购票与合买自动出票。
- 当日奖金熔断。
- 银行彩票股市联动。
- 审计链校验。

## v1.0.0 已补齐的原高阶扩展
- 彩票公会 / 公共金库。
- 公会管理员批量采购、中奖入公会金库、向活跃成员分配。
- 中奖永久纪念凭证（NFT 风格收藏，无经济价值）。
- 预言家排行榜。
- 购票主动公益捐赠比例 UI。
- 份额彩票完整定时开奖与滚存。
- 银行彩票多奖级及跨插件财报/股市权重联动。
- 当日派奖熔断后的锁定计划延期恢复。
- 开奖前封盘快照与开奖时二次一致性校验。
- 彩票期结束后未中奖票与残留市场挂单自动失效。
- OP 对合买托管纠纷的冻结与剩余托管资金强制退款。