Files
OpenFlare/atsf_server/web/features/nodes/components/node-editor-modal.tsx
T
ryan f33e9514dc feat: add geo_manual_override to NodeItem and NodeMutationPayload
fix: update default GeoIPProvider to ipinfo in settings

feat: implement WorldStageMap component for visualizing node health on a world map

feat: create NodeEditorModal for editing node details with manual geo location options

docs: update app-config documentation to reflect changes in GeoIPProvider default value
2026-03-14 15:50:02 +08:00

439 lines
12 KiB
TypeScript

'use client';
import { zodResolver } from '@hookform/resolvers/zod';
import { useMemo, useEffect } from 'react';
import { useForm, useWatch } from 'react-hook-form';
import { z } from 'zod';
import { AppModal } from '@/components/ui/app-modal';
import worldGeoJson from '@/features/dashboard/data/world-geo.json';
import type { NodeItem, NodeMutationPayload } from '@/features/nodes/types';
import {
PrimaryButton,
ResourceField,
ResourceInput,
ResourceSelect,
SecondaryButton,
ToggleField,
} from '@/features/shared/components/resource-primitives';
type GeoJsonGeometry = {
type: string;
coordinates: unknown;
};
type GeoJsonFeature = {
geometry?: GeoJsonGeometry;
properties?: {
name?: string;
};
};
type RegionOption = {
label: string;
latitude: number;
longitude: number;
};
const nodeEditorSchema = z
.object({
name: z
.string()
.trim()
.min(1, '请输入节点名')
.max(128, '节点名不能超过 128 个字符'),
ip: z.string().trim().max(64, '节点 IP 不能超过 64 个字符'),
auto_update_enabled: z.boolean(),
geo_manual_override: z.boolean(),
geo_region: z.string(),
geo_name: z.string().trim().max(128, '位置名不能超过 128 个字符'),
geo_latitude: z.string().trim(),
geo_longitude: z.string().trim(),
})
.superRefine((values, ctx) => {
if (!values.geo_manual_override) {
return;
}
const hasLatitude = values.geo_latitude !== '';
const hasLongitude = values.geo_longitude !== '';
if (hasLatitude !== hasLongitude) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
path: ['geo_latitude'],
message: '纬度和经度需要同时填写',
});
ctx.addIssue({
code: z.ZodIssueCode.custom,
path: ['geo_longitude'],
message: '纬度和经度需要同时填写',
});
return;
}
if (hasLatitude) {
const latitude = Number(values.geo_latitude);
if (Number.isNaN(latitude) || latitude < -90 || latitude > 90) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
path: ['geo_latitude'],
message: '纬度必须在 -90 到 90 之间',
});
}
}
if (hasLongitude) {
const longitude = Number(values.geo_longitude);
if (Number.isNaN(longitude) || longitude < -180 || longitude > 180) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
path: ['geo_longitude'],
message: '经度必须在 -180 到 180 之间',
});
}
}
});
type NodeEditorValues = z.infer<typeof nodeEditorSchema>;
const defaultValues: NodeEditorValues = {
name: '',
ip: '',
auto_update_enabled: false,
geo_manual_override: false,
geo_region: '',
geo_name: '',
geo_latitude: '',
geo_longitude: '',
};
function collectPoints(value: unknown, points: Array<[number, number]>) {
if (!Array.isArray(value)) {
return;
}
if (
value.length >= 2 &&
typeof value[0] === 'number' &&
typeof value[1] === 'number'
) {
points.push([value[0], value[1]]);
return;
}
for (const item of value) {
collectPoints(item, points);
}
}
function getRegionCenter(feature: GeoJsonFeature) {
const points: Array<[number, number]> = [];
collectPoints(feature.geometry?.coordinates, points);
if (points.length === 0) {
return null;
}
let minLongitude = Number.POSITIVE_INFINITY;
let maxLongitude = Number.NEGATIVE_INFINITY;
let minLatitude = Number.POSITIVE_INFINITY;
let maxLatitude = Number.NEGATIVE_INFINITY;
for (const [longitude, latitude] of points) {
minLongitude = Math.min(minLongitude, longitude);
maxLongitude = Math.max(maxLongitude, longitude);
minLatitude = Math.min(minLatitude, latitude);
maxLatitude = Math.max(maxLatitude, latitude);
}
return {
longitude: Number(((minLongitude + maxLongitude) / 2).toFixed(4)),
latitude: Number(((minLatitude + maxLatitude) / 2).toFixed(4)),
};
}
function buildRegionOptions() {
const features = ((worldGeoJson as { features?: GeoJsonFeature[] }).features ??
[]) as GeoJsonFeature[];
const options = new Map<string, RegionOption>();
for (const feature of features) {
const label = feature.properties?.name?.trim();
if (!label || options.has(label)) {
continue;
}
const center = getRegionCenter(feature);
if (!center) {
continue;
}
options.set(label, {
label,
latitude: center.latitude,
longitude: center.longitude,
});
}
return Array.from(options.values()).sort((a, b) =>
a.label.localeCompare(b.label),
);
}
function buildFormValues(node?: Partial<NodeItem> | null): NodeEditorValues {
if (!node) {
return defaultValues;
}
return {
name: node.name ?? '',
ip: node.ip ?? '',
auto_update_enabled: node.auto_update_enabled ?? false,
geo_manual_override: node.geo_manual_override ?? false,
geo_region: node.geo_manual_override ? node.geo_name ?? '' : '',
geo_name: node.geo_name ?? '',
geo_latitude:
node.geo_latitude === undefined || node.geo_latitude === null
? ''
: String(node.geo_latitude),
geo_longitude:
node.geo_longitude === undefined || node.geo_longitude === null
? ''
: String(node.geo_longitude),
};
}
function toPayload(values: NodeEditorValues): NodeMutationPayload {
if (!values.geo_manual_override) {
return {
name: values.name.trim(),
ip: values.ip.trim(),
auto_update_enabled: values.auto_update_enabled,
geo_manual_override: false,
geo_name: '',
geo_latitude: null,
geo_longitude: null,
};
}
return {
name: values.name.trim(),
ip: values.ip.trim(),
auto_update_enabled: values.auto_update_enabled,
geo_manual_override: true,
geo_name: values.geo_name.trim(),
geo_latitude:
values.geo_latitude.trim() === '' ? null : Number(values.geo_latitude),
geo_longitude:
values.geo_longitude.trim() === '' ? null : Number(values.geo_longitude),
};
}
export function NodeEditorModal({
isOpen,
node,
isSubmitting,
title,
description,
submitLabel,
onClose,
onSubmit,
}: {
isOpen: boolean;
node?: Partial<NodeItem> | null;
isSubmitting: boolean;
title: string;
description: string;
submitLabel: string;
onClose: () => void;
onSubmit: (payload: NodeMutationPayload) => void;
}) {
const form = useForm<NodeEditorValues>({
resolver: zodResolver(nodeEditorSchema),
defaultValues,
});
const watchedAutoUpdate = useWatch({
control: form.control,
name: 'auto_update_enabled',
});
const watchedGeoManualOverride = useWatch({
control: form.control,
name: 'geo_manual_override',
});
const regionOptions = useMemo(() => buildRegionOptions(), []);
useEffect(() => {
if (!isOpen) {
return;
}
form.reset(buildFormValues(node));
}, [form, isOpen, node]);
const handleSubmit = form.handleSubmit((values) => {
onSubmit(toPayload(values));
});
return (
<AppModal
isOpen={isOpen}
onClose={onClose}
title={title}
description={description}
footer={
<div className="flex flex-wrap justify-end gap-3">
<SecondaryButton
type="button"
onClick={onClose}
disabled={isSubmitting}
>
取消
</SecondaryButton>
<PrimaryButton
type="submit"
form="node-editor-form"
disabled={isSubmitting}
>
{isSubmitting ? '保存中...' : submitLabel}
</PrimaryButton>
</div>
}
>
<form id="node-editor-form" className="space-y-5" onSubmit={handleSubmit}>
<ResourceField
label="节点名"
hint="示例:shanghai-edge-1"
error={form.formState.errors.name?.message}
>
<ResourceInput
placeholder="shanghai-edge-1"
{...form.register('name')}
/>
</ResourceField>
<ResourceField
label="节点 IP"
hint="可手动维护节点当前对外 IP;留空则等待 Agent 注册或心跳自动回填。"
error={form.formState.errors.ip?.message}
>
<ResourceInput placeholder="203.0.113.10" {...form.register('ip')} />
</ResourceField>
<ToggleField
label="启用自动更新"
description="开启后 Agent 心跳返回会提示节点自动执行自更新。"
checked={watchedAutoUpdate}
onChange={(checked) =>
form.setValue('auto_update_enabled', checked, {
shouldDirty: true,
shouldValidate: true,
})
}
/>
<ToggleField
label="手动指定地图地区"
description="关闭时,节点会根据当前 IP 自动解析归属地;开启后使用你手动选择的地区与坐标。"
checked={watchedGeoManualOverride}
onChange={(checked) => {
form.setValue('geo_manual_override', checked, {
shouldDirty: true,
shouldValidate: true,
});
if (!checked) {
form.setValue('geo_region', '', { shouldDirty: true });
form.setValue('geo_name', '', { shouldDirty: true });
form.setValue('geo_latitude', '', { shouldDirty: true });
form.setValue('geo_longitude', '', { shouldDirty: true });
}
}}
/>
{watchedGeoManualOverride ? (
<ResourceField
label="地区选择"
hint="选择后会自动填充位置名与地图坐标,你也可以继续微调。"
>
<ResourceSelect
value={form.watch('geo_region')}
onChange={(event) => {
const regionName = event.target.value;
form.setValue('geo_region', regionName, {
shouldDirty: true,
});
const selectedRegion = regionOptions.find(
(item) => item.label === regionName,
);
if (!selectedRegion) {
return;
}
form.setValue('geo_name', selectedRegion.label, {
shouldDirty: true,
shouldValidate: true,
});
form.setValue('geo_latitude', String(selectedRegion.latitude), {
shouldDirty: true,
shouldValidate: true,
});
form.setValue(
'geo_longitude',
String(selectedRegion.longitude),
{
shouldDirty: true,
shouldValidate: true,
},
);
}}
>
<option value="">请选择地区</option>
{regionOptions.map((option) => (
<option key={option.label} value={option.label}>
{option.label}
</option>
))}
</ResourceSelect>
</ResourceField>
) : null}
<ResourceField
label="地图位置名"
hint={
watchedGeoManualOverride
? '可在自动填充后继续修改,例如使用更贴近业务的展示名称。'
: '自动解析模式下,该字段会由系统根据节点 IP 回填。'
}
error={form.formState.errors.geo_name?.message}
>
<ResourceInput
placeholder="Shanghai"
disabled={!watchedGeoManualOverride}
{...form.register('geo_name')}
/>
</ResourceField>
<div className="grid gap-5 md:grid-cols-2">
<ResourceField
label="纬度"
hint="范围 -90 到 90,例如上海约为 31.2304"
error={form.formState.errors.geo_latitude?.message}
>
<ResourceInput
placeholder="31.2304"
disabled={!watchedGeoManualOverride}
{...form.register('geo_latitude')}
/>
</ResourceField>
<ResourceField
label="经度"
hint="范围 -180 到 180,例如上海约为 121.4737"
error={form.formState.errors.geo_longitude?.message}
>
<ResourceInput
placeholder="121.4737"
disabled={!watchedGeoManualOverride}
{...form.register('geo_longitude')}
/>
</ResourceField>
</div>
</form>
</AppModal>
);
}