feat(web): charge point details page

This commit is contained in:
2026-03-10 16:12:38 +08:00
parent 08cd00c802
commit f803a447b5
5 changed files with 654 additions and 10 deletions

View File

@@ -1,5 +1,5 @@
import { Hono } from "hono";
import { desc, eq, isNull, isNotNull, sql } from "drizzle-orm";
import { and, desc, eq, isNull, isNotNull, sql } from "drizzle-orm";
import { useDrizzle } from "@/lib/db.js";
import { transaction, chargePoint, connector, idTag } from "@/db/schema.js";
import { ocppConnections } from "@/ocpp/handler.js";
@@ -12,17 +12,24 @@ app.get("/", async (c) => {
const page = Math.max(1, Number(c.req.query("page") ?? 1));
const limit = Math.min(100, Math.max(1, Number(c.req.query("limit") ?? 20)));
const status = c.req.query("status"); // 'active' | 'completed'
const chargePointId = c.req.query("chargePointId");
const offset = (page - 1) * limit;
const db = useDrizzle();
const whereClause =
const statusCondition =
status === "active"
? isNull(transaction.stopTimestamp)
: status === "completed"
? isNotNull(transaction.stopTimestamp)
: undefined;
const whereClause = chargePointId
? statusCondition
? and(statusCondition, eq(transaction.chargePointId, chargePointId))
: eq(transaction.chargePointId, chargePointId)
: statusCondition;
const [{ total }] = await db
.select({ total: sql<number>`count(*)::int` })
.from(transaction)

View File

@@ -0,0 +1,596 @@
"use client";
import { use, useCallback, useEffect, useState } from "react";
import Link from "next/link";
import {
Button,
Chip,
Input,
Label,
ListBox,
Modal,
Pagination,
Select,
Spinner,
Table,
TextField,
} from "@heroui/react";
import { ArrowLeft, Pencil, PlugConnection } from "@gravity-ui/icons";
import { api, type ChargePointDetail, type PaginatedTransactions } from "@/lib/api";
// ── Status maps ────────────────────────────────────────────────────────────
const statusLabelMap: Record<string, string> = {
Available: "空闲",
Charging: "充电中",
Preparing: "准备中",
Finishing: "结束中",
SuspendedEV: "EV 暂停",
SuspendedEVSE: "EVSE 暂停",
Reserved: "已预约",
Faulted: "故障",
Unavailable: "不可用",
Occupied: "占用",
};
const statusDotClass: Record<string, string> = {
Available: "bg-success",
Charging: "bg-[var(--accent)] animate-pulse",
Preparing: "bg-warning animate-pulse",
Finishing: "bg-warning",
SuspendedEV: "bg-warning",
SuspendedEVSE: "bg-warning",
Reserved: "bg-warning",
Faulted: "bg-danger",
Unavailable: "bg-danger",
Occupied: "bg-warning",
};
const registrationColorMap: Record<string, "success" | "warning" | "danger"> = {
Accepted: "success",
Pending: "warning",
Rejected: "danger",
};
const TX_LIMIT = 10;
// ── Helpers ────────────────────────────────────────────────────────────────
function formatDuration(start: string, stop: string | null): string {
if (!stop) return "进行中";
const ms = new Date(stop).getTime() - new Date(start).getTime();
const min = Math.floor(ms / 60000);
if (min < 60) return `${min} 分钟`;
const h = Math.floor(min / 60);
const m = min % 60;
return `${h}h ${m}m`;
}
function relativeTime(iso: string): string {
const diff = Date.now() - new Date(iso).getTime();
const s = Math.floor(diff / 1000);
if (s < 60) return `${s} 秒前`;
const m = Math.floor(s / 60);
if (m < 60) return `${m} 分钟前`;
const h = Math.floor(m / 60);
if (h < 24) return `${h} 小时前`;
const d = Math.floor(h / 24);
return `${d} 天前`;
}
// ── Edit form type ─────────────────────────────────────────────────────────
type EditForm = {
chargePointVendor: string;
chargePointModel: string;
registrationStatus: "Accepted" | "Pending" | "Rejected";
feePerKwh: string;
};
// ── Component ──────────────────────────────────────────────────────────────
export default function ChargePointDetailPage({ params }: { params: Promise<{ id: string }> }) {
const { id } = use(params);
const [cp, setCp] = useState<ChargePointDetail | null>(null);
const [notFound, setNotFound] = useState(false);
const [loading, setLoading] = useState(true);
// transactions
const [txData, setTxData] = useState<PaginatedTransactions | null>(null);
const [txPage, setTxPage] = useState(1);
const [txLoading, setTxLoading] = useState(true);
// edit modal
const [editOpen, setEditOpen] = useState(false);
const [editBusy, setEditBusy] = useState(false);
const [editForm, setEditForm] = useState<EditForm>({
chargePointVendor: "",
chargePointModel: "",
registrationStatus: "Pending",
feePerKwh: "0",
});
const loadCp = useCallback(async () => {
setLoading(true);
try {
const data = await api.chargePoints.get(id);
setCp(data);
} catch {
setNotFound(true);
} finally {
setLoading(false);
}
}, [id]);
const loadTx = useCallback(
async (p: number) => {
setTxLoading(true);
try {
const data = await api.transactions.list({
page: p,
limit: TX_LIMIT,
chargePointId: id,
});
setTxData(data);
} finally {
setTxLoading(false);
}
},
[id],
);
useEffect(() => {
loadCp();
}, [loadCp]);
useEffect(() => {
loadTx(txPage);
}, [txPage, loadTx]);
const openEdit = () => {
if (!cp) return;
setEditForm({
chargePointVendor: cp.chargePointVendor ?? "",
chargePointModel: cp.chargePointModel ?? "",
registrationStatus: cp.registrationStatus as EditForm["registrationStatus"],
feePerKwh: String(cp.feePerKwh),
});
setEditOpen(true);
};
const handleEditSubmit = async () => {
if (!cp) return;
setEditBusy(true);
try {
const fee = Math.max(0, Math.round(Number(editForm.feePerKwh) || 0));
const updated = await api.chargePoints.update(cp.id, {
chargePointVendor: editForm.chargePointVendor,
chargePointModel: editForm.chargePointModel,
registrationStatus: editForm.registrationStatus,
feePerKwh: fee,
});
setCp((prev) => (prev ? { ...prev, ...updated, connectors: prev.connectors } : prev));
setEditOpen(false);
} finally {
setEditBusy(false);
}
};
// Online if last heartbeat within 3× interval
const isOnline =
cp?.lastHeartbeatAt != null &&
Date.now() - new Date(cp.lastHeartbeatAt).getTime() < (cp.heartbeatInterval ?? 60) * 3 * 1000;
// ── Render: loading / not found ──────────────────────────────────────────
if (loading) {
return (
<div className="flex h-48 items-center justify-center">
<Spinner />
</div>
);
}
if (notFound || !cp) {
return (
<div className="space-y-4">
<Link
href="/dashboard/charge-points"
className="inline-flex items-center gap-1.5 text-sm text-muted hover:text-foreground"
>
<ArrowLeft className="size-4" />
</Link>
<p className="text-sm text-danger"></p>
</div>
);
}
const sortedConnectors = [...cp.connectors].sort((a, b) => a.connectorId - b.connectorId);
// ── Render ───────────────────────────────────────────────────────────────
return (
<div className="space-y-6">
{/* Breadcrumb back */}
<Link
href="/dashboard/charge-points"
className="inline-flex items-center gap-1.5 text-sm text-muted hover:text-foreground"
>
<ArrowLeft className="size-4" />
</Link>
{/* Header */}
<div className="flex flex-wrap items-start justify-between gap-4">
<div className="space-y-1.5">
<div className="flex flex-wrap items-center gap-2">
<h1 className="font-mono text-2xl font-semibold text-foreground">
{cp.chargePointIdentifier}
</h1>
<Chip
color={registrationColorMap[cp.registrationStatus] ?? "warning"}
size="sm"
variant="soft"
>
{cp.registrationStatus}
</Chip>
<div className="flex items-center gap-1.5">
<span
className={`size-2 rounded-full ${isOnline ? "bg-success animate-pulse" : "bg-muted"}`}
/>
<span className="text-xs text-muted">{isOnline ? "在线" : "离线"}</span>
</div>
</div>
{(cp.chargePointVendor || cp.chargePointModel) && (
<p className="text-sm text-muted">
{[cp.chargePointVendor, cp.chargePointModel].filter(Boolean).join(" · ")}
</p>
)}
</div>
<Button size="sm" variant="secondary" onPress={openEdit}>
<Pencil className="size-4" />
</Button>
</div>
{/* Info grid */}
<div className="grid gap-4 md:grid-cols-2">
{/* Device info */}
<div className="rounded-xl border border-border bg-surface p-4">
<h2 className="mb-3 text-sm font-semibold text-foreground"></h2>
<dl className="divide-y divide-border">
{[
{ label: "品牌", value: cp.chargePointVendor },
{ label: "型号", value: cp.chargePointModel },
{ label: "序列号", value: cp.chargePointSerialNumber },
{ label: "固件版本", value: cp.firmwareVersion },
{ label: "电表型号", value: cp.meterType },
{ label: "电表序列号", value: cp.meterSerialNumber },
{ label: "ICCID", value: cp.iccid },
{ label: "IMSI", value: cp.imsi },
].map(({ label, value }) => (
<div key={label} className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted">{label}</dt>
<dd className="truncate text-sm text-foreground">
{value ?? <span className="text-muted"></span>}
</dd>
</div>
))}
</dl>
</div>
{/* Operation info */}
<div className="rounded-xl border border-border bg-surface p-4">
<h2 className="mb-3 text-sm font-semibold text-foreground"></h2>
<dl className="divide-y divide-border">
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd>
<Chip
color={registrationColorMap[cp.registrationStatus] ?? "warning"}
size="sm"
variant="soft"
>
{cp.registrationStatus}
</Chip>
</dd>
</div>
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd className="text-sm text-foreground">
{cp.feePerKwh > 0 ? (
<span>
{cp.feePerKwh} /kWh
<span className="ml-1 text-xs text-muted">
(¥{(cp.feePerKwh / 100).toFixed(2)}/kWh)
</span>
</span>
) : (
"免费"
)}
</dd>
</div>
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd className="text-sm text-foreground">
{cp.heartbeatInterval != null ? (
`${cp.heartbeatInterval}`
) : (
<span className="text-muted"></span>
)}
</dd>
</div>
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd className="text-right text-sm text-foreground">
{cp.lastHeartbeatAt ? (
<span title={new Date(cp.lastHeartbeatAt).toLocaleString("zh-CN")}>
{relativeTime(cp.lastHeartbeatAt)}
</span>
) : (
<span className="text-muted"></span>
)}
</dd>
</div>
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd className="text-right text-sm text-foreground">
{cp.lastBootNotificationAt ? (
<span title={new Date(cp.lastBootNotificationAt).toLocaleString("zh-CN")}>
{relativeTime(cp.lastBootNotificationAt)}
</span>
) : (
<span className="text-muted"></span>
)}
</dd>
</div>
<div className="flex items-center justify-between gap-4 py-2">
<dt className="shrink-0 text-sm text-muted"></dt>
<dd className="text-sm text-foreground">
{new Date(cp.createdAt).toLocaleDateString("zh-CN")}
</dd>
</div>
</dl>
</div>
</div>
{/* Connectors */}
{sortedConnectors.length > 0 && (
<div className="space-y-3">
<h2 className="text-sm font-semibold text-foreground"></h2>
<div className="flex flex-wrap gap-3">
{sortedConnectors.map((conn) => (
<div
key={conn.id}
className="flex min-w-40 flex-col gap-2 rounded-xl border border-border bg-surface p-3"
>
<div className="flex items-center gap-2">
<PlugConnection className="size-4 shrink-0 text-muted" />
<span className="text-sm font-medium text-foreground">
#{conn.connectorId}
</span>
<span className="ml-auto flex items-center gap-1">
<span
className={`size-2 shrink-0 rounded-full ${statusDotClass[conn.status] ?? "bg-warning"}`}
/>
<span className="text-xs text-muted">
{statusLabelMap[conn.status] ?? conn.status}
</span>
</span>
</div>
{conn.errorCode && conn.errorCode !== "NoError" && (
<p className="text-xs text-danger">: {conn.errorCode}</p>
)}
{conn.info && <p className="text-xs text-muted">{conn.info}</p>}
<p className="text-xs text-muted">
{" "}
{new Date(conn.lastStatusAt).toLocaleString("zh-CN", {
month: "2-digit",
day: "2-digit",
hour: "2-digit",
minute: "2-digit",
})}
</p>
</div>
))}
</div>
</div>
)}
{/* Transactions */}
<div className="space-y-3">
<div className="flex items-center justify-between">
<h2 className="text-sm font-semibold text-foreground"></h2>
{txData && <span className="text-xs text-muted"> {txData.total} </span>}
</div>
<Table>
<Table.ScrollContainer>
<Table.Content aria-label="充电记录">
<Table.Header>
<Table.Column isRowHeader>ID</Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
<Table.Column></Table.Column>
</Table.Header>
<Table.Body
renderEmptyState={() => (
<div className="py-8 text-center text-sm text-muted">
{txLoading ? "加载中…" : "暂无充电记录"}
</div>
)}
>
{(txData?.data ?? []).map((tx) => (
<Table.Row key={tx.id} id={tx.id}>
<Table.Cell className="font-mono text-sm text-muted">#{tx.id}</Table.Cell>
<Table.Cell>
{tx.connectorNumber != null ? (
`#${tx.connectorNumber}`
) : (
<span className="text-muted"></span>
)}
</Table.Cell>
<Table.Cell className="font-mono">{tx.idTag}</Table.Cell>
<Table.Cell className="tabular-nums text-sm">
{new Date(tx.startTimestamp).toLocaleString("zh-CN", {
month: "2-digit",
day: "2-digit",
hour: "2-digit",
minute: "2-digit",
})}
</Table.Cell>
<Table.Cell>{formatDuration(tx.startTimestamp, tx.stopTimestamp)}</Table.Cell>
<Table.Cell className="tabular-nums">
{tx.energyWh != null ? (
`${(tx.energyWh / 1000).toFixed(2)} kWh`
) : (
<span className="text-muted"></span>
)}
</Table.Cell>
<Table.Cell className="tabular-nums">
{tx.chargeAmount != null ? (
`¥${(tx.chargeAmount / 100).toFixed(2)}`
) : (
<span className="text-muted"></span>
)}
</Table.Cell>
<Table.Cell>
{tx.stopReason ?? <span className="text-muted"></span>}
</Table.Cell>
</Table.Row>
))}
</Table.Body>
</Table.Content>
</Table.ScrollContainer>
</Table>
{txData && txData.totalPages > 1 && (
<div className="flex justify-center">
<Pagination size="sm">
<Pagination.Content>
<Pagination.Item>
<Pagination.Previous
isDisabled={txPage === 1}
onPress={() => setTxPage((p) => Math.max(1, p - 1))}
>
<Pagination.PreviousIcon />
</Pagination.Previous>
</Pagination.Item>
{Array.from({ length: txData.totalPages }, (_, i) => i + 1).map((p) => (
<Pagination.Item key={p}>
<Pagination.Link isActive={p === txPage} onPress={() => setTxPage(p)}>
{p}
</Pagination.Link>
</Pagination.Item>
))}
<Pagination.Item>
<Pagination.Next
isDisabled={txPage === txData.totalPages}
onPress={() => setTxPage((p) => Math.min(txData.totalPages, p + 1))}
>
<Pagination.NextIcon />
</Pagination.Next>
</Pagination.Item>
</Pagination.Content>
</Pagination>
</div>
)}
</div>
{/* Edit modal */}
<Modal
isOpen={editOpen}
onOpenChange={(open) => {
if (!editBusy) setEditOpen(open);
}}
>
<Modal.Backdrop>
<Modal.Container scroll="outside">
<Modal.Dialog className="sm:max-w-md">
<Modal.CloseTrigger />
<Modal.Header>
<Modal.Heading></Modal.Heading>
</Modal.Header>
<Modal.Body className="space-y-3">
<div className="grid grid-cols-2 gap-3">
<TextField fullWidth>
<Label className="text-sm font-medium"></Label>
<Input
placeholder="Unknown"
value={editForm.chargePointVendor}
onChange={(e) =>
setEditForm((f) => ({ ...f, chargePointVendor: e.target.value }))
}
/>
</TextField>
<TextField fullWidth>
<Label className="text-sm font-medium"></Label>
<Input
placeholder="Unknown"
value={editForm.chargePointModel}
onChange={(e) =>
setEditForm((f) => ({ ...f, chargePointModel: e.target.value }))
}
/>
</TextField>
</div>
<div className="space-y-1.5">
<Label className="text-sm font-medium"></Label>
<Select
fullWidth
selectedKey={editForm.registrationStatus}
onSelectionChange={(key) =>
setEditForm((f) => ({
...f,
registrationStatus: String(key) as EditForm["registrationStatus"],
}))
}
>
<Select.Trigger>
<Select.Value />
<Select.Indicator />
</Select.Trigger>
<Select.Popover>
<ListBox>
<ListBox.Item id="Accepted">Accepted</ListBox.Item>
<ListBox.Item id="Pending">Pending</ListBox.Item>
<ListBox.Item id="Rejected">Rejected</ListBox.Item>
</ListBox>
</Select.Popover>
</Select>
</div>
<TextField fullWidth>
<Label className="text-sm font-medium">/kWh</Label>
<Input
type="number"
min="0"
step="1"
placeholder="0"
value={editForm.feePerKwh}
onChange={(e) => setEditForm((f) => ({ ...f, feePerKwh: e.target.value }))}
/>
</TextField>
</Modal.Body>
<Modal.Footer className="flex justify-end gap-2">
<Button variant="ghost" onPress={() => setEditOpen(false)}>
</Button>
<Button isDisabled={editBusy} onPress={handleEditSubmit}>
{editBusy ? <Spinner size="sm" /> : "保存"}
</Button>
</Modal.Footer>
</Modal.Dialog>
</Modal.Container>
</Modal.Backdrop>
</Modal>
</div>
);
}

View File

@@ -3,6 +3,7 @@
import { useCallback, useEffect, useRef, useState } from "react";
import { Button, Chip, Input, Label, ListBox, Modal, Select, Spinner, Table, TextField } from "@heroui/react";
import { Plus, Pencil, PlugConnection, TrashBin } from "@gravity-ui/icons";
import Link from "next/link";
import { api, type ChargePoint } from "@/lib/api";
@@ -273,8 +274,13 @@ export default function ChargePointsPage() {
)}
{chargePoints.map((cp) => (
<Table.Row key={cp.id} id={String(cp.id)}>
<Table.Cell className="font-mono font-medium">
{cp.chargePointIdentifier}
<Table.Cell>
<Link
href={`/dashboard/charge-points/${cp.id}`}
className="font-mono font-medium text-accent hover:underline"
>
{cp.chargePointIdentifier}
</Link>
</Table.Cell>
<Table.Cell>
{cp.chargePointVendor && cp.chargePointModel ? (
@@ -331,7 +337,7 @@ export default function ChargePointsPage() {
statusDotClass[conn.status] ?? "bg-warning"
}`}
/>
<span className="text-xs text-foreground">
<span className="text-xs text-foreground text-nowrap">
{statusLabelMap[conn.status] ?? conn.status}
</span>
</div>

View File

@@ -42,7 +42,7 @@ export default function SidebarFooter() {
<span>退</span>
</button>
<p className="mt-2 px-2 text-[11px] text-muted/60">OCPP 1.6-J v0.1.0</p>
<p className="mt-2 px-2 text-[11px] text-muted/60">Helios EVCS</p>
</div>
)
}

View File

@@ -27,14 +27,27 @@ export type Stats = {
};
export type ConnectorSummary = {
id: number;
id: string;
connectorId: number;
status: string;
lastStatusAt: string | null;
};
export type ConnectorDetail = {
id: string;
connectorId: number;
status: string;
errorCode: string;
info: string | null;
vendorId: string | null;
vendorErrorCode: string | null;
lastStatusAt: string;
createdAt: string;
updatedAt: string;
};
export type ChargePoint = {
id: number;
id: string;
chargePointIdentifier: string;
chargePointVendor: string | null;
chargePointModel: string | null;
@@ -45,6 +58,27 @@ export type ChargePoint = {
connectors: ConnectorSummary[];
};
export type ChargePointDetail = {
id: string;
chargePointIdentifier: string;
chargePointVendor: string | null;
chargePointModel: string | null;
chargePointSerialNumber: string | null;
firmwareVersion: string | null;
iccid: string | null;
imsi: string | null;
meterSerialNumber: string | null;
meterType: string | null;
registrationStatus: string;
heartbeatInterval: number | null;
lastHeartbeatAt: string | null;
lastBootNotificationAt: string | null;
feePerKwh: number;
createdAt: string;
updatedAt: string;
connectors: ConnectorDetail[];
};
export type Transaction = {
id: number;
chargePointIdentifier: string | null;
@@ -98,7 +132,7 @@ export const api = {
},
chargePoints: {
list: () => apiFetch<ChargePoint[]>("/api/charge-points"),
get: (id: number) => apiFetch<ChargePoint>(`/api/charge-points/${id}`),
get: (id: string) => apiFetch<ChargePointDetail>(`/api/charge-points/${id}`),
create: (data: {
chargePointIdentifier: string;
chargePointVendor?: string;
@@ -124,11 +158,12 @@ export const api = {
apiFetch<{ success: true }>(`/api/charge-points/${id}`, { method: "DELETE" }),
},
transactions: {
list: (params?: { page?: number; limit?: number; status?: "active" | "completed" }) => {
list: (params?: { page?: number; limit?: number; status?: "active" | "completed"; chargePointId?: string }) => {
const q = new URLSearchParams();
if (params?.page) q.set("page", String(params.page));
if (params?.limit) q.set("limit", String(params.limit));
if (params?.status) q.set("status", params.status);
if (params?.chargePointId) q.set("chargePointId", params.chargePointId);
const qs = q.toString();
return apiFetch<PaginatedTransactions>(`/api/transactions${qs ? "?" + qs : ""}`);
},