← 返回首页

PC Web 架构

PC Web 使用 Nuxt 4、Nuxt UI、TanStack Query 和 Pinia。首页是个人状态驾驶舱，模块首页按照人物、时间、关系、行动、健康、决策、AI和遗产等原型展示业务；概览、记录和流程共享同一 API 和路由。

LAN 同源代理

默认 Web 只监听回环地址。显式 LAN 前端模式使用 0.0.0.0 监听，但浏览器 API 基址改为同源 /api/v1，由 Nitro 转发到回环 API；该模式不直接公开 API、Docs、数据库或本地 AI Provider。

路由与记录编号

记录详情、更新、归档、恢复、修订和功能路径在发起 HTTP 前统一校验规范大写 ULID；数组、对象、路径片段、小写或非法 Crockford 字符全部失败关闭。

错误与恢复状态

请求层把服务端错误解析为带 ApiErrorCode、HTTP status、requestId 和安全 details 的 WebApiRequestError。页面显式区分 AUTH_REQUIRED、FORBIDDEN、HTTP_404、REVISION_CONFLICT/HTTP_409、FEATURE_NOT_IMPLEMENTED、SYSTEM_MAINTENANCE/HTTP_503 和 NETWORK_ERROR；维护错误只表示写入口暂时冻结，不得显示成功提示或自动重试为新业务操作。未知本地异常统一使用 INTERNAL_ERROR，不得构造任意字符串错误码。

离线字体与图标

Web 使用系统字体栈并通过 ui.fonts=false 关闭 Nuxt UI 默认带入的 @nuxt/fonts，构建阶段不得初始化 Google、Google Icons 或其他远程字体 Provider。Nuxt UI 组件、颜色模式和 Icon 模块继续保留，Lucide 图标来自仓库已安装的 @iconify-json/lucide 本地集合。check-web-build-network-policy.mjs 检查源码配置和实际 build 日志；该门禁不代表页面交互或领域功能完成验收。