feat(admin): support billing deadline units

go
codex 4 weeks ago
parent d2eb589f50
commit bc5d7ce263

@ -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 重启。

@ -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 });
});

@ -77,9 +77,17 @@
<div class="form-text">从账户余额扣费。设置为 0.00 时关闭用户自助更换 IP;新价格只影响之后新提交的请求。</div>
</div>
<div class="col-md-6">
<label class="form-label" for="cloud_provision_invoice_payment_window_minutes">新建实例账单支付期限(分钟)</label>
<input class="form-control" id="cloud_provision_invoice_payment_window_minutes" name="cloud_provision_invoice_payment_window_minutes" type="number" min="1" max="10080" step="1" inputmode="numeric" value="30" required>
<div class="form-text">范围 1–10080 分钟。60 表示 1 小时,1440 表示 1 天;只影响保存后新生成的实例开通账单。</div>
<label class="form-label" for="cloud_provision_invoice_payment_window_value">新建实例账单支付期限</label>
<div class="input-group">
<input class="form-control" id="cloud_provision_invoice_payment_window_value" type="number" min="1" max="10080" step="1" inputmode="numeric" value="30" required>
<select class="form-select" id="cloud_provision_invoice_payment_window_unit" aria-label="账单支付期限单位">
<option value="minutes">分钟</option>
<option value="hours">小时</option>
<option value="days">天</option>
</select>
</div>
<input id="cloud_provision_invoice_payment_window_minutes" name="cloud_provision_invoice_payment_window_minutes" type="hidden" value="30">
<div class="form-text">可设置 1–10080 分钟、1–168 小时或 1–7 天;只影响保存后新生成的实例开通账单。</div>
</div>
</div>
</div>
@ -318,6 +326,7 @@
<div class="admin-toast" id="configToast"></div>
<script src="/theme/venix/js/jquery.js?v={$venix_asset_version}"></script>
<script src="/cloud/admin-config-units.js?v={$venix_asset_version}"></script>
{literal}
<script>
(function () {
@ -327,6 +336,10 @@
var submit = document.getElementById('config_submit');
var clearTrustedLoginDevices = document.getElementById('clearTrustedLoginDevices');
var clearAllLoginSessions = document.getElementById('clearAllLoginSessions');
var paymentWindowMinutes = document.getElementById('cloud_provision_invoice_payment_window_minutes');
var paymentWindowValue = document.getElementById('cloud_provision_invoice_payment_window_value');
var paymentWindowUnit = document.getElementById('cloud_provision_invoice_payment_window_unit');
var paymentWindowUnits = window.VenixAdminConfigUnits;
var submitLocked = submit.disabled;
var trustedLocked = clearTrustedLoginDevices.disabled;
var sessionsLocked = clearAllLoginSessions.disabled;
@ -344,6 +357,37 @@
status.className = 'admin-config-status ' + (type || '');
}
function applyPaymentWindowBounds() {
paymentWindowValue.max = String(
paymentWindowUnits.maxValue(paymentWindowUnit.value)
);
}
function syncPaymentWindowMinutes() {
try {
paymentWindowMinutes.value = String(paymentWindowUnits.toMinutes(
paymentWindowValue.value,
paymentWindowUnit.value
));
paymentWindowValue.setCustomValidity('');
return true;
} catch (error) {
paymentWindowMinutes.value = '';
paymentWindowValue.setCustomValidity(
error && error.message ? error.message : '账单支付期限无效'
);
return false;
}
}
function fillPaymentWindow(minutes) {
var display = paymentWindowUnits.fromMinutes(minutes);
paymentWindowValue.value = String(display.value);
paymentWindowUnit.value = display.unit;
applyPaymentWindowBounds();
syncPaymentWindowMinutes();
}
function populateThemeOptions(themes) {
if (!Array.isArray(themes) || !themes.length) {
themes = ['venix'];
@ -372,10 +416,12 @@
field.val(data[name]);
}
});
fillPaymentWindow(data.cloud_provision_invoice_payment_window_minutes);
}
function collectForm() {
var payload = {};
syncPaymentWindowMinutes();
$('#config-form').find('[name]').each(function () {
var field = $(this);
payload[field.attr('name')] = field.val();
@ -493,6 +539,11 @@
}
$('#reloadBtn').on('click', loadConfig);
paymentWindowValue.addEventListener('input', syncPaymentWindowMinutes);
paymentWindowUnit.addEventListener('change', function () {
applyPaymentWindowBounds();
syncPaymentWindowMinutes();
});
$('#clearTrustedLoginDevices').on('click', clearAllTrustedLoginDevices);
$('#clearAllLoginSessions').on('click', revokeAllLoginSessions);
$('#config-form').on('submit', function (event) {
@ -500,6 +551,8 @@
saveConfig();
});
applyPaymentWindowBounds();
syncPaymentWindowMinutes();
loadConfig();
})();
</script>

@ -1,2 +1,2 @@
{* Shared Venix CSS/JS cache key. Increment whenever a shared browser asset changes. *}
{assign var=venix_asset_version value='2026102408' scope='global'}
{assign var=venix_asset_version value='2026102409' scope='global'}

@ -0,0 +1,42 @@
import assert from 'node:assert/strict';
import { createRequire } from 'node:module';
import { readFileSync } from 'node:fs';
const require = createRequire(import.meta.url);
const units = require('../public/cloud/admin-config-units.js');
const template = readFileSync(new URL(
'../resources/views/venix/admin/config.tpl', import.meta.url
), 'utf8');
assert.deepEqual(units.fromMinutes(30), {
value: 30, unit: 'minutes', minutes: 30,
});
assert.deepEqual(units.fromMinutes('60'), {
value: 1, unit: 'hours', minutes: 60,
});
assert.deepEqual(units.fromMinutes(1440), {
value: 1, unit: 'days', minutes: 1440,
});
assert.equal(units.toMinutes('45', 'minutes'), 45);
assert.equal(units.toMinutes('2', 'hours'), 120);
assert.equal(units.toMinutes('7', 'days'), 10080);
assert.equal(units.maxValue('minutes'), 10080);
assert.equal(units.maxValue('hours'), 168);
assert.equal(units.maxValue('days'), 7);
for (const args of [
['0', 'minutes'], ['1.5', 'hours'], ['8', 'days'],
['169', 'hours'], ['1', 'weeks'],
]) {
assert.throws(() => units.toMinutes(...args), RangeError);
}
for (const value of ['0', '1.5', '10081', 'invalid']) {
assert.throws(() => units.fromMinutes(value), RangeError);
}
assert.match(template,
/name="cloud_provision_invoice_payment_window_minutes" type="hidden"/);
assert.match(template,
/id="cloud_provision_invoice_payment_window_unit"[\s\S]*?<option value="minutes">分钟<\/option>[\s\S]*?<option value="hours">小时<\/option>[\s\S]*?<option value="days">天<\/option>/);
console.log('Administrator payment-window unit conversion checks passed.');

@ -76,7 +76,14 @@ $assert(str_contains($invoiceService,
'CloudProvisioningBillingConfig::validatePaymentWindowMinutes(')
&& str_contains($configTemplate,
'name="cloud_provision_invoice_payment_window_minutes"')
&& str_contains($configTemplate, '1440 表示 1 天'),
&& str_contains($configTemplate,
'id="cloud_provision_invoice_payment_window_value"')
&& str_contains($configTemplate,
'id="cloud_provision_invoice_payment_window_unit"')
&& str_contains($configTemplate,
'/cloud/admin-config-units.js?v={$venix_asset_version}')
&& str_contains($configTemplate, 'paymentWindowUnits.toMinutes(')
&& str_contains($configTemplate, 'fillPaymentWindow('),
'Provisioning payment-window admin configuration is incomplete.');
echo "Cloud provisioning payment-window configuration checks passed.\n";

Loading…
Cancel
Save