feat(traffic): add administrator pool console

go
codex 2 weeks ago
parent 3beb24fff8
commit aae35410b8

@ -17,7 +17,7 @@ use App\Models\CloudResourceReservation;
/** Database-only administrator projections for regions, lines, pools and reservations. */
final class CloudAdminResourceService
{
private const VIEWS = ['topology', 'capacity', 'reservations'];
private const VIEWS = ['topology', 'capacity', 'reservations', 'traffic'];
private const REGION_STATUSES = ['active', 'disabled'];
private const LINE_STATUSES = ['active', 'disabled'];
private const POOL_STATUSES = ['active', 'draining', 'disabled'];
@ -29,6 +29,14 @@ final class CloudAdminResourceService
$requested = $query['view'] ?? 'topology';
$view = is_string($requested) && in_array($requested, self::VIEWS, true)
? $requested : 'topology';
if ($view === 'traffic') {
return [
'view' => 'traffic',
'focus' => 'all',
'traffic_pools' => CloudAdminTrafficPoolService::page($query),
'generated_at' => time(),
];
}
$catalog = self::catalog();
$focus = is_string($query['focus'] ?? null) ? $query['focus'] : 'all';
if (!in_array($focus, ['all', 'ready_pools', 'hosts', 'ready_hosts', 'cpu', 'ip'], true)) {
@ -37,13 +45,25 @@ final class CloudAdminResourceService
$reservationPage = $view === 'reservations'
? self::reservations($query)
: self::emptyReservationPage();
return array_merge($catalog, self::capacitySelection($catalog, $focus), [
'view' => $view,
'focus' => $focus,
'line_feature_enabled' => CloudNetworkLineFeature::enabled(),
'country_options' => CloudCountryCatalog::options(),
'reservations' => $reservationPage,
'traffic_pools' => [
'items' => [],
'lines' => [],
'summary' => [
'groups_total' => 0,
'disabled' => 0,
'shadow' => 0,
'enforced' => 0,
'ready_to_enforce' => 0,
],
'sample_freshness_seconds' => 300,
'generated_at' => time(),
],
'generated_at' => time(),
]);
}

@ -7,6 +7,7 @@ use App\Models\CloudInstanceNetworkPolicyState;
use App\Models\CloudInstanceNetworkRestriction;
use App\Models\CloudNetworkLine;
use App\Models\CloudOrder;
use App\Models\CloudRegion;
use App\Models\CloudResourcePool;
use App\Models\CloudServicePeriod;
use App\Models\CloudTrafficEntitlement;
@ -21,16 +22,49 @@ final class CloudAdminTrafficPoolService
{
private const MODES = ['disabled', 'shadow', 'enforced'];
private const SAMPLE_FRESHNESS_SECONDS = 300;
private const BLOCKER_LABELS = [
'no_network_lines' => '尚未绑定线路',
'line_frozen_identity_mismatch' => '订单或服务周期的冻结身份不一致',
'pool_attention' => '账本池需要人工核查',
'projection_invalid' => '账本投影校验失败',
'missing_entitlements' => '服务周期缺少流量权益',
'missing_pools' => '流量权益缺少账本池',
'period_identity_mismatch' => '服务周期与流量权益不一致',
'instance_not_ready' => '实例尚未达到核算条件',
'usage_unsettled' => '最新流量尚未完成结算',
'legacy_network_unsettled' => '实例网络状态尚未收敛',
'cursor_attention' => '实例核算游标需要人工核查',
'cursor_missing' => '实例缺少有效核算游标',
'traffic_sample_stale' => '流量采样已过期',
'traffic_scan_failures' => '流量扫描存在失败记录',
'policy_unsettled' => '实例网络策略尚未应用',
'traffic_restriction_present' => '仍有共享流量池断网限制',
'network_job_unsettled' => '仍有网络任务未完成',
];
public static function page(array $query = []): array
{
$items = [];
$summary = [
'groups_total' => 0,
'disabled' => 0,
'shadow' => 0,
'enforced' => 0,
'ready_to_enforce' => 0,
];
foreach (CloudTrafficPoolGroup::orderBy('id')->get() as $group) {
$items[] = self::groupDto($group);
$item = self::groupDto($group);
$items[] = $item;
$summary['groups_total']++;
$summary[$item['mode']]++;
if ($item['readiness']['can_enforce']) {
$summary['ready_to_enforce']++;
}
}
return [
'items' => $items,
'lines' => self::lineCatalog(),
'summary' => $summary,
'sample_freshness_seconds' => self::SAMPLE_FRESHNESS_SECONDS,
'generated_at' => time(),
];
@ -546,6 +580,8 @@ final class CloudAdminTrafficPoolService
sort($subjectIds, SORT_NUMERIC);
$list[] = [
'code' => $code,
'label' => self::BLOCKER_LABELS[$code]
?? '存在未识别的就绪阻断项',
'count' => count($subjectIds),
'subject_ids' => array_slice($subjectIds, 0, 20),
];
@ -604,12 +640,22 @@ final class CloudAdminTrafficPoolService
private static function lineCatalog(): array
{
$lines = CloudNetworkLine::orderBy('region_id')->orderBy('sort')
->orderBy('id')->get();
$regionIds = $lines->pluck('region_id')->map(
static fn ($id): int => (int) $id
)->unique()->values()->all();
$regions = $regionIds === [] ? collect() : CloudRegion::whereIn(
'id', $regionIds
)->pluck('name', 'id');
$items = [];
foreach (CloudNetworkLine::orderBy('region_id')->orderBy('sort')
->orderBy('id')->get() as $line) {
foreach ($lines as $line) {
$items[] = [
'id' => (int) $line->id,
'region_id' => (int) $line->region_id,
'region_name' => (string) (
$regions[(int) $line->region_id] ?? '未知地区'
),
'code' => (string) $line->code,
'name' => (string) $line->name,
'status' => (string) $line->status,

@ -0,0 +1,207 @@
const root = document.querySelector('[data-admin-resources][data-resource-view="traffic"]');
const bootstrapNode = document.getElementById('admin-resources-bootstrap');
let page = null;
try { page = JSON.parse(bootstrapNode?.textContent || 'null'); } catch { page = null; }
if (root) {
const requestRuntime = window.VenixAdminRequestRuntime.create();
const drawerState = { dialog: null, opener: null, scrollY: 0 };
function byId(id) { return document.getElementById(id); }
function group(id) {
return (page?.traffic_pools?.items || []).find(item => String(item.id) === String(id)) || null;
}
function notice(id, message, tone = '') {
const node = byId(id);
if (!node) return;
node.textContent = message;
node.className = `admin-config-status mt-3 ${tone ? `is-${tone}` : ''}`;
node.setAttribute('role', tone === 'error' ? 'alert' : 'status');
}
function pageNotice(message, error = false) {
const node = byId('resource-notice');
if (!node) return;
node.textContent = message;
node.className = `admin-config-status ${error ? 'is-error' : 'is-success'}`;
node.setAttribute('role', error ? 'alert' : 'status');
}
async function mutate(path, options) {
return requestRuntime.mutate(path, {
method: options.method,
body: options.body,
timeoutMs: 20000,
response: 'json',
});
}
function openDrawer(dialog, opener) {
if (!dialog) return;
drawerState.dialog = dialog;
drawerState.opener = opener || document.activeElement;
drawerState.scrollY = window.scrollY;
document.documentElement.style.setProperty('--admin-instance-scroll-top', `-${drawerState.scrollY}px`);
document.documentElement.classList.add('admin-instance-detail-open');
window.VenixDrawerMotion?.openDrawerWithMotion(dialog) || dialog.showModal();
}
async function closeDrawer(dialog) {
if (!dialog?.open) return;
if (window.VenixDrawerMotion) await window.VenixDrawerMotion.closeDrawerWithMotion(dialog);
else dialog.close();
document.documentElement.classList.remove('admin-instance-detail-open');
document.documentElement.style.removeProperty('--admin-instance-scroll-top');
window.scrollTo({ top: drawerState.scrollY, left: 0, behavior: 'instant' });
const opener = drawerState.opener;
drawerState.dialog = null;
drawerState.opener = null;
if (opener instanceof HTMLElement && opener.isConnected) opener.focus({ preventScroll: true });
}
for (const dialog of document.querySelectorAll('[data-admin-traffic-drawer]')) {
dialog.addEventListener('cancel', event => { event.preventDefault(); void closeDrawer(dialog); });
dialog.addEventListener('click', event => { if (event.target === dialog) void closeDrawer(dialog); });
}
byId('traffic-group-editor-close')?.addEventListener('click', () => void closeDrawer(byId('traffic-group-editor')));
byId('traffic-line-editor-close')?.addEventListener('click', () => void closeDrawer(byId('traffic-line-editor')));
function configureGroupEditor(item = null) {
const form = byId('traffic-group-editor-form');
if (!form) return false;
form.reset();
form.elements.namedItem('group_id').value = item?.id || '';
form.elements.namedItem('expected_revision').value = item?.revision || '';
form.elements.namedItem('name').value = item?.name || '';
const codeField = form.querySelector('[data-traffic-code-field]');
const codeInput = form.elements.namedItem('code');
codeField.hidden = Boolean(item);
codeInput.disabled = Boolean(item);
codeInput.required = !item;
byId('traffic-group-editor-title').textContent = item ? '修改分组名称' : '新建流量池分组';
byId('traffic-group-editor-eyebrow').textContent = item ? `${item.name} · r${item.revision}` : '共享流量池';
notice('traffic-group-editor-notice', '等待提交');
return true;
}
function configureLineEditor(item) {
const form = byId('traffic-line-editor-form');
if (!form || !item) return false;
form.reset();
form.elements.namedItem('group_id').value = item.id;
form.elements.namedItem('expected_revision').value = item.revision;
byId('traffic-line-editor-title').textContent = `配置 ${item.name} 的线路`;
for (const checkbox of form.querySelectorAll('input[name="line_ids[]"]')) {
const owner = Number(checkbox.dataset.lineOwner || 0);
checkbox.checked = owner === Number(item.id);
checkbox.disabled = owner > 0 && owner !== Number(item.id);
checkbox.closest('label')?.classList.toggle('is-unavailable', checkbox.disabled);
}
notice('traffic-line-editor-notice', '等待提交');
return true;
}
root.addEventListener('click', async event => {
const create = event.target.closest('[data-traffic-create]');
if (create && configureGroupEditor()) {
openDrawer(byId('traffic-group-editor'), create);
return;
}
const rename = event.target.closest('[data-traffic-rename]');
if (rename) {
const item = group(rename.dataset.trafficRename);
if (!item) return pageNotice('找不到流量池分组,请刷新页面。', true);
if (configureGroupEditor(item)) openDrawer(byId('traffic-group-editor'), rename);
return;
}
const lines = event.target.closest('[data-traffic-lines]');
if (lines) {
const item = group(lines.dataset.trafficLines);
if (!item) return pageNotice('找不到流量池分组,请刷新页面。', true);
if (configureLineEditor(item)) openDrawer(byId('traffic-line-editor'), lines);
return;
}
const modeButton = event.target.closest('[data-traffic-mode]');
if (!modeButton || modeButton.disabled) return;
const item = group(modeButton.dataset.trafficMode);
const targetMode = modeButton.dataset.targetMode;
if (!item || !['disabled', 'shadow', 'enforced'].includes(targetMode)) {
return pageNotice('流量池状态操作无效,请刷新页面。', true);
}
const config = targetMode === 'enforced' ? {
tone: 'danger',
title: '开始强制执行共享流量池',
message: '启用后会按照共享余额真实限制实例网络,且不能回退、停用或调整线路。请确认就绪检查与业务验收均已完成。',
confirmText: '开始强制执行',
requiredText: item.name,
requiredLabel: '输入完整分组名称以确认',
} : (targetMode === 'shadow' ? {
tone: 'warning',
title: '进入影子核算',
message: '系统将开始建立真实账本投影,但暂不因共享额度限制实例网络。',
confirmText: '进入影子核算',
} : {
tone: 'warning',
title: '停用影子核算',
message: '仅在尚未形成持久服务周期或账本引用时允许停用。',
confirmText: '确认停用',
});
if (!await window.VenixAdminDangerDialog.confirm(config)) return;
modeButton.disabled = true;
pageNotice('正在更新流量池模式…');
try {
await mutate(`/api/v1/admin/traffic-pool-groups/${item.id}`, {
method: 'PATCH',
body: { mode: targetMode, expected_revision: Number(item.revision) },
});
pageNotice('流量池模式已更新,正在刷新…');
location.reload();
} catch (error) {
pageNotice(error.message || '流量池模式更新失败,请刷新后核对。', true);
modeButton.disabled = false;
}
});
byId('traffic-group-editor-form')?.addEventListener('submit', async event => {
event.preventDefault();
const form = event.currentTarget;
if (!form.reportValidity()) return;
const groupId = form.elements.namedItem('group_id').value;
const submit = byId('traffic-group-editor-submit');
const body = { name: form.elements.namedItem('name').value.trim() };
if (groupId) body.expected_revision = Number(form.elements.namedItem('expected_revision').value);
else body.code = form.elements.namedItem('code').value.trim().toLowerCase();
submit.disabled = true;
notice('traffic-group-editor-notice', '正在保存…', 'loading');
try {
await mutate(`/api/v1/admin/traffic-pool-groups${groupId ? `/${groupId}` : ''}`, {
method: groupId ? 'PATCH' : 'POST', body,
});
notice('traffic-group-editor-notice', '已保存,正在刷新…', 'success');
location.reload();
} catch (error) {
notice('traffic-group-editor-notice', error.message || '保存失败,请刷新后重试。', 'error');
submit.disabled = false;
}
});
byId('traffic-line-editor-form')?.addEventListener('submit', async event => {
event.preventDefault();
const form = event.currentTarget;
const groupId = Number(form.elements.namedItem('group_id').value);
const item = group(groupId);
if (!item) return notice('traffic-line-editor-notice', '分组版本已失效,请刷新页面。', 'error');
const lineIds = Array.from(form.querySelectorAll('input[name="line_ids[]"]:checked:not(:disabled)'),
checkbox => Number(checkbox.value));
const submit = byId('traffic-line-editor-submit');
submit.disabled = true;
notice('traffic-line-editor-notice', '正在保存线路…', 'loading');
try {
await mutate(`/api/v1/admin/traffic-pool-groups/${groupId}/lines`, {
method: 'PUT',
body: { line_ids: lineIds, expected_revision: Number(item.revision) },
});
notice('traffic-line-editor-notice', '线路已保存,正在刷新…', 'success');
location.reload();
} catch (error) {
notice('traffic-line-editor-notice', error.message || '线路保存失败,请刷新后重试。', 'error');
submit.disabled = false;
}
});
}

@ -2629,7 +2629,7 @@ html.admin-instance-detail-open body {
[data-admin-resources] .admin-resource-tabs {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 8px;
margin-bottom: 16px;
padding: 5px;
@ -2943,6 +2943,208 @@ html.admin-instance-detail-open body {
line-height: 1.45;
}
[data-admin-resources] .admin-traffic-group-list {
display: grid;
gap: 16px;
}
[data-admin-resources] .admin-traffic-group {
display: grid;
gap: 16px;
padding: 18px;
border: 1px solid #dfe7f1;
border-radius: 14px;
background: #fff;
box-shadow: 0 8px 24px rgba(39, 63, 93, .05);
}
[data-admin-resources] .admin-traffic-group-header,
[data-admin-resources] .admin-traffic-actions {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
flex-wrap: wrap;
}
[data-admin-resources] .admin-traffic-group-header h3 {
margin: 0;
color: #172338;
font-size: 17px;
font-weight: 800;
}
[data-admin-resources] .admin-traffic-mode {
display: inline-flex;
align-items: center;
min-height: 30px;
padding: 5px 10px;
border-radius: 999px;
font-size: 12px;
font-weight: 800;
white-space: nowrap;
}
[data-admin-resources] .admin-traffic-mode.is-disabled {
color: #667386;
background: #e9edf2;
}
[data-admin-resources] .admin-traffic-mode.is-shadow {
color: #8b5d00;
background: rgba(245, 177, 48, .18);
}
[data-admin-resources] .admin-traffic-mode.is-enforced {
color: #a7272f;
background: rgba(232, 69, 79, .13);
}
[data-admin-resources] .admin-traffic-metrics {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 10px;
}
[data-admin-resources] .admin-traffic-metrics > div {
display: grid;
gap: 3px;
min-width: 0;
padding: 12px;
border-radius: 10px;
background: #f6f9fc;
}
[data-admin-resources] .admin-traffic-metrics span,
[data-admin-resources] .admin-traffic-lines-label {
color: #7b899b;
font-size: 11px;
font-weight: 700;
}
[data-admin-resources] .admin-traffic-metrics strong {
color: #25364d;
font-size: 18px;
}
[data-admin-resources] .admin-traffic-lines {
display: grid;
gap: 7px;
}
[data-admin-resources] .admin-traffic-lines > div {
display: flex;
gap: 7px;
flex-wrap: wrap;
}
[data-admin-resources] .admin-traffic-line-chip {
display: inline-flex;
align-items: center;
gap: 5px;
padding: 5px 8px;
border: 1px solid #dfe7f1;
border-radius: 8px;
color: #43546a;
background: #f8fafc;
font-size: 12px;
font-weight: 700;
}
[data-admin-resources] .admin-traffic-readiness {
margin: 0;
padding: 12px 14px;
border-radius: 10px;
font-size: 13px;
}
[data-admin-resources] .admin-traffic-readiness.is-ready {
color: #08785b;
background: rgba(38, 189, 138, .1);
}
[data-admin-resources] .admin-traffic-readiness.is-blocked {
color: #8e2a31;
background: rgba(232, 69, 79, .08);
}
[data-admin-resources] .admin-traffic-readiness > p {
margin: 0;
font-weight: 700;
}
[data-admin-resources] .admin-traffic-readiness > p i,
[data-admin-resources] .admin-traffic-readiness.is-ready > i {
margin-right: 6px;
}
[data-admin-resources] .admin-traffic-readiness ul {
display: grid;
gap: 8px;
margin: 10px 0 0;
padding: 0;
list-style: none;
}
[data-admin-resources] .admin-traffic-readiness li {
display: grid;
grid-template-columns: minmax(0, 1fr) auto;
gap: 3px 12px;
padding-top: 8px;
border-top: 1px solid rgba(167, 39, 47, .12);
}
[data-admin-resources] .admin-traffic-readiness details {
grid-column: 1 / -1;
color: #7d5960;
font-size: 11px;
}
[data-admin-resources] .admin-traffic-actions {
justify-content: flex-start;
padding-top: 2px;
}
[data-admin-traffic-drawer] .admin-resource-form-fields {
display: grid;
gap: 16px;
}
[data-admin-traffic-drawer] .admin-resource-form-fields > label {
display: grid;
gap: 6px;
}
[data-admin-traffic-drawer] .admin-traffic-line-options {
display: grid;
gap: 10px;
}
[data-admin-traffic-drawer] .admin-traffic-line-options > label {
display: flex;
align-items: flex-start;
gap: 11px;
padding: 12px;
border: 1px solid #e0e8f1;
border-radius: 10px;
cursor: pointer;
}
[data-admin-traffic-drawer] .admin-traffic-line-options > label.is-unavailable {
cursor: not-allowed;
opacity: .55;
}
[data-admin-traffic-drawer] .admin-traffic-line-options span,
[data-admin-traffic-drawer] .admin-traffic-line-options small {
display: block;
}
[data-admin-traffic-drawer] .admin-traffic-line-options small {
margin-top: 3px;
color: #7b899b;
}
[data-admin-resource-drawer] .admin-resource-form-fields {
display: grid;
gap: 16px;
@ -3034,6 +3236,24 @@ html.admin-instance-detail-open body {
grid-template-columns: 1fr;
}
[data-admin-resources] .admin-traffic-group {
padding: 14px;
}
[data-admin-resources] .admin-traffic-group-header,
[data-admin-resources] .admin-traffic-actions {
align-items: stretch;
flex-direction: column;
}
[data-admin-resources] .admin-traffic-actions .btn {
width: 100%;
}
[data-admin-resources] .admin-traffic-metrics {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
[data-admin-resources] .admin-resource-responsive-table,
[data-admin-resources] .admin-resource-responsive-table tbody,
[data-admin-resources] .admin-resource-responsive-table tr,

@ -9,7 +9,7 @@
</article>
{/function}
{if !$resource_page}
{assign var=resource_page value=['view'=>'topology','line_feature_enabled'=>false,'summary'=>['regions_total'=>0,'lines_total'=>0,'pools_total'=>0,'placement_ready_pools'=>0,'hosts_total'=>0,'placement_ready_hosts'=>0,'held_reservations'=>0,'uncertain_reservations'=>0],'country_options'=>[],'topology'=>[],'regions'=>[],'lines'=>[],'pools'=>[],'reservations'=>['items'=>[],'filters'=>['state'=>'','pool_id'=>'','q'=>''],'pagination'=>['page'=>1,'per_page'=>20,'total'=>0,'total_pages'=>1,'from'=>0,'to'=>0]] ]}
{assign var=resource_page value=['view'=>'topology','line_feature_enabled'=>false,'summary'=>['regions_total'=>0,'lines_total'=>0,'pools_total'=>0,'placement_ready_pools'=>0,'hosts_total'=>0,'placement_ready_hosts'=>0,'held_reservations'=>0,'uncertain_reservations'=>0],'country_options'=>[],'topology'=>[],'regions'=>[],'lines'=>[],'pools'=>[],'reservations'=>['items'=>[],'filters'=>['state'=>'','pool_id'=>'','q'=>''],'pagination'=>['page'=>1,'per_page'=>20,'total'=>0,'total_pages'=>1,'from'=>0,'to'=>0]],'traffic_pools'=>['items'=>[],'lines'=>[],'summary'=>['groups_total'=>0,'disabled'=>0,'shadow'=>0,'enforced'=>0,'ready_to_enforce'=>0]] ]}
{/if}
{if !$resource_page.focus}{assign var=resource_focus value='all'}{else}{assign var=resource_focus value=$resource_page.focus}{/if}
@ -27,6 +27,7 @@
<a class="btn {if $resource_page.view == 'topology'}btn-primary{else}btn-light{/if}" href="/admin/resources?view=topology"><i class="mdi mdi-source-branch me-1" aria-hidden="true"></i>资源拓扑</a>
<a class="btn {if $resource_page.view == 'capacity'}btn-primary{else}btn-light{/if}" href="/admin/resources?view=capacity"><i class="mdi mdi-chart-box-outline me-1" aria-hidden="true"></i>容量与健康</a>
<a class="btn {if $resource_page.view == 'reservations'}btn-primary{else}btn-light{/if}" href="/admin/resources?view=reservations"><i class="mdi mdi-shield-check-outline me-1" aria-hidden="true"></i>资源预留</a>
<a class="btn {if $resource_page.view == 'traffic'}btn-primary{else}btn-light{/if}" href="/admin/resources?view=traffic"><i class="mdi mdi-chart-donut-variant me-1" aria-hidden="true"></i>共享流量池</a>
</nav>
{if $resource_page.view == 'topology'}
@ -127,6 +128,75 @@
{/if}
</div>
</section>
{elseif $resource_page.view == 'traffic'}
<section class="row g-3 mb-3 admin-billing-summary" aria-label="共享流量池摘要">
<div class="col-6 col-xl-3"><div class="card admin-stat-card"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">分组总数</h2><strong class="admin-stat-value">{$resource_page.traffic_pools.summary.groups_total|default:0|escape}</strong><p class="text-muted fs-12 mb-0">按线路隔离流量账本</p></div></div></div></div>
<div class="col-6 col-xl-3"><div class="card admin-stat-card"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">影子核算</h2><strong class="admin-stat-value">{$resource_page.traffic_pools.summary.shadow|default:0|escape}</strong><p class="text-muted fs-12 mb-0">只核算,不影响网络</p></div></div></div></div>
<div class="col-6 col-xl-3"><div class="card admin-stat-card"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">可进入强制执行</h2><strong class="admin-stat-value">{$resource_page.traffic_pools.summary.ready_to_enforce|default:0|escape}</strong><p class="text-muted fs-12 mb-0">全部就绪门禁已通过</p></div></div></div></div>
<div class="col-6 col-xl-3"><div class="card admin-stat-card"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">强制执行</h2><strong class="admin-stat-value">{$resource_page.traffic_pools.summary.enforced|default:0|escape}</strong><p class="text-muted fs-12 mb-0">额度耗尽会聚合断网</p></div></div></div></div>
</section>
<section class="card" aria-labelledby="traffic-pool-title">
<div class="card-header admin-resource-section-header">
<div>
<h2 class="h5 card-title mb-1" id="traffic-pool-title">共享流量池分组</h2>
<span class="text-muted fs-13">每条线路只能属于一个分组;停用 → 影子核算 → 强制执行为单向上线流程。</span>
</div>
{if $admin_can_manage|default:false}<button class="btn btn-primary" type="button" data-traffic-create><i class="mdi mdi-plus me-1" aria-hidden="true"></i>新建分组</button>{/if}
</div>
<div class="card-body">
<div class="admin-traffic-group-list">
{foreach $resource_page.traffic_pools.items as $group}
<article class="admin-traffic-group" data-traffic-group="{$group.id|escape}">
<header class="admin-traffic-group-header">
<div class="admin-resource-node-heading">
<span class="admin-resource-node-icon"><i class="mdi mdi-chart-donut-variant" aria-hidden="true"></i></span>
<div><h3>{$group.name|escape}</h3><p><code>{$group.code|escape}</code> · 配置版本 {$group.revision|escape}</p></div>
</div>
<span class="admin-traffic-mode is-{$group.mode|escape}">{if $group.mode == 'disabled'}停用{elseif $group.mode == 'shadow'}影子核算{else}强制执行{/if}</span>
</header>
<div class="admin-traffic-metrics" aria-label="{$group.name|escape} 核算摘要">
<div><span>绑定线路</span><strong>{$group.readiness.line_count|default:0|escape}</strong></div>
<div><span>账本池</span><strong>{$group.readiness.pool_count|default:0|escape}</strong></div>
<div><span>服务周期</span><strong>{$group.readiness.period_count|default:0|escape}</strong></div>
<div><span>活跃实例</span><strong>{$group.readiness.active_instance_count|default:0|escape}</strong></div>
</div>
<div class="admin-traffic-lines" aria-label="已绑定线路">
<span class="admin-traffic-lines-label">线路</span>
<div>{foreach $resource_page.traffic_pools.lines as $line}{if $line.traffic_pool_group_id == $group.id}<span class="admin-traffic-line-chip">{$line.region_name|escape} · {$line.name|escape} <code>{$line.code|escape}</code></span>{/if}{foreachelse}<span class="text-muted fs-12">尚无可用线路</span>{/foreach}{if $group.line_count == 0}<span class="text-muted fs-12">尚未绑定线路</span>{/if}</div>
</div>
{if $group.readiness.ready}
<p class="admin-traffic-readiness is-ready"><i class="mdi mdi-check-circle-outline" aria-hidden="true"></i>{if $group.mode == 'shadow'}就绪门禁已通过,可以进入强制执行。{elseif $group.mode == 'enforced'}强制执行中的账本与网络状态已通过校验。{else}当前配置未发现就绪阻断项。{/if}</p>
{else}
<div class="admin-traffic-readiness is-blocked">
<p><i class="mdi mdi-alert-circle-outline" aria-hidden="true"></i>{if $group.mode == 'enforced'}强制执行状态存在 {$group.readiness.blockers|@count|escape} 类异常,需要立即核查。{else}当前存在 {$group.readiness.blockers|@count|escape} 类阻断项,不能进入强制执行。{/if}</p>
<ul>{foreach $group.readiness.blockers as $blocker}<li><strong>{$blocker.label|escape}</strong><span>{$blocker.count|escape} 项</span><details><summary>技术信息</summary><code>{$blocker.code|escape}</code>{if $blocker.subject_ids} · ID {foreach $blocker.subject_ids as $subject_id}{$subject_id|escape}{if !$subject_id@last}, {/if}{/foreach}{/if}</details></li>{/foreach}</ul>
</div>
{/if}
{if $admin_can_manage|default:false}
<footer class="admin-traffic-actions">
<button class="btn btn-light btn-sm" type="button" data-traffic-rename="{$group.id|escape}">修改名称</button>
{if $group.actions.can_replace_lines}<button class="btn btn-light btn-sm" type="button" data-traffic-lines="{$group.id|escape}">配置线路</button>{/if}
{if $group.actions.next_mode == 'shadow'}
<button class="btn btn-warning btn-sm" type="button" data-traffic-mode="{$group.id|escape}" data-target-mode="shadow" {if !$group.actions.can_advance}disabled{/if}>进入影子核算</button>
{elseif $group.actions.next_mode == 'enforced'}
<button class="btn btn-danger btn-sm" type="button" data-traffic-mode="{$group.id|escape}" data-target-mode="enforced" {if !$group.actions.can_advance}disabled{/if}>开始强制执行</button>
{/if}
{if $group.actions.can_disable}<button class="btn btn-light btn-sm" type="button" data-traffic-mode="{$group.id|escape}" data-target-mode="disabled">停用影子核算</button>{/if}
{if $group.mode == 'enforced'}<span class="text-muted fs-12">强制执行后不可回退、停用或调整线路。</span>{/if}
</footer>
{/if}
</article>
{foreachelse}
<div class="admin-resource-empty"><i class="mdi mdi-chart-donut-variant" aria-hidden="true"></i><strong>尚未建立共享流量池分组</strong><span>先创建分组并绑定线路,再进入影子核算进行验收。</span></div>
{/foreach}
</div>
</div>
</section>
{else}
<section class="card mb-3 admin-billing-filter" aria-labelledby="reservation-filter-title"><div class="card-header"><h2 class="h5 card-title mb-1" id="reservation-filter-title">查找资源预留</h2><span class="text-muted fs-13">预留记录只读;异常保留不会自动重放操作或释放资源。</span></div><div class="card-body"><form class="row g-2 align-items-end" method="get" action="/admin/resources"><input type="hidden" name="view" value="reservations"><label class="col-lg-4"><span class="form-label d-block">关键词</span><input class="form-control" type="search" name="q" maxlength="80" value="{$resource_page.reservations.filters.q|escape}" placeholder="预留键或关联 ID"></label><label class="col-lg-3 col-6"><span class="form-label d-block">状态</span><select class="form-select" name="state"><option value="">全部状态</option>{foreach ['held'=>'占用中','committed'=>'已提交','released'=>'已释放','uncertain'=>'异常保留'] as $value=>$label}<option value="{$value}" {if $resource_page.reservations.filters.state == $value}selected{/if}>{$label}</option>{/foreach}</select></label><label class="col-lg-3 col-6"><span class="form-label d-block">资源池</span><select class="form-select" name="pool_id"><option value="">全部资源池</option>{foreach $resource_page.pools as $pool}<option value="{$pool.id|escape}" {if $resource_page.reservations.filters.pool_id == $pool.id}selected{/if}>{$pool.region_name|escape} · {$pool.name|escape}</option>{/foreach}</select></label><div class="col-lg-2 d-flex gap-2"><button class="btn btn-primary flex-grow-1" type="submit">筛选</button><a class="btn btn-light" href="/admin/resources?view=reservations">清空</a></div></form></div></section>
<section class="card" aria-labelledby="reservation-title"><div class="card-header d-flex justify-content-between align-items-center gap-2"><div><h2 class="h5 card-title mb-1" id="reservation-title">资源预留</h2><span class="text-muted fs-13">显示 {$resource_page.reservations.pagination.from|escape}–{$resource_page.reservations.pagination.to|escape} 条</span></div><span class="badge text-bg-light">共 {$resource_page.reservations.pagination.total|escape} 条</span></div><div class="card-body"><div class="admin-resource-table-wrap"><table class="table table-hover align-middle mb-0 admin-resource-responsive-table"><thead><tr><th>预留</th><th>位置</th><th>资源</th><th>关联</th><th>状态</th><th>时间</th><th>操作</th></tr></thead><tbody>
@ -135,7 +205,31 @@
{/if}
</main>
{if $admin_can_manage|default:false}
{if $admin_can_manage|default:false && $resource_page.view == 'traffic'}
<dialog data-admin-instance-drawer data-admin-traffic-drawer id="traffic-group-editor" aria-labelledby="traffic-group-editor-title">
<header class="admin-instance-drawer-header"><div><p class="text-muted fs-13 mb-1" id="traffic-group-editor-eyebrow">共享流量池</p><h2 class="h4 fw-semibold mb-0" id="traffic-group-editor-title">新建分组</h2></div><button class="admin-modal-close position-static flex-shrink-0" id="traffic-group-editor-close" type="button" aria-label="关闭流量池分组编辑器"><i class="mdi mdi-close"></i></button></header>
<form id="traffic-group-editor-form" class="admin-instance-drawer-body"><input type="hidden" name="group_id"><input type="hidden" name="expected_revision">
<div class="admin-resource-form-fields">
<label data-traffic-code-field><span class="form-label">系统标识</span><input class="form-control admin-mono" name="code" minlength="2" maxlength="64" pattern="[a-z][a-z0-9_-]+" autocomplete="off" spellcheck="false"><span class="form-text">2–64 位小写字母、数字、下划线或短横线,创建后不可修改。</span></label>
<label><span class="form-label">显示名称</span><input class="form-control" name="name" maxlength="80" required autocomplete="off"></label>
</div>
<p class="admin-config-status mt-3" id="traffic-group-editor-notice" role="status" aria-live="polite">等待提交</p>
</form>
<footer class="admin-instance-drawer-footer"><span class="text-muted fs-12">分组不提供硬删除;上线状态通过单向流程控制。</span><button class="btn btn-primary" type="submit" form="traffic-group-editor-form" id="traffic-group-editor-submit">保存</button></footer>
</dialog>
<dialog data-admin-instance-drawer data-admin-traffic-drawer id="traffic-line-editor" aria-labelledby="traffic-line-editor-title">
<header class="admin-instance-drawer-header"><div><p class="text-muted fs-13 mb-1">共享流量池</p><h2 class="h4 fw-semibold mb-0" id="traffic-line-editor-title">配置线路</h2></div><button class="admin-modal-close position-static flex-shrink-0" id="traffic-line-editor-close" type="button" aria-label="关闭线路配置"><i class="mdi mdi-close"></i></button></header>
<form id="traffic-line-editor-form" class="admin-instance-drawer-body"><input type="hidden" name="group_id"><input type="hidden" name="expected_revision">
<p class="alert alert-info">每条线路只能属于一个共享流量池分组。已被其他分组占用的线路不可选择。</p>
<div class="admin-traffic-line-options">{foreach $resource_page.traffic_pools.lines as $line}<label><input class="form-check-input" type="checkbox" name="line_ids[]" value="{$line.id|escape}" data-line-owner="{$line.traffic_pool_group_id|default:0|escape}"><span><strong>{$line.region_name|escape} · {$line.name|escape}</strong><small><code>{$line.code|escape}</code> · {if $line.status == 'active'}启用{else}停用{/if}</small></span></label>{foreachelse}<p class="text-muted mb-0">尚未建立线路,请先在资源拓扑中创建线路。</p>{/foreach}</div>
<p class="admin-config-status mt-3" id="traffic-line-editor-notice" role="status" aria-live="polite">等待提交</p>
</form>
<footer class="admin-instance-drawer-footer"><span class="text-muted fs-12">只有停用且尚未形成持久账本引用的分组可以调整线路。</span><button class="btn btn-primary" type="submit" form="traffic-line-editor-form" id="traffic-line-editor-submit">保存线路</button></footer>
</dialog>
{/if}
{if $admin_can_manage|default:false && $resource_page.view != 'traffic'}
<dialog data-admin-instance-drawer data-admin-resource-drawer id="resource-editor" aria-labelledby="resource-editor-title">
<header class="admin-instance-drawer-header"><div><p class="text-muted fs-13 mb-1" id="resource-editor-eyebrow">资源目录</p><h2 class="h4 fw-semibold mb-0" id="resource-editor-title">编辑资源</h2></div><button class="admin-modal-close position-static flex-shrink-0" id="resource-editor-close" type="button" aria-label="关闭资源编辑器" autofocus><i class="mdi mdi-close"></i></button></header>
<form id="resource-editor-form" class="admin-instance-drawer-body"><input type="hidden" name="id"><input type="hidden" name="kind">
@ -164,4 +258,5 @@
<script id="admin-resources-bootstrap" type="application/json">{$resource_bootstrap_json nofilter}</script>
<script type="module" src="/cloud/admin-resources.js?v={$venix_asset_version}"></script>
{if $resource_page.view == 'traffic'}<script type="module" src="/cloud/admin-traffic-pools.js?v={$venix_asset_version}"></script>{/if}
{include file='admin/static_footer.tpl'}

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

@ -20,7 +20,7 @@ $assert = static function (bool $condition, string $message): void {
$assert(str_contains(
$source,
"private const VIEWS = ['topology', 'capacity', 'reservations']"
"private const VIEWS = ['topology', 'capacity', 'reservations', 'traffic']"
)
&& str_contains($source, "'topology' => self::topology(")
&& str_contains($source, "'effective_state' => \$effective['state']")

@ -107,7 +107,7 @@ $assert($refund !== ''
&& $stockPosition < $releasePosition,
'Create refunds must lock offer stock before host resources to match payment placement lock order.');
foreach (['资源拓扑', '容量与健康', '资源预留'] as $label) {
foreach (['资源拓扑', '容量与健康', '资源预留', '共享流量池'] as $label) {
$assert(str_contains($template, '>' . $label . '<') || str_contains($template, '>' . $label . '</a>'),
'Resource page is missing a persistent tab: ' . $label);
}
@ -122,7 +122,7 @@ $assert(!str_contains($template, 'view=overview')
&& str_contains($template, 'data-parent-region-id="{$region.id|escape}"')
&& str_contains($template, 'data-parent-line-id="{$region.default_line_id|escape}"')
&& str_contains($template, 'data-parent-line-id="{$line.id|escape}"'),
'Resource navigation and hierarchy must use the three-view clean-break topology contract.');
'Resource navigation and hierarchy must use the clean-break topology and traffic-pool contract.');
$assert(str_contains($template, '{if $admin_can_manage|default:false}<button')
&& str_contains($template, 'data-resource-create="region"')

@ -0,0 +1,98 @@
<?php
$root = dirname(__DIR__);
$read = static function (string $path): string {
$source = file_get_contents($path);
if (!is_string($source)) {
throw new RuntimeException('Unable to read ' . $path);
}
return $source;
};
$assert = static function (bool $condition, string $message): void {
if (!$condition) {
throw new RuntimeException($message);
}
};
$resourceService = $read(
$root . '/app/Services/Cloud/CloudAdminResourceService.php'
);
$trafficService = $read(
$root . '/app/Services/Cloud/CloudAdminTrafficPoolService.php'
);
$template = $read(
$root . '/resources/views/venix/admin/cloud/resources.tpl'
);
$script = $read($root . '/public/cloud/admin-traffic-pools.js');
$styles = $read($root . '/public/theme/venix/css/admin-home.css');
$assets = $read($root . '/resources/views/venix/layout_assets.tpl');
$assert(str_contains($resourceService,
"private const VIEWS = ['topology', 'capacity', 'reservations', 'traffic']")
&& str_contains($resourceService,
"'traffic_pools' => CloudAdminTrafficPoolService::page(\$query)")
&& str_contains($template, 'href="/admin/resources?view=traffic"')
&& str_contains($template,
'<script id="admin-resources-bootstrap" type="application/json">')
&& str_contains($template,
'/cloud/admin-traffic-pools.js?v={$venix_asset_version}'),
'Traffic-pool administration must have a database-owned SSR first paint inside resources.');
$assert(str_contains($trafficService, 'private const BLOCKER_LABELS = [')
&& str_contains($trafficService, "'label' => self::BLOCKER_LABELS[\$code]")
&& str_contains($template, '{$blocker.label|escape}')
&& str_contains($template, '{$blocker.code|escape}'),
'Readiness blockers must have human labels while preserving technical codes.');
$assert(str_contains($trafficService, "use App\\Models\\CloudRegion;")
&& str_contains($trafficService, "'region_name' =>")
&& str_contains($template,
'{$line.region_name|escape} · {$line.name|escape}')
&& str_contains($template, '强制执行状态存在'),
'Line choices must disambiguate duplicate regional codes and enforced faults must be described as incidents.');
$assert(str_contains($template, '{if $admin_can_manage|default:false}<button')
&& str_contains($template, 'data-traffic-create')
&& str_contains($template, 'data-traffic-rename=')
&& str_contains($template, 'data-traffic-lines=')
&& str_contains($template, 'data-target-mode="enforced"')
&& !str_contains($template, 'data-traffic-delete'),
'Only authorized administrators may receive traffic-pool mutation controls and no delete control may exist.');
$assert(str_contains($script,
"window.VenixAdminRequestRuntime.create()")
&& str_contains($script,
'`/api/v1/admin/traffic-pool-groups${groupId ?')
&& str_contains($script,
'`/api/v1/admin/traffic-pool-groups/${groupId}/lines`')
&& str_contains($script, "method: groupId ? 'PATCH' : 'POST'")
&& str_contains($script, "method: 'PUT'")
&& str_contains($script, 'expected_revision: Number(item.revision)')
&& !str_contains($script, "method: 'DELETE'")
&& !str_contains($script, 'setInterval('),
'Mutations must use the shared runtime, exact revisions, and no replay or delete path.');
$assert(str_contains($script,
"body: { mode: targetMode, expected_revision: Number(item.revision) }")
&& str_contains($script, "targetMode === 'enforced'")
&& str_contains($script, 'requiredText: item.name')
&& str_contains($script, 'window.VenixAdminDangerDialog.confirm(config)')
&& str_contains($script, '不能回退、停用或调整线路'),
'Enforced rollout must require the shared typed danger confirmation and an exact revision.');
$assert(str_contains($script,
'checkbox.disabled = owner > 0 && owner !== Number(item.id)')
&& str_contains($template, 'data-line-owner=')
&& str_contains($template, '只有停用且尚未形成持久账本引用的分组可以调整线路'),
'Line assignment must visibly reject lines owned by a different group.');
$assert(str_contains($styles,
'grid-template-columns: repeat(4, minmax(0, 1fr));')
&& str_contains($styles, '.admin-traffic-group-list')
&& str_contains($styles, '.admin-traffic-metrics')
&& str_contains($styles, '[data-admin-traffic-drawer]')
&& str_contains($styles, '@media (max-width: 767.98px)')
&& preg_match("/venix_asset_version value='20261101[0-9]+'/", $assets) === 1,
'Traffic-pool administration must remain responsive and use a new shared asset version.');
echo "Administrator shared traffic-pool UI contracts passed.\n";
Loading…
Cancel
Save