diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 12ffe41e..f822a464 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -321,7 +321,7 @@ location = /agent/console { 3. 配置预先存在的 bridge 和一个或多个公网 IPv4 CIDR;显式保留宿主机管理 IP。Agent 不通过扫描推测可售地址。 4. 导入云镜像和救援 ISO。远程下载只接受可公开解析的 HTTPS 直链,Agent 会校验初始地址与全部跳转;来源的发行方可信度由管理员确认。本地云镜像必须是独立、未加密、无 backing/data file 的 QCOW2,本地救援镜像必须是可启动 ISO。面板会把本地暂存文件的精确大小和摘要写入签名任务,代理可使用 chunked 传输,但不得压缩响应或改变正文;Agent 会拒绝短读、多余字节、长度或摘要不一致。 5. 为每个云镜像按需设置首次安装启动脚本。脚本最大 32 KiB UTF-8、拒绝 NUL;保存后修订递增,新创建任务快照当前版本。不要在脚本中写长期密钥。 -6. 在 `/admin/config` 的“云实例计费”中设置新建实例账单支付期限,单位为分钟;`60` 表示 1 小时,`1440` 表示 1 天。该值只作用于保存后新生成的开通账单,既有账单保持原截止时间。 +6. 在 `/admin/config` 的“云实例计费”中用“数值+分钟/小时/天”设置新建实例账单支付期限;面板保存时统一换算为整数分钟。该值只作用于保存后新生成的开通账单,既有账单保持原截止时间。 7. 创建销售套餐和库存,再启用宿主机/Agent 调度。用户支付成功后只应创建一个 VM。 部署人员根据宿主机 domain capabilities 选择 Q35 UEFI loader/NVRAM 并写入该机 Agent 配置,Agent 用这组本地固定值生成明确关闭 Secure Boot 的 XML。首次启动脚本由 cloud-init 一次性 runner 执行;VM 创建成功不等待脚本完成,脚本失败或中断不自动重放。 @@ -341,7 +341,7 @@ location = /agent/console { - 杀死超时 helper 后确认整个进程组已回收;只有 `Wait` 成功才释放资源 admission。不能回收时,新冲突请求必须立即被执行栅栏拒绝。 - 重复、乱序和晚到完成回执不能改变终态或触发 mutation;允许类型的精确同源回执最多幂等收敛 PHP 副作用账本与 effect fence。回执在精确 ACK 前按固定低频间隔持续投递,旧 attempts/expires 不得使其永久退出 outbox。 - 并发购买不超卖 CPU/内存/磁盘/IP;同一 VM 变更串行。 -- 分别把新建实例账单支付期限设为 60 和 1440 分钟,确认新账单截止时间为 1 小时和 1 天且旧账单不变;续费账单无论何时生成,其支付截止都必须等于对应实例到期时间加三天。 +- 分别把新建实例账单支付期限设为“1 小时”和“1 天”,确认新账单截止时间为 1 小时和 1 天且旧账单不变;续费账单无论何时生成,其支付截止都必须等于对应实例到期时间加三天。 - RX+TX 额度用尽只断网;下一账期恢复;最终到期只断网;三天宽限结束后删除定义与面板受管磁盘。 - MariaDB、Redis、SMTP、支付回调、大文件上传和 PHP-FPM 重启。 diff --git a/web/public/cloud/admin-config-units.js b/web/public/cloud/admin-config-units.js new file mode 100644 index 00000000..f23e1c85 --- /dev/null +++ b/web/public/cloud/admin-config-units.js @@ -0,0 +1,70 @@ +(function (root, factory) { + 'use strict'; + const api = factory(); + if (typeof module === 'object' && module.exports) module.exports = api; + if (root) root.VenixAdminConfigUnits = api; +})(typeof globalThis !== 'undefined' ? globalThis : this, function () { + 'use strict'; + + const definitions = Object.freeze({ + minutes: Object.freeze({ multiplier: 1, max: 10080 }), + hours: Object.freeze({ multiplier: 60, max: 168 }), + days: Object.freeze({ multiplier: 1440, max: 7 }), + }); + + function definition(unit) { + if (!Object.prototype.hasOwnProperty.call(definitions, unit)) { + throw new RangeError('账单支付期限单位无效'); + } + return definitions[unit]; + } + + function positiveInteger(value) { + const raw = String(value == null ? '' : value).trim(); + if (!/^[1-9][0-9]*$/.test(raw)) { + throw new RangeError('账单支付期限请输入正整数'); + } + const amount = Number(raw); + if (!Number.isSafeInteger(amount)) { + throw new RangeError('账单支付期限超出允许范围'); + } + return amount; + } + + function maxValue(unit) { + return definition(unit).max; + } + + function toMinutes(value, unit) { + const amount = positiveInteger(value); + const selected = definition(unit); + if (amount > selected.max) { + throw new RangeError('账单支付期限超出允许范围'); + } + return amount * selected.multiplier; + } + + function fromMinutes(value) { + const minutes = positiveInteger(value); + if (minutes > definitions.minutes.max) { + throw new RangeError('账单支付期限超出允许范围'); + } + if (minutes % definitions.days.multiplier === 0) { + return Object.freeze({ + value: minutes / definitions.days.multiplier, + unit: 'days', + minutes, + }); + } + if (minutes % definitions.hours.multiplier === 0) { + return Object.freeze({ + value: minutes / definitions.hours.multiplier, + unit: 'hours', + minutes, + }); + } + return Object.freeze({ value: minutes, unit: 'minutes', minutes }); + } + + return Object.freeze({ fromMinutes, maxValue, toMinutes }); +}); diff --git a/web/resources/views/venix/admin/config.tpl b/web/resources/views/venix/admin/config.tpl index 157f0973..e1b13326 100644 --- a/web/resources/views/venix/admin/config.tpl +++ b/web/resources/views/venix/admin/config.tpl @@ -77,9 +77,17 @@