refactor(server): use native Vite tsconfig paths

.dockerignore

@@ -1,13 +0,0 @@
-node_modules/
-.output/
-.tanstack/
-out/
-.git/
-.env
-.env.*
-
-*.md
-*.tsbuildinfo
-*.bun-build
-
-.vscode/

.env.example

@@ -1,15 +0,0 @@
-DATABASE_URL=mysql://user:password@localhost:3306/database
-
-# 默认关闭公开 OpenAPI 文档/规格；仅在受控本地或内网演示环境显式启用。
-# ENABLE_API_DOCS=false
-
-# 必填：外部 SoH 预测服务地址
-SOH_PREDICTION_API_BASE_URL=http://127.0.0.1:8000
-# SOH_PREDICTION_CACHE_TTL_SECONDS=86400
-# SOH_PREDICTION_NEGATIVE_CACHE_TTL_SECONDS=300
-# SOH_PREDICTION_TIMEOUT_MS=10000
-
-# 可选：日志级别与输出格式
-# LOG_LEVEL=info       # trace|debug|info|warning|error|fatal
-# LOG_FORMAT=pretty    # pretty|json — defaults to TTY ? pretty : json
-# LOG_DB=false         # reserved for database query logging if enabled later

.gitignore

@@ -1,24 +1,157 @@
-# Dependencies
+### Custom ###
-node_modules/
 
-# Build output
+# TanStack
-.output/
 .tanstack/
-.vite/
-out/
-volumes/
-*.bun-build
-*.tsbuildinfo
-vite.config.js.timestamp-*
-vite.config.ts.timestamp-*
 
-# Env
+# Nitro
+.output/
+
+# Bun build
+*.bun-build
+
+# Turborepo
+.turbo/
+
+### Node ###
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
 .env
 .env.*
 !.env.example
 
-# Logs
+# parcel-bundler cache (https://parceljs.org/)
-*.log
+.cache
+.parcel-cache
 
-# OS
+# Next.js build output
-.DS_Store
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/

.vscode/extensions.json

@@ -1,11 +1,9 @@
 {
   "recommendations": [
     "biomejs.biome",
-    "codezombiech.gitignore",
     "hverlin.mise-vscode",
     "oven.bun-vscode",
     "redhat.vscode-yaml",
-    "tamasfe.even-better-toml",
+    "tamasfe.even-better-toml"
-    "unional.vscode-sort-package-json"
   ]
 }

.vscode/settings.json

@@ -43,8 +43,6 @@
   "files.watcherExclude": {
     "**/routeTree.gen.ts": true
   },
-  "js/ts.tsdk.path": "node_modules/typescript/lib",
-  "js/ts.tsdk.promptToUseWorkspaceVersion": true,
   "search.exclude": {
     "**/routeTree.gen.ts": true
   }

AGENTS.md

@@ -1,109 +1,219 @@
-# AGENTS.md
+# AGENTS.md - AI Coding Agent Guidelines
 
-Repo-specific notes for AI agents.
+Guidelines for AI agents working in this Bun monorepo.
 
-## Stack
+## Project Overview
 
-- Bun-only (`mise.toml` pins `bun = 1.3.13`). Do not use `npm` / `npx` / `node` / `yarn` / `pnpm`.
+> **This project uses [Bun](https://bun.sh) exclusively as both the JavaScript runtime and package manager. Do NOT use Node.js / npm / yarn / pnpm. All commands start with `bun` — use `bun install` for dependencies and `bun run <script>` for scripts. Always prefer `bun run <script>` over `bun <script>` to avoid conflicts with Bun built-in subcommands (e.g. `bun build` invokes Bun's bundler, NOT your package.json script). Never use `npm`, `npx`, or `node`.**
-- TanStack Start + React 19 SSR + Vite + Nitro `bun` preset.
-- ORPC contract-first API, TanStack Query v5, Tailwind v4.
-- Business data source is the customer's existing **MySQL** database. This app is read-only display software.
-- There is no PostgreSQL, Drizzle schema, embedded migration flow, or local DB mutation path in this project now.
-- `scripts/seed.ts` is the only local development helper allowed to create/truncate/insert sample data. The app runtime must stay read-only.
 
-## Scripts
+- **Monorepo**: Bun workspaces + Turborepo orchestration
+- **Runtime**: Bun (see `mise.toml` for version) — **NOT Node.js**
+- **Package Manager**: Bun — **NOT npm / yarn / pnpm**
+- **Apps**:
+  - `apps/server` - TanStack Start fullstack web app (see `apps/server/AGENTS.md`)
+  - `apps/desktop` - Electron desktop shell, sidecar server pattern (see `apps/desktop/AGENTS.md`)
+- **Packages**: `packages/tsconfig` (shared TS configs)
 
+## Build / Lint / Test Commands
+
+### Root Commands (via Turbo)
 ```bash
-bun run dev
+bun run dev              # Start all apps in dev mode
-bun run build
+bun run build            # Build all apps
-bun run compile
+bun run compile          # Compile server to standalone binary (current platform)
-bun run seed
+bun run compile:darwin   # Compile server for macOS (arm64 + x64)
-bun run typecheck
+bun run compile:linux    # Compile server for Linux (x64 + arm64)
-bun run test
+bun run compile:windows  # Compile server for Windows x64
-bun run fix
+bun run dist             # Package desktop distributable (current platform)
+bun run dist:linux       # Package desktop for Linux (x64 + arm64)
+bun run dist:mac         # Package desktop for macOS (arm64 + x64)
+bun run dist:win         # Package desktop for Windows x64
+bun run fix              # Lint + format (Biome auto-fix)
+bun run typecheck        # TypeScript check across monorepo
 ```
 
-Before shipping: `bun run fix && bun run typecheck && bun run test && bun run build`.
+### Server App (`apps/server`)
-
-## MySQL Source
-
-Environment variable:
-
 ```bash
-DATABASE_URL=mysql://user:password@host:3306/database
+bun run dev                   # Vite dev server (localhost:3000)
+bun run build                 # Production build -> .output/
+bun run compile               # Compile to standalone binary (current platform)
+bun run compile:darwin        # Compile for macOS (arm64 + x64)
+bun run compile:darwin:arm64  # Compile for macOS arm64
+bun run compile:darwin:x64    # Compile for macOS x64
+bun run compile:linux         # Compile for Linux (x64 + arm64)
+bun run compile:linux:arm64   # Compile for Linux arm64
+bun run compile:linux:x64     # Compile for Linux x64
+bun run compile:windows       # Compile for Windows (default: x64)
+bun run compile:windows:x64   # Compile for Windows x64
+bun run fix                   # Biome auto-fix
+bun run typecheck             # TypeScript check
+
+# Database (Drizzle)
+bun run db:generate           # Generate migrations from schema
+bun run db:migrate            # Run migrations
+bun run db:push               # Push schema (dev only)
+bun run db:studio             # Open Drizzle Studio
 ```
 
-Required AI prediction service:
+### Desktop App (`apps/desktop`)
-
 ```bash
-SOH_PREDICTION_API_BASE_URL=http://127.0.0.1:8000
+bun run dev                   # electron-vite dev mode (requires server dev running)
-SOH_PREDICTION_CACHE_TTL_SECONDS=86400
+bun run build                 # electron-vite build (main + preload)
-SOH_PREDICTION_TIMEOUT_MS=10000
+bun run dist                  # Build + package for current platform
+bun run dist:linux            # Build + package for Linux (x64 + arm64)
+bun run dist:linux:x64        # Build + package for Linux x64
+bun run dist:linux:arm64      # Build + package for Linux arm64
+bun run dist:mac              # Build + package for macOS (arm64 + x64)
+bun run dist:mac:arm64        # Build + package for macOS arm64
+bun run dist:mac:x64          # Build + package for macOS x64
+bun run dist:win              # Build + package for Windows x64
+bun run fix                   # Biome auto-fix
+bun run typecheck             # TypeScript check
 ```
 
-Customer table: `ls_battery_info`.
+### Testing
-
+No test framework configured yet. When adding tests:
-| Column | Type | Meaning |
+```bash
-| --- | --- | --- |
+bun test path/to/test.ts              # Run single test file
-| `id` | `int(11)` auto increment | primary key |
+bun test -t "pattern"                 # Run tests matching pattern
-| `user_id` | `int(11)` | user ID |
-| `mac` | `varchar(50)` | device MAC |
-| `dev_model` | `varchar(20)` | device model |
-| `dev_name` | `varchar(50)` | device name |
-| `is_low_power` | `varchar(10)` | `true` / `false` |
-| `power_status` | `tinyint(4)` | `0` not charging, `1` charging, `2` full |
-| `power` | `tinyint(4)` | current battery `0~100` |
-| `create_time` | `datetime` | created time |
-| `remark` | `varchar(500)` | nullable remark |
-
-Rules:
-
-- Only run `SELECT` queries against this table. Do not insert, update, delete, migrate, or create tables.
-- Do not add mock/fallback rows. If MySQL is unavailable, surface the error.
-- `is_low_power` is stored as a string and normalized to boolean in `src/domain/battery.ts`.
-- `power_status` is normalized to `0 | 1 | 2`.
-- `battery.batteries` returns paginated latest records per `mac`; supported filters are `pageSize`, `cursor`, `search`, `lowPower`, `powerStatus`, and `sort`.
-- `battery.history` takes `mac` and returns history ordered by `create_time DESC, id DESC`, limited to 500 rows.
-- Dashboard requires the external prediction API via `SOH_PREDICTION_API_BASE_URL`; missing configuration must fail environment validation. Per-device prediction failures may surface as unavailable values, but must not be rendered as `0%`.
-
-## Layout
-
-```
-src/
-├── routes/
-│   ├── index.tsx       # SoH dashboard
-│   ├── batteries.tsx   # battery monitor page
-│   └── api/            # ORPC handlers
-├── server/
-│   ├── api/            # contracts / routers / interceptors
-│   ├── battery/mysql.ts
-│   └── prediction/client.ts
-├── domain/battery.ts
-├── client/orpc.ts
-└── styles.css
 ```
 
-## ORPC
+## Code Style (TypeScript)
 
-- Contracts live in `src/server/api/contracts/`.
+### Formatting (Biome)
-- Routers live in `src/server/api/routers/`.
+- **Indent**: 2 spaces | **Line endings**: LF
-- Use `os` from `@/server/api/server`.
+- **Quotes**: Single `'` | **Semicolons**: Omit (ASI)
-- Current business API:
+- **Arrow parentheses**: Always `(x) => x`
-  - `battery.dashboard`
-  - `battery.batteries`
-  - `battery.history`
 
-## CLI And Deploy
+### Imports
+Biome auto-organizes. Order: 1) External packages → 2) Internal `@/*` aliases → 3) Type imports (`import type { ... }`)
 
-- `src/bin.ts` must keep static imports minimal. Nitro's bun preset starts the server as a side effect when `.output/server/index.mjs` is imported.
+```typescript
-- `serve` is lazy-loaded via citty.
+import { createFileRoute } from '@tanstack/react-router'
-- `bun run compile` produces `out/server-<target>`.
+import { z } from 'zod'
-- Runtime artifact is a single binary plus `DATABASE_URL` configuration.
+import { db } from '@/server/db'
+import type { ReactNode } from 'react'
+```
 
-## Code Style
+### TypeScript Strictness
+- `strict: true`, `noUncheckedIndexedAccess: true`, `noImplicitOverride: true`, `verbatimModuleSyntax: true`
+- Use `@/*` path aliases (maps to `src/*`)
 
-- 2-space indentation, LF, single quotes, semicolons as-needed, 120-column line width.
+### Naming Conventions
-- Route components use `function Foo()` declarations below route config.
+| Type | Convention | Example |
-- No `console.*` in business code; use `getLogger([...])` from `@/server/logger` if logging is needed.
+|------|------------|---------|
-- No `as any`, `@ts-ignore`, or `@ts-expect-error`.
+| Files (utils) | kebab-case | `auth-utils.ts` |
-- Do not edit `src/routeTree.gen.ts` manually.
+| Files (components) | PascalCase | `UserProfile.tsx` |
+| Components | PascalCase arrow | `const Button = () => {}` |
+| Functions | camelCase | `getUserById` |
+| Constants | UPPER_SNAKE | `MAX_RETRIES` |
+| Types/Interfaces | PascalCase | `UserProfile` |
+
+### React Patterns
+- Components: arrow functions (enforced by Biome)
+- Routes: TanStack Router file conventions (`export const Route = createFileRoute(...)`)
+- Data fetching: `useSuspenseQuery(orpc.feature.list.queryOptions())`
+- Let React Compiler handle memoization (no manual `useMemo`/`useCallback`)
+
+### Error Handling
+- Use `try-catch` for async operations; throw descriptive errors
+- ORPC: Use `ORPCError` with proper codes (`NOT_FOUND`, `INPUT_VALIDATION_FAILED`)
+- Never use empty catch blocks
+
+## Database (Drizzle ORM v1 beta + postgres-js)
+
+- **ORM**: Drizzle ORM `1.0.0-beta` (RQBv2)
+- **Driver**: `drizzle-orm/postgres-js` (NOT `bun-sql`)
+- **Validation**: `drizzle-orm/zod` (built-in, NOT separate `drizzle-zod` package)
+- **Relations**: Defined via `defineRelations()` in `src/server/db/relations.ts` (contains schema info, so `drizzle()` only needs `{ relations }`)
+- **Query style**: RQBv2 object syntax (`orderBy: { createdAt: 'desc' }`, `where: { id: 1 }`)
+
+```typescript
+export const myTable = pgTable('my_table', {
+  id: uuid().primaryKey().default(sql`uuidv7()`),
+  name: text().notNull(),
+  createdAt: timestamp({ withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp({ withTimezone: true }).notNull().defaultNow().$onUpdateFn(() => new Date()),
+})
+```
+
+## Environment Variables
+
+- Use `@t3-oss/env-core` with Zod validation in `src/env.ts`
+- Server vars: no prefix | Client vars: `VITE_` prefix required
+- Never commit `.env` files
+
+## Dependency Management
+
+- All versions centralized in root `package.json` `catalog` field
+- Workspace packages use `"catalog:"` — never hardcode versions
+- Internal packages use `"workspace:*"` references
+
+## Development Principles
+
+> **These principles apply to ALL code changes. Agents MUST follow them on every task.**
+
+1. **No backward compatibility** — This project is in rapid iteration. Always use the latest API and patterns. Never keep deprecated code paths or old API fallbacks "just in case".
+2. **Always sync documentation** — When code changes, immediately update all related documentation (`AGENTS.md`, `README.md`, inline code examples). Code and docs must never drift apart. This includes updating code snippets in docs when imports, APIs, or patterns change.
+3. **Forward-only migration** — When upgrading dependencies, fully adopt the new API. Don't mix old and new patterns in the same codebase.
+
+## Critical Rules
+
+**DO:**
+- Run `bun run fix` before committing
+- Use `@/*` path aliases (not relative imports)
+- Include `createdAt`/`updatedAt` on all tables
+- Use `catalog:` for dependency versions
+- Update `AGENTS.md` and other docs whenever code patterns change
+
+**DON'T:**
+- Use `npm`, `npx`, `node`, `yarn`, `pnpm` — always use `bun` / `bunx`
+- Edit `src/routeTree.gen.ts` (auto-generated)
+- Use `as any`, `@ts-ignore`, `@ts-expect-error`
+- Commit `.env` files
+- Use empty catch blocks `catch(e) {}`
+- Hardcode dependency versions in workspace packages
+- Leave docs out of sync with code changes
+
+## Git Workflow
+
+1. Make changes following style guide
+2. `bun run fix` - auto-format and lint
+3. `bun run typecheck` - verify types
+4. `bun run dev` - test locally
+5. Commit with descriptive message
+
+## Directory Structure
+
+```
+.
+├── apps/
+│   ├── server/           # TanStack Start fullstack app
+│   │   ├── src/
+│   │   │   ├── client/   # ORPC client + TanStack Query utils
+│   │   │   ├── components/
+│   │   │   ├── routes/   # File-based routing
+│   │   │   └── server/   # API layer + database
+│   │   │       ├── api/  # ORPC contracts, routers, middlewares
+│   │   │       └── db/   # Drizzle schema
+│   │   └── AGENTS.md
+│   └── desktop/          # Electron desktop shell
+│       ├── src/
+│       │   ├── main/
+│       │   │   └── index.ts       # Main process entry
+│       │   └── preload/
+│       │       └── index.ts       # Preload script
+│       ├── electron.vite.config.ts
+│       ├── electron-builder.yml   # Packaging config
+│       └── AGENTS.md
+├── packages/
+│   └── tsconfig/         # Shared TS configs
+├── biome.json            # Linting/formatting config
+├── turbo.json            # Turbo task orchestration
+└── package.json          # Workspace root + dependency catalog
+```
+
+## See Also
+
+- `apps/server/AGENTS.md` - Detailed TanStack Start / ORPC patterns
+- `apps/desktop/AGENTS.md` - Electron desktop development guide

Dockerfile

@@ -1,24 +0,0 @@
-FROM oven/bun:1.3.13 AS source
-
-WORKDIR /app
-
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile
-
-COPY . .
-
-FROM source AS build
-
-RUN bun run build \
-    && bun run compile \
-    && mv out/server-* out/server
-
-FROM gcr.io/distroless/cc-debian13:nonroot
-
-WORKDIR /app
-COPY --from=build --chown=nonroot:nonroot /app/out/server ./server
-
-ENV HOST=0.0.0.0
-EXPOSE 3000
-
-CMD ["./server"]

README.md

@@ -1,143 +0,0 @@
-# battery-soh
-
-电池健康运营看板，用于接入客户现有设备数据，持续呈现电量状态、健康预测、风险分布与维护建议。系统以只读方式连接客户数据库，不改动生产数据；当健康预测暂不可用时，页面会明确显示不可用状态，避免用误导性数值替代真实结果。
-
-## 产品能力
-
-- **健康总览**：聚合展示设备规模、平均健康度、30/90 天趋势与预警设备占比。
-- **风险识别**：按健康度、低电量、充电状态与预测风险生成重点关注设备清单。
-- **实时明细**：支持按设备名称、编号、电量与充电状态筛选设备，快速定位需要排查的对象。
-- **维护建议**：基于当前可用数据给出巡检、复查与优先处理建议。
-- **可信展示**：缺少预测结果时显示“预测不可用”，不会将缺失值渲染为 `0%`。
-
-## 数据接入
-
-系统接入客户现有 MySQL 数据源，业务运行时仅执行只读查询。需要配置：
-
-```bash
-DATABASE_URL=mysql://user:password@host:3306/database
-```
-
-客户设备表：`ls_battery_info`。
-
-| 字段名 | 数据类型 | 业务含义 |
-| --- | --- | --- |
-| `id` | `int(11)` auto increment | 记录 ID |
-| `user_id` | `int(11)` | 用户 ID |
-| `mac` | `varchar(50)` | 设备编号 |
-| `dev_model` | `varchar(20)` | 设备型号 |
-| `dev_name` | `varchar(50)` | 设备名称 |
-| `is_low_power` | `varchar(10)` | 是否低电量：`true` / `false` |
-| `power_status` | `tinyint(4)` | `0` 未充电，`1` 充电中，`2` 已充满 |
-| `power` | `tinyint(4)` | 当前电量 `0~100` |
-| `create_time` | `datetime` | 采集时间 |
-| `remark` | `varchar(500)` | 备注 |
-
-## 健康预测
-
-看板需要接入外部 SoH 预测服务：
-
-```bash
-SOH_PREDICTION_API_BASE_URL=http://127.0.0.1:8000
-SOH_PREDICTION_CACHE_TTL_SECONDS=86400
-SOH_PREDICTION_NEGATIVE_CACHE_TTL_SECONDS=300
-SOH_PREDICTION_TIMEOUT_MS=10000
-```
-
-服务端会调用 `${SOH_PREDICTION_API_BASE_URL}/predict`，使用返回的当前健康度、30 天趋势、90 天趋势和风险评分生成看板视图。预测结果会按设备与最新采集记录缓存，默认 24 小时；单台设备预测失败或历史数据不足时会短暂缓存不可用状态，默认 5 分钟，避免反复打满预测服务，同时仅该设备显示为“预测不可用”。
-
-## 接口文档
-
-OpenAPI 文档和规格默认不公开，生产或生产类运行环境应保持默认值：
-
-```bash
-ENABLE_API_DOCS=false
-```
-
-仅在受控本地开发或内网演示环境显式设置 `ENABLE_API_DOCS=true` 后，才会开放 `http://localhost:3000/api/docs` 与 `http://localhost:3000/api/spec.json`。`/api/rpc` 不受此开关影响。
-
-## 快速开始
-
-```bash
-cp .env.example .env
-bun install
-bun run dev
-```
-
-打开浏览器：
-
-- `http://localhost:3000/`：设备健康运营看板
-- `http://localhost:3000/batteries`：设备状态明细
-- `http://localhost:3000/api/docs`：接口文档（需设置 `ENABLE_API_DOCS=true`）
-
-## 本地演示环境
-
-如果暂时没有生产数据库连接，可以使用 Docker Compose 启动本地 MySQL 并填充演示数据：
-
-```bash
-docker compose up --build
-```
-
-Compose 会启动：
-
-- `db`：本地 MySQL 8.4
-- `seed`：初始化本地 `ls_battery_info` 演示数据
-- `app`：启动应用服务
-
-Compose 的 `app` 服务会为本地演示显式启用 `ENABLE_API_DOCS=true`；生产部署不应沿用该设置，除非已通过网络边界或上游认证限制访问。
-
-也可以手动初始化本地数据：
-
-```bash
-DATABASE_URL=mysql://battery:battery@localhost:3306/battery_soh bun run seed
-```
-
-`seed` 仅用于本地开发和演示环境；应用运行时仍保持只读查询，不写入业务数据库。
-
-## 系统结构
-
-```text
-src/
-├── routes/                  # 页面与 API 路由
-├── server/
-│   ├── api/                 # 接口契约与路由
-│   ├── battery/mysql.ts     # 设备数据只读查询
-│   └── prediction/client.ts # 健康预测服务客户端
-├── domain/battery.ts        # 电池领域模型与看板聚合
-├── client/orpc.ts           # 前端接口客户端
-└── styles.css               # 全局样式入口
-```
-
-核心接口：
-
-- `battery.dashboard`：生成健康运营看板数据。
-- `battery.batteries`：分页返回每台设备的最新状态，支持搜索、筛选和排序。
-- `battery.history`：返回单台设备最近 500 条历史记录。
-
-## 部署
-
-```bash
-bun run build
-bun run compile
-./out/server-<target>
-```
-
-构建产物为单个服务二进制文件，运行时需要配置 `DATABASE_URL` 与 SoH 预测服务地址。
-
-## 常用命令
-
-| 命令 | 作用 |
-| --- | --- |
-| `bun run dev` | 启动开发服务 |
-| `bun run build` | 构建应用 |
-| `bun run compile` | 生成单二进制产物 |
-| `bun run seed` | 初始化本地演示数据 |
-| `bun run typecheck` | TypeScript 类型检查 |
-| `bun run test` | 运行测试 |
-| `bun run fix` | 格式化与静态检查 |
-
-交付前验证：
-
-```bash
-bun run fix && bun run typecheck && bun run test && bun run build
-```

apps/desktop/.gitignore

@@ -0,0 +1,3 @@
+# electron-vite build output
+out/
+dist/

apps/desktop/AGENTS.md

@@ -0,0 +1,95 @@
+# AGENTS.md - Desktop App Guidelines
+
+Thin Electron shell hosting the fullstack server app.
+
+## Tech Stack
+
+> **⚠️ This project uses Bun as the package manager. Runtime is Electron (Node.js). Always use `bun run <script>` (not `bun <script>`) to avoid conflicts with Bun built-in subcommands. Never use `npm`, `npx`, `yarn`, or `pnpm`.**
+
+- **Type**: Electron desktop shell
+- **Design**: Server-driven desktop (thin native window hosting web app)
+- **Runtime**: Electron (Main/Renderer) + Sidecar server binary (Bun-compiled)
+- **Build Tool**: electron-vite (Vite-based, handles main + preload builds)
+- **Packager**: electron-builder (installers, signing, auto-update)
+- **Orchestration**: Turborepo
+
+## Architecture
+
+- **Server-driven design**: The desktop app is a "thin" native shell. It does not contain UI or business logic; it opens a BrowserWindow pointing to the `apps/server` TanStack Start application.
+- **Dev mode**: Opens a BrowserWindow pointing to `localhost:3000`. Requires `apps/server` to be running separately (Turbo handles this).
+- **Production mode**: Spawns a compiled server binary (from `resources/`) as a sidecar process, waits for readiness, then loads its URL.
+
+## Commands
+
+```bash
+bun run dev                    # electron-vite dev (requires server dev running)
+bun run build                  # electron-vite build (main + preload)
+bun run dist                   # Build + package for current platform
+bun run dist:linux             # Build + package for Linux (x64 + arm64)
+bun run dist:linux:x64         # Build + package for Linux x64
+bun run dist:linux:arm64       # Build + package for Linux arm64
+bun run dist:mac               # Build + package for macOS (arm64 + x64)
+bun run dist:mac:arm64         # Build + package for macOS arm64
+bun run dist:mac:x64           # Build + package for macOS x64
+bun run dist:win               # Build + package for Windows x64
+bun run fix                    # Biome auto-fix
+bun run typecheck              # TypeScript check
+```
+
+## Directory Structure
+
+```
+.
+├── src/
+│   ├── main/
+│   │   └── index.ts       # Main process (server lifecycle + BrowserWindow)
+│   └── preload/
+│       └── index.ts       # Preload script (security isolation)
+├── resources/             # Sidecar binaries (gitignored, copied from server build)
+├── out/                   # electron-vite build output (gitignored)
+├── electron.vite.config.ts
+├── electron-builder.yml   # Packaging configuration
+├── package.json
+├── turbo.json
+└── AGENTS.md
+```
+
+## Development Workflow
+
+1. **Start server**: `bun run dev` in `apps/server` (or use root `bun run dev` via Turbo).
+2. **Start desktop**: `bun run dev` in `apps/desktop`.
+3. **Connection**: Main process polls `localhost:3000` until responsive, then opens BrowserWindow.
+
+## Production Build Workflow
+
+From monorepo root, run `bun run dist` to execute the full pipeline automatically (via Turbo task dependencies):
+
+1. **Build server**: `apps/server` → `vite build` → `.output/`
+2. **Compile server**: `apps/server` → `bun compile.ts --target ...` → `out/server-{os}-{arch}`
+3. **Package desktop**: `apps/desktop` → `electron-vite build` + `electron-builder` → distributable
+
+The `electron-builder.yml` `extraResources` config reads binaries directly from `../server/out/`, no manual copy needed.
+
+To build for a specific platform explicitly, use `bun run dist:linux` / `bun run dist:mac` / `bun run dist:win` in `apps/desktop`.
+For single-arch output, use `bun run dist:linux:x64`, `bun run dist:linux:arm64`, `bun run dist:mac:x64`, or `bun run dist:mac:arm64`.
+
+## Development Principles
+
+> **These principles apply to ALL code changes. Agents MUST follow them on every task.**
+
+1. **No backward compatibility** — This project is in rapid iteration. Always use the latest API and patterns. Never keep deprecated code paths or old API fallbacks.
+2. **Always sync documentation** — When code changes, immediately update all related documentation (`AGENTS.md`, `README.md`, inline code examples). Code and docs must never drift apart.
+3. **Forward-only migration** — When upgrading dependencies, fully adopt the new API. Don't mix old and new patterns.
+
+## Critical Rules
+
+**DO:**
+- Use arrow functions for all utility functions.
+- Keep the desktop app as a thin shell — no UI or business logic.
+- Use `catalog:` for all dependency versions in `package.json`.
+
+**DON'T:**
+- Use `npm`, `npx`, `yarn`, or `pnpm`. Use `bun` for package management.
+- Include UI components or business logic in the desktop app.
+- Use `as any` or `@ts-ignore`.
+- Leave docs out of sync with code changes.

apps/desktop/biome.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "../../node_modules/@biomejs/biome/configuration_schema.json",
+  "extends": "//",
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}

apps/desktop/electron-builder.yml

@@ -0,0 +1,48 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/electron-userland/electron-builder/refs/heads/master/packages/app-builder-lib/scheme.json
+appId: com.furtherverse.desktop
+productName: Furtherverse
+executableName: furtherverse
+
+npmRebuild: false
+asarUnpack:
+  - resources/**
+
+files:
+  - "!**/.vscode/*"
+  - "!src/*"
+  - "!electron.vite.config.{js,ts,mjs,cjs}"
+  - "!{.env,.env.*,bun.lock}"
+  - "!{tsconfig.json,tsconfig.node.json}"
+  - "!{AGENTS.md,README.md,CHANGELOG.md}"
+
+# macOS
+mac:
+  target:
+    - dmg
+  category: public.app-category.productivity
+  extraResources:
+    - from: ../server/out/server-darwin-${arch}
+      to: server
+dmg:
+  artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+
+# Windows
+win:
+  target:
+    - portable
+  extraResources:
+    - from: ../server/out/server-windows-${arch}.exe
+      to: server.exe
+portable:
+  artifactName: ${productName}-${version}-${os}-${arch}-Portable.${ext}
+
+# Linux
+linux:
+  target:
+    - AppImage
+  category: Utility
+  extraResources:
+    - from: ../server/out/server-linux-${arch}
+      to: server
+appImage:
+  artifactName: ${productName}-${version}-${os}-${arch}.${ext}

apps/desktop/electron.vite.config.ts

@@ -0,0 +1,11 @@
+import tailwindcss from '@tailwindcss/vite'
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'electron-vite'
+
+export default defineConfig({
+  main: {},
+  preload: {},
+  renderer: {
+    plugins: [react(), tailwindcss()],
+  },
+})

apps/desktop/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@furtherverse/desktop",
+  "version": "1.0.0",
+  "private": true,
+  "main": "out/main/index.js",
+  "scripts": {
+    "build": "electron-vite build",
+    "dev": "electron-vite dev --watch",
+    "dist": "electron-builder",
+    "dist:linux": "bun run dist:linux:x64 && bun run dist:linux:arm64",
+    "dist:linux:arm64": "electron-builder --linux --arm64",
+    "dist:linux:x64": "electron-builder --linux --x64",
+    "dist:mac": "bun run dist:mac:arm64 && bun run dist:mac:x64",
+    "dist:mac:arm64": "electron-builder --mac --arm64",
+    "dist:mac:x64": "electron-builder --mac --x64",
+    "dist:win": "electron-builder --win --x64",
+    "fix": "biome check --write",
+    "typecheck": "tsc -b"
+  },
+  "dependencies": {
+    "motion": "catalog:",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "tree-kill": "catalog:"
+  },
+  "devDependencies": {
+    "@furtherverse/tsconfig": "workspace:*",
+    "@tailwindcss/vite": "catalog:",
+    "@types/node": "catalog:",
+    "@vitejs/plugin-react": "catalog:",
+    "electron": "catalog:",
+    "electron-builder": "catalog:",
+    "electron-vite": "catalog:",
+    "tailwindcss": "catalog:",
+    "vite": "catalog:"
+  }
+}

apps/desktop/src/main/index.ts

@@ -0,0 +1,198 @@
+import { join } from 'node:path'
+import { app, BrowserWindow, dialog, session, shell } from 'electron'
+import { createSidecarRuntime } from './sidecar'
+
+const DEV_SERVER_URL = 'http://localhost:3000'
+const SAFE_EXTERNAL_PROTOCOLS = new Set(['https:', 'http:', 'mailto:'])
+
+let mainWindow: BrowserWindow | null = null
+let windowCreationPromise: Promise<void> | null = null
+let isQuitting = false
+
+const showErrorAndQuit = (title: string, detail: string) => {
+  if (isQuitting) {
+    return
+  }
+
+  dialog.showErrorBox(title, detail)
+  app.quit()
+}
+
+const sidecar = createSidecarRuntime({
+  devServerUrl: DEV_SERVER_URL,
+  isPackaged: app.isPackaged,
+  resourcesPath: process.resourcesPath,
+  isQuitting: () => isQuitting,
+  onUnexpectedStop: (detail) => {
+    showErrorAndQuit('Service Stopped', detail)
+  },
+})
+
+const toErrorMessage = (error: unknown): string => (error instanceof Error ? error.message : String(error))
+
+const canOpenExternally = (url: string): boolean => {
+  try {
+    const parsed = new URL(url)
+    return SAFE_EXTERNAL_PROTOCOLS.has(parsed.protocol)
+  } catch {
+    return false
+  }
+}
+
+const loadSplash = async (windowRef: BrowserWindow) => {
+  if (process.env.ELECTRON_RENDERER_URL) {
+    await windowRef.loadURL(process.env.ELECTRON_RENDERER_URL)
+    return
+  }
+
+  await windowRef.loadFile(join(__dirname, '../renderer/index.html'))
+}
+
+const createWindow = async () => {
+  if (mainWindow && !mainWindow.isDestroyed()) {
+    mainWindow.focus()
+    return
+  }
+
+  const windowRef = new BrowserWindow({
+    width: 1200,
+    height: 800,
+    show: false,
+    webPreferences: {
+      preload: join(__dirname, '../preload/index.js'),
+      sandbox: true,
+      contextIsolation: true,
+      nodeIntegration: false,
+    },
+  })
+  mainWindow = windowRef
+
+  windowRef.webContents.setWindowOpenHandler(({ url }) => {
+    if (!canOpenExternally(url)) {
+      if (!app.isPackaged) {
+        console.warn(`Blocked external URL: ${url}`)
+      }
+
+      return { action: 'deny' }
+    }
+
+    void shell.openExternal(url)
+    return { action: 'deny' }
+  })
+
+  windowRef.webContents.on('will-navigate', (event, url) => {
+    const allowed = [DEV_SERVER_URL, sidecar.lastResolvedUrl].filter((v): v is string => v != null)
+    const isAllowed = allowed.some((origin) => url.startsWith(origin))
+
+    if (!isAllowed) {
+      event.preventDefault()
+
+      if (canOpenExternally(url)) {
+        void shell.openExternal(url)
+      } else if (!app.isPackaged) {
+        console.warn(`Blocked navigation to: ${url}`)
+      }
+    }
+  })
+
+  windowRef.on('closed', () => {
+    if (mainWindow === windowRef) {
+      mainWindow = null
+    }
+  })
+
+  try {
+    await loadSplash(windowRef)
+  } catch (error) {
+    if (mainWindow === windowRef) {
+      mainWindow = null
+    }
+
+    if (!windowRef.isDestroyed()) {
+      windowRef.destroy()
+    }
+
+    throw error
+  }
+
+  if (!windowRef.isDestroyed()) {
+    windowRef.show()
+  }
+
+  const targetUrl = await sidecar.resolveUrl()
+  if (isQuitting || windowRef.isDestroyed()) {
+    return
+  }
+
+  try {
+    await windowRef.loadURL(targetUrl)
+  } catch (error) {
+    if (mainWindow === windowRef) {
+      mainWindow = null
+    }
+
+    if (!windowRef.isDestroyed()) {
+      windowRef.destroy()
+    }
+
+    throw error
+  }
+}
+
+const ensureWindow = async () => {
+  if (windowCreationPromise) {
+    return windowCreationPromise
+  }
+
+  windowCreationPromise = createWindow().finally(() => {
+    windowCreationPromise = null
+  })
+
+  return windowCreationPromise
+}
+
+const beginQuit = () => {
+  isQuitting = true
+  sidecar.stop()
+}
+
+const handleWindowCreationError = (error: unknown, context: string) => {
+  console.error(`${context}:`, error)
+  showErrorAndQuit(
+    "App Couldn't Start",
+    app.isPackaged
+      ? 'A required component failed to start. Please reinstall the app.'
+      : `${context}: ${toErrorMessage(error)}`,
+  )
+}
+
+app
+  .whenReady()
+  .then(() => {
+    session.defaultSession.setPermissionRequestHandler((_webContents, _permission, callback) => {
+      callback(false)
+    })
+
+    return ensureWindow()
+  })
+  .catch((error) => {
+    handleWindowCreationError(error, 'Failed to create window')
+  })
+
+app.on('window-all-closed', () => {
+  if (process.platform !== 'darwin') {
+    app.quit()
+  }
+})
+
+app.on('activate', () => {
+  if (isQuitting || BrowserWindow.getAllWindows().length > 0) {
+    return
+  }
+
+  ensureWindow().catch((error) => {
+    handleWindowCreationError(error, 'Failed to re-create window')
+  })
+})
+
+app.on('before-quit', beginQuit)

apps/desktop/src/main/sidecar.ts

@@ -0,0 +1,256 @@
+import { type ChildProcess, spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { createServer } from 'node:net'
+import { join } from 'node:path'
+import killProcessTree from 'tree-kill'
+
+const SERVER_HOST = '127.0.0.1'
+const SERVER_READY_TIMEOUT_MS = 10_000
+const SERVER_REQUEST_TIMEOUT_MS = 1_500
+const SERVER_POLL_INTERVAL_MS = 250
+const SERVER_PROBE_PATHS = ['/api/health', '/']
+
+type SidecarState = {
+  process: ChildProcess | null
+  startup: Promise<string> | null
+  url: string | null
+}
+
+type SidecarRuntimeOptions = {
+  devServerUrl: string
+  isPackaged: boolean
+  resourcesPath: string
+  isQuitting: () => boolean
+  onUnexpectedStop: (detail: string) => void
+}
+
+type SidecarRuntime = {
+  resolveUrl: () => Promise<string>
+  stop: () => void
+  lastResolvedUrl: string | null
+}
+
+const sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms))
+
+const isProcessAlive = (processToCheck: ChildProcess | null): processToCheck is ChildProcess => {
+  if (!processToCheck || !processToCheck.pid) {
+    return false
+  }
+
+  return processToCheck.exitCode === null && !processToCheck.killed
+}
+
+const getAvailablePort = (): Promise<number> =>
+  new Promise((resolve, reject) => {
+    const server = createServer()
+    server.listen(0, () => {
+      const addr = server.address()
+      if (!addr || typeof addr === 'string') {
+        server.close()
+        reject(new Error('Failed to resolve port'))
+        return
+      }
+
+      server.close(() => resolve(addr.port))
+    })
+    server.on('error', reject)
+  })
+
+const isServerReady = async (url: string): Promise<boolean> => {
+  for (const probePath of SERVER_PROBE_PATHS) {
+    try {
+      const probeUrl = new URL(probePath, `${url}/`)
+      const response = await fetch(probeUrl, {
+        method: 'GET',
+        cache: 'no-store',
+        signal: AbortSignal.timeout(SERVER_REQUEST_TIMEOUT_MS),
+      })
+
+      if (response.status < 500) {
+        if (probePath === '/api/health' && response.status === 404) {
+          continue
+        }
+
+        return true
+      }
+    } catch {
+      // Expected: probe request fails while server is still starting up
+    }
+  }
+
+  return false
+}
+
+const waitForServer = async (url: string, isQuitting: () => boolean, processRef?: ChildProcess): Promise<boolean> => {
+  const start = Date.now()
+  while (Date.now() - start < SERVER_READY_TIMEOUT_MS && !isQuitting()) {
+    if (processRef && processRef.exitCode !== null) {
+      return false
+    }
+
+    if (await isServerReady(url)) {
+      return true
+    }
+
+    await sleep(SERVER_POLL_INTERVAL_MS)
+  }
+
+  return false
+}
+
+const resolveBinaryPath = (resourcesPath: string): string => {
+  const binaryName = process.platform === 'win32' ? 'server.exe' : 'server'
+  return join(resourcesPath, binaryName)
+}
+
+const formatUnexpectedStopMessage = (
+  isPackaged: boolean,
+  code: number | null,
+  signal: NodeJS.Signals | null,
+): string => {
+  if (isPackaged) {
+    return 'The background service stopped unexpectedly. Please restart the app.'
+  }
+
+  return `Server process exited unexpectedly (code ${code ?? 'unknown'}, signal ${signal ?? 'none'}).`
+}
+
+export const createSidecarRuntime = (options: SidecarRuntimeOptions): SidecarRuntime => {
+  const state: SidecarState = {
+    process: null,
+    startup: null,
+    url: null,
+  }
+
+  const resetState = (processRef?: ChildProcess) => {
+    if (processRef && state.process !== processRef) {
+      return
+    }
+
+    state.process = null
+    state.url = null
+  }
+
+  const stop = () => {
+    const runningServer = state.process
+    resetState()
+
+    if (!runningServer?.pid || runningServer.exitCode !== null) {
+      return
+    }
+
+    killProcessTree(runningServer.pid, 'SIGTERM', (error?: Error) => {
+      if (error) {
+        console.error('Failed to stop server process:', error)
+      }
+    })
+  }
+
+  const attachLifecycleHandlers = (processRef: ChildProcess) => {
+    processRef.on('error', (error) => {
+      if (state.process !== processRef) {
+        return
+      }
+
+      const hadReadyServer = state.url !== null
+      resetState(processRef)
+
+      if (!options.isQuitting() && hadReadyServer) {
+        options.onUnexpectedStop('The background service crashed unexpectedly. Please restart the app.')
+        return
+      }
+
+      console.error('Failed to start server process:', error)
+    })
+
+    processRef.on('exit', (code, signal) => {
+      if (state.process !== processRef) {
+        return
+      }
+
+      const hadReadyServer = state.url !== null
+      resetState(processRef)
+
+      if (!options.isQuitting() && hadReadyServer) {
+        options.onUnexpectedStop(formatUnexpectedStopMessage(options.isPackaged, code, signal))
+      }
+    })
+  }
+
+  const startPackagedServer = async (): Promise<string> => {
+    if (state.url && isProcessAlive(state.process)) {
+      return state.url
+    }
+
+    if (state.startup) {
+      return state.startup
+    }
+
+    state.startup = (async () => {
+      const binaryPath = resolveBinaryPath(options.resourcesPath)
+      if (!existsSync(binaryPath)) {
+        throw new Error(`Sidecar server binary is missing: ${binaryPath}`)
+      }
+
+      if (options.isQuitting()) {
+        throw new Error('Application is shutting down.')
+      }
+
+      const port = await getAvailablePort()
+      const nextServerUrl = `http://${SERVER_HOST}:${port}`
+      const processRef = spawn(binaryPath, [], {
+        env: {
+          ...process.env,
+          HOST: SERVER_HOST,
+          PORT: String(port),
+        },
+        stdio: 'ignore',
+        windowsHide: true,
+      })
+
+      processRef.unref()
+      state.process = processRef
+      attachLifecycleHandlers(processRef)
+
+      const ready = await waitForServer(nextServerUrl, options.isQuitting, processRef)
+      if (ready && isProcessAlive(processRef)) {
+        state.url = nextServerUrl
+        return nextServerUrl
+      }
+
+      const failureReason =
+        processRef.exitCode !== null
+          ? `The service exited early (code ${processRef.exitCode}).`
+          : `The service did not respond at ${nextServerUrl} within 10 seconds.`
+
+      stop()
+      throw new Error(failureReason)
+    })().finally(() => {
+      state.startup = null
+    })
+
+    return state.startup
+  }
+
+  const resolveUrl = async (): Promise<string> => {
+    if (options.isPackaged) {
+      return startPackagedServer()
+    }
+
+    const ready = await waitForServer(options.devServerUrl, options.isQuitting)
+    if (!ready) {
+      throw new Error('Dev server not responding. Run `bun dev` in apps/server first.')
+    }
+
+    state.url = options.devServerUrl
+    return options.devServerUrl
+  }
+
+  return {
+    resolveUrl,
+    stop,
+    get lastResolvedUrl() {
+      return state.url
+    },
+  }
+}

apps/desktop/src/preload/index.ts

@@ -0,0 +1 @@
+export {}

apps/desktop/src/renderer/components/SplashApp.tsx

@@ -0,0 +1,33 @@
+import { motion } from 'motion/react'
+import logoImage from '../assets/logo.png'
+
+export const SplashApp = () => {
+  return (
+    <main className="m-0 flex h-screen w-screen cursor-default select-none items-center justify-center overflow-hidden bg-white font-sans antialiased">
+      <motion.section
+        animate={{ opacity: 1, y: 0 }}
+        className="flex flex-col items-center gap-8"
+        initial={{ opacity: 0, y: 4 }}
+        transition={{
+          duration: 1,
+          ease: [0.16, 1, 0.3, 1],
+        }}
+      >
+        <img alt="Logo" className="h-20 w-auto object-contain" draggable={false} src={logoImage} />
+
+        <div className="relative h-[4px] w-36 overflow-hidden rounded-full bg-zinc-100">
+          <motion.div
+            animate={{ x: '100%' }}
+            className="h-full w-full bg-zinc-800"
+            initial={{ x: '-100%' }}
+            transition={{
+              duration: 2,
+              ease: [0.4, 0, 0.2, 1],
+              repeat: Infinity,
+            }}
+          />
+        </div>
+      </motion.section>
+    </main>
+  )
+}

apps/desktop/src/renderer/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Furtherverse</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="./main.tsx"></script>
+  </body>
+</html>

apps/desktop/src/renderer/main.tsx

@@ -0,0 +1,11 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { SplashApp } from './components/SplashApp'
+import './styles.css'
+
+// biome-ignore lint/style/noNonNullAssertion: 一定存在
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <SplashApp />
+  </StrictMode>,
+)

apps/desktop/src/renderer/styles.css

@@ -0,0 +1 @@
+@import "tailwindcss";

apps/desktop/tsconfig.app.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@furtherverse/tsconfig/react.json",
+  "compilerOptions": {
+    "composite": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src/renderer/**/*"]
+}

apps/desktop/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "files": [],
+  "references": [
+    {
+      "path": "./tsconfig.app.json"
+    },
+    {
+      "path": "./tsconfig.node.json"
+    }
+  ]
+}

apps/desktop/tsconfig.node.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@furtherverse/tsconfig/base.json",
+  "compilerOptions": {
+    "composite": true,
+    "types": ["node"]
+  },
+  "include": ["src/main/**/*", "src/preload/**/*", "electron.vite.config.ts"]
+}

apps/desktop/turbo.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "../../node_modules/turbo/schema.json",
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "outputs": ["out/**"]
+    },
+    "dist": {
+      "dependsOn": ["build", "@furtherverse/server#compile"],
+      "outputs": ["dist/**"]
+    },
+    "dist:linux": {
+      "dependsOn": ["build", "@furtherverse/server#compile:linux:arm64", "@furtherverse/server#compile:linux:x64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:linux:arm64": {
+      "dependsOn": ["build", "@furtherverse/server#compile:linux:arm64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:linux:x64": {
+      "dependsOn": ["build", "@furtherverse/server#compile:linux:x64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:mac": {
+      "dependsOn": ["build", "@furtherverse/server#compile:darwin:arm64", "@furtherverse/server#compile:darwin:x64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:mac:arm64": {
+      "dependsOn": ["build", "@furtherverse/server#compile:darwin:arm64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:mac:x64": {
+      "dependsOn": ["build", "@furtherverse/server#compile:darwin:x64"],
+      "outputs": ["dist/**"]
+    },
+    "dist:win": {
+      "dependsOn": ["build", "@furtherverse/server#compile:windows:x64"],
+      "outputs": ["dist/**"]
+    }
+  }
+}

apps/server/.env.example

@@ -0,0 +1 @@
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres

apps/server/AGENTS.md

@@ -0,0 +1,279 @@
+# AGENTS.md - Server App Guidelines
+
+TanStack Start fullstack web app with ORPC (contract-first RPC).
+
+## Tech Stack
+
+> **⚠️ This project uses Bun — NOT Node.js / npm. All commands use `bun`. Always use `bun run <script>` (not `bun <script>`) to avoid conflicts with Bun built-in subcommands. Never use `npm`, `npx`, or `node`.**
+
+- **Framework**: TanStack Start (React 19 SSR, file-based routing)
+- **Runtime**: Bun — **NOT Node.js**
+- **Package Manager**: Bun — **NOT npm / yarn / pnpm**
+- **Language**: TypeScript (strict mode)
+- **Styling**: Tailwind CSS v4
+- **Database**: PostgreSQL + Drizzle ORM v1 beta (`drizzle-orm/postgres-js`, RQBv2)
+- **State**: TanStack Query v5
+- **RPC**: ORPC (contract-first, type-safe)
+- **Build**: Vite + Nitro
+
+## Commands
+
+```bash
+# Development
+bun run dev                    # Vite dev server (localhost:3000)
+bun run db:studio              # Drizzle Studio GUI
+
+# Build
+bun run build                  # Production build → .output/
+bun run compile                # Compile to standalone binary (current platform, depends on build)
+bun run compile:darwin         # Compile for macOS (arm64 + x64)
+bun run compile:darwin:arm64   # Compile for macOS arm64
+bun run compile:darwin:x64     # Compile for macOS x64
+bun run compile:linux          # Compile for Linux (x64 + arm64)
+bun run compile:linux:arm64    # Compile for Linux arm64
+bun run compile:linux:x64      # Compile for Linux x64
+bun run compile:windows        # Compile for Windows (default: x64)
+bun run compile:windows:x64    # Compile for Windows x64
+
+# Code Quality
+bun run fix                    # Biome auto-fix
+bun run typecheck              # TypeScript check
+
+# Database
+bun run db:generate            # Generate migrations from schema
+bun run db:migrate             # Run migrations
+bun run db:push                # Push schema directly (dev only)
+
+# Testing (not yet configured)
+bun test path/to/test.ts       # Run single test
+bun test -t "pattern"          # Run tests matching pattern
+```
+
+## Directory Structure
+
+```
+src/
+├── client/                # Client-side code
+│   └── orpc.ts            # ORPC client + TanStack Query utils (single entry point)
+├── components/            # React components
+├── routes/                # TanStack Router file routes
+│   ├── __root.tsx         # Root layout
+│   ├── index.tsx          # Home page
+│   └── api/
+│       ├── $.ts           # OpenAPI handler + Scalar docs
+│       ├── health.ts      # Health check endpoint
+│       └── rpc.$.ts       # ORPC RPC handler
+├── server/                # Server-side code
+│   ├── api/               # ORPC layer
+│   │   ├── contracts/     # Input/output schemas (Zod)
+│   │   ├── middlewares/   # Middleware (db provider, auth)
+│   │   ├── routers/       # Handler implementations
+│   │   ├── interceptors.ts # Shared error interceptors
+│   │   ├── context.ts     # Request context
+│   │   ├── server.ts      # ORPC server instance
+│   │   └── types.ts       # Type exports
+│   └── db/
+│       ├── schema/        # Drizzle table definitions
+│       ├── fields.ts      # Shared field builders (id, createdAt, updatedAt)
+│       ├── relations.ts   # Drizzle relations (defineRelations, RQBv2)
+│       └── index.ts       # Database instance (postgres-js driver)
+├── env.ts                 # Environment variable validation
+├── router.tsx             # Router configuration
+├── routeTree.gen.ts       # Auto-generated (DO NOT EDIT)
+└── styles.css             # Tailwind entry
+```
+
+## ORPC Pattern
+
+### 1. Define Contract (`src/server/api/contracts/feature.contract.ts`)
+```typescript
+import { oc } from '@orpc/contract'
+import { createSelectSchema } from 'drizzle-orm/zod'
+import { z } from 'zod'
+import { featureTable } from '@/server/db/schema'
+
+const selectSchema = createSelectSchema(featureTable)
+
+export const list = oc.input(z.void()).output(z.array(selectSchema))
+export const create = oc.input(insertSchema).output(selectSchema)
+```
+
+### 2. Implement Router (`src/server/api/routers/feature.router.ts`)
+```typescript
+import { ORPCError } from '@orpc/server'
+import { db } from '../middlewares'
+import { os } from '../server'
+
+export const list = os.feature.list.use(db).handler(async ({ context }) => {
+  return await context.db.query.featureTable.findMany({
+    orderBy: { createdAt: 'desc' },
+  })
+})
+```
+
+### 3. Register in Index Files
+```typescript
+// src/server/api/contracts/index.ts
+import * as feature from './feature.contract'
+export const contract = { feature }
+
+// src/server/api/routers/index.ts
+import * as feature from './feature.router'
+export const router = os.router({ feature })
+```
+
+### 4. Use in Components
+```typescript
+import { useSuspenseQuery, useMutation } from '@tanstack/react-query'
+import { orpc } from '@/client/orpc'
+
+const { data } = useSuspenseQuery(orpc.feature.list.queryOptions())
+const mutation = useMutation(orpc.feature.create.mutationOptions())
+```
+
+## Database (Drizzle ORM v1 beta)
+
+- **Driver**: `drizzle-orm/postgres-js` (NOT `bun-sql`)
+- **Validation**: `drizzle-orm/zod` (built-in, NOT separate `drizzle-zod` package)
+- **Relations**: Defined via `defineRelations()` in `src/server/db/relations.ts`
+- **Query**: RQBv2 — use `db.query.tableName.findMany()` with object-style `orderBy` and `where`
+
+### Schema Definition
+```typescript
+import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
+import { sql } from 'drizzle-orm'
+
+export const myTable = pgTable('my_table', {
+  id: uuid().primaryKey().default(sql`uuidv7()`),
+  name: text().notNull(),
+  createdAt: timestamp({ withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp({ withTimezone: true }).notNull().defaultNow().$onUpdateFn(() => new Date()),
+})
+```
+
+### Relations (RQBv2)
+```typescript
+// src/server/db/relations.ts
+import { defineRelations } from 'drizzle-orm'
+import * as schema from './schema'
+
+export const relations = defineRelations(schema, (r) => ({
+  // Define relations here using r.one / r.many / r.through
+}))
+```
+
+### DB Instance
+```typescript
+// src/server/db/index.ts
+import { drizzle } from 'drizzle-orm/postgres-js'
+import { relations } from '@/server/db/relations'
+// In RQBv2, relations already contain schema info — no separate schema import needed
+
+const db = drizzle({
+  connection: env.DATABASE_URL,
+  relations,
+})
+```
+
+### RQBv2 Query Examples
+```typescript
+// Object-style orderBy (NOT callback style)
+const todos = await db.query.todoTable.findMany({
+  orderBy: { createdAt: 'desc' },
+})
+
+// Object-style where
+const todo = await db.query.todoTable.findFirst({
+  where: { id: someId },
+})
+```
+
+## Code Style
+
+### Formatting (Biome)
+- **Indent**: 2 spaces
+- **Quotes**: Single `'`
+- **Semicolons**: Omit (ASI)
+- **Arrow parens**: Always `(x) => x`
+
+### Imports
+Biome auto-organizes:
+1. External packages
+2. Internal `@/*` aliases
+3. Type imports (`import type { ... }`)
+
+```typescript
+import { createFileRoute } from '@tanstack/react-router'
+import { z } from 'zod'
+import { db } from '@/server/db'
+import type { ReactNode } from 'react'
+```
+
+### TypeScript
+- `strict: true`
+- `noUncheckedIndexedAccess: true` - array access returns `T | undefined`
+- Use `@/*` path aliases (maps to `src/*`)
+
+### Naming
+| Type | Convention | Example |
+|------|------------|---------|
+| Files (utils) | kebab-case | `auth-utils.ts` |
+| Files (components) | PascalCase | `UserProfile.tsx` |
+| Components | PascalCase arrow | `const Button = () => {}` |
+| Functions | camelCase | `getUserById` |
+| Types | PascalCase | `UserProfile` |
+
+### React
+- Use arrow functions for components (Biome enforced)
+- Use `useSuspenseQuery` for guaranteed data
+- Let React Compiler handle memoization (no manual `useMemo`/`useCallback`)
+
+## Environment Variables
+
+```typescript
+// src/env.ts - using @t3-oss/env-core
+import { createEnv } from '@t3-oss/env-core'
+import { z } from 'zod'
+
+export const env = createEnv({
+  server: {
+    DATABASE_URL: z.string().url(),
+  },
+  clientPrefix: 'VITE_',
+  client: {
+    VITE_API_URL: z.string().optional(),
+  },
+})
+```
+
+## Development Principles
+
+> **These principles apply to ALL code changes. Agents MUST follow them on every task.**
+
+1. **No backward compatibility** — This project is in rapid iteration. Always use the latest API and patterns. Never keep deprecated code paths or old API fallbacks.
+2. **Always sync documentation** — When code changes, immediately update all related documentation (`AGENTS.md`, `README.md`, inline code examples). Code and docs must never drift apart.
+3. **Forward-only migration** — When upgrading dependencies, fully adopt the new API. Don't mix old and new patterns.
+
+## Critical Rules
+
+**DO:**
+- Run `bun run fix` before committing
+- Use `@/*` path aliases
+- Include `createdAt`/`updatedAt` on all tables
+- Use `ORPCError` with proper codes
+- Use `drizzle-orm/zod` (NOT `drizzle-zod`) for schema validation
+- Use RQBv2 object syntax for `orderBy` and `where`
+- Update `AGENTS.md` and other docs whenever code patterns change
+
+**DON'T:**
+- Use `npm`, `npx`, `node`, `yarn`, `pnpm` — always use `bun` / `bunx`
+- Edit `src/routeTree.gen.ts` (auto-generated)
+- Use `as any`, `@ts-ignore`, `@ts-expect-error`
+- Commit `.env` files
+- Use empty catch blocks
+- Import from `drizzle-zod` (use `drizzle-orm/zod` instead)
+- Use RQBv1 callback-style `orderBy` / old `relations()` API
+- Use `drizzle-orm/bun-sql` driver (use `drizzle-orm/postgres-js`)
+- Pass `schema` to `drizzle()` constructor (only `relations` is needed in RQBv2)
+- Import `os` from `@orpc/server` in middleware — use `@/server/api/server` (the local typed instance)
+- Leave docs out of sync with code changes

apps/server/biome.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "../../node_modules/@biomejs/biome/configuration_schema.json",
+  "extends": "//",
+  "files": {
+    "includes": ["**", "!**/routeTree.gen.ts"]
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}

apps/server/compile.ts

@@ -1,8 +1,7 @@
 import { mkdir, rm } from 'node:fs/promises'
-import { basename } from 'node:path'
 import { parseArgs } from 'node:util'
 
-const ENTRYPOINT = 'src/bin.ts'
+const ENTRYPOINT = '.output/server/index.mjs'
 const OUTDIR = 'out'
 
 const SUPPORTED_TARGETS: readonly Bun.Build.CompileTarget[] = [
@@ -13,9 +12,8 @@ const SUPPORTED_TARGETS: readonly Bun.Build.CompileTarget[] = [
   'bun-linux-arm64',
 ]
 
-const SUPPORTED_TARGET_SET: ReadonlySet<string> = new Set(SUPPORTED_TARGETS)
+const isSupportedTarget = (value: string): value is Bun.Build.CompileTarget =>
-
+  (SUPPORTED_TARGETS as readonly string[]).includes(value)
-const isSupportedTarget = (value: string): value is Bun.Build.CompileTarget => SUPPORTED_TARGET_SET.has(value)
 
 const { values } = parseArgs({
   options: { target: { type: 'string' } },
@@ -50,20 +48,13 @@ const main = async () => {
   const result = await Bun.build({
     entrypoints: [ENTRYPOINT],
     outdir: OUTDIR,
-    // autoloadDotenv: false — produce a deterministic binary; it must not silently consume a .env from cwd.
+    compile: { outfile, target },
-    compile: { outfile, target, autoloadDotenv: false },
-    minify: true,
-    bytecode: true,
-    sourcemap: 'inline',
   })
 
   if (!result.success) {
     throw new Error(result.logs.map(String).join('\n'))
   }
 
-  // Bun bundler still writes *.js.map next to the binary even with inline sourcemap.
-  await rm(`${OUTDIR}/${basename(ENTRYPOINT, '.ts')}.js.map`, { force: true })
-
   console.log(`✓ ${target} → ${OUTDIR}/${outfile}`)
 }
 

apps/server/drizzle.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'drizzle-kit'
+import { env } from '@/env'
+
+export default defineConfig({
+  out: './drizzle',
+  schema: './src/server/db/schema/index.ts',
+  dialect: 'postgresql',
+  dbCredentials: {
+    url: env.DATABASE_URL,
+  },
+})

apps/server/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@furtherverse/server",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "bunx --bun vite build",
+    "compile": "bun compile.ts",
+    "compile:darwin": "bun run compile:darwin:arm64 && bun run compile:darwin:x64",
+    "compile:darwin:arm64": "bun compile.ts --target bun-darwin-arm64",
+    "compile:darwin:x64": "bun compile.ts --target bun-darwin-x64",
+    "compile:linux": "bun run compile:linux:x64 && bun run compile:linux:arm64",
+    "compile:linux:arm64": "bun compile.ts --target bun-linux-arm64",
+    "compile:linux:x64": "bun compile.ts --target bun-linux-x64",
+    "compile:windows": "bun run compile:windows:x64",
+    "compile:windows:x64": "bun compile.ts --target bun-windows-x64",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "dev": "bunx --bun vite dev",
+    "fix": "biome check --write",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@orpc/client": "catalog:",
+    "@orpc/contract": "catalog:",
+    "@orpc/openapi": "catalog:",
+    "@orpc/server": "catalog:",
+    "@orpc/tanstack-query": "catalog:",
+    "@orpc/zod": "catalog:",
+    "@t3-oss/env-core": "catalog:",
+    "@tanstack/react-query": "catalog:",
+    "@tanstack/react-router": "catalog:",
+    "@tanstack/react-router-ssr-query": "catalog:",
+    "@tanstack/react-start": "catalog:",
+    "drizzle-orm": "catalog:",
+    "postgres": "catalog:",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "uuid": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@furtherverse/tsconfig": "workspace:*",
+    "@tailwindcss/vite": "catalog:",
+    "@tanstack/devtools-vite": "catalog:",
+    "@tanstack/react-devtools": "catalog:",
+    "@tanstack/react-query-devtools": "catalog:",
+    "@tanstack/react-router-devtools": "catalog:",
+    "@types/bun": "catalog:",
+    "@vitejs/plugin-react": "catalog:",
+    "babel-plugin-react-compiler": "catalog:",
+    "drizzle-kit": "catalog:",
+    "nitro": "catalog:",
+    "tailwindcss": "catalog:",
+    "vite": "catalog:"
+  }
+}

apps/server/public/robots.txt

@@ -0,0 +1,3 @@
+# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Disallow:

apps/server/src/client/orpc.ts

@@ -24,4 +24,30 @@ const getORPCClient = createIsomorphicFn()
 
 const client: RouterClient = getORPCClient()
 
-export const orpc = createTanstackQueryUtils(client)
+export const orpc = createTanstackQueryUtils(client, {
+  experimental_defaults: {
+    todo: {
+      create: {
+        mutationOptions: {
+          onSuccess: (_, __, ___, ctx) => {
+            ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
+          },
+        },
+      },
+      update: {
+        mutationOptions: {
+          onSuccess: (_, __, ___, ctx) => {
+            ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
+          },
+        },
+      },
+      remove: {
+        mutationOptions: {
+          onSuccess: (_, __, ___, ctx) => {
+            ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
+          },
+        },
+      },
+    },
+  },
+})

apps/server/src/components/Error.tsx

@@ -0,0 +1,3 @@
+export function ErrorComponent() {
+  return <div>An unhandled error happened!</div>
+}

apps/server/src/components/NotFound.tsx

@@ -0,0 +1,3 @@
+export function NotFoundComponent() {
+  return <div>404 - Not Found</div>
+}

apps/server/src/env.ts

@@ -0,0 +1,14 @@
+import { createEnv } from '@t3-oss/env-core'
+import { z } from 'zod'
+
+export const env = createEnv({
+  server: {
+    DATABASE_URL: z.url(),
+  },
+  clientPrefix: 'VITE_',
+  client: {
+    VITE_APP_TITLE: z.string().min(1).optional(),
+  },
+  runtimeEnv: process.env,
+  emptyStringAsUndefined: true,
+})

apps/server/src/routeTree.gen.ts

@@ -9,27 +9,21 @@
 // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
 
 import { Route as rootRouteImport } from './routes/__root'
-import { Route as HealthRouteImport } from './routes/health'
-import { Route as BatteriesRouteImport } from './routes/batteries'
 import { Route as IndexRouteImport } from './routes/index'
+import { Route as ApiHealthRouteImport } from './routes/api/health'
 import { Route as ApiSplatRouteImport } from './routes/api/$'
 import { Route as ApiRpcSplatRouteImport } from './routes/api/rpc.$'
 
-const HealthRoute = HealthRouteImport.update({
-  id: '/health',
-  path: '/health',
-  getParentRoute: () => rootRouteImport,
-} as any)
-const BatteriesRoute = BatteriesRouteImport.update({
-  id: '/batteries',
-  path: '/batteries',
-  getParentRoute: () => rootRouteImport,
-} as any)
 const IndexRoute = IndexRouteImport.update({
   id: '/',
   path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
+const ApiHealthRoute = ApiHealthRouteImport.update({
+  id: '/api/health',
+  path: '/api/health',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiSplatRoute = ApiSplatRouteImport.update({
   id: '/api/$',
   path: '/api/$',
@@ -43,58 +37,40 @@ const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
 
 export interface FileRoutesByFullPath {
   '/': typeof IndexRoute
-  '/batteries': typeof BatteriesRoute
-  '/health': typeof HealthRoute
   '/api/$': typeof ApiSplatRoute
+  '/api/health': typeof ApiHealthRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
-  '/batteries': typeof BatteriesRoute
-  '/health': typeof HealthRoute
   '/api/$': typeof ApiSplatRoute
+  '/api/health': typeof ApiHealthRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
 export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
-  '/batteries': typeof BatteriesRoute
-  '/health': typeof HealthRoute
   '/api/$': typeof ApiSplatRoute
+  '/api/health': typeof ApiHealthRoute
   '/api/rpc/$': typeof ApiRpcSplatRoute
 }
 export interface FileRouteTypes {
   fileRoutesByFullPath: FileRoutesByFullPath
-  fullPaths: '/' | '/batteries' | '/health' | '/api/$' | '/api/rpc/$'
+  fullPaths: '/' | '/api/$' | '/api/health' | '/api/rpc/$'
   fileRoutesByTo: FileRoutesByTo
-  to: '/' | '/batteries' | '/health' | '/api/$' | '/api/rpc/$'
+  to: '/' | '/api/$' | '/api/health' | '/api/rpc/$'
-  id: '__root__' | '/' | '/batteries' | '/health' | '/api/$' | '/api/rpc/$'
+  id: '__root__' | '/' | '/api/$' | '/api/health' | '/api/rpc/$'
   fileRoutesById: FileRoutesById
 }
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
-  BatteriesRoute: typeof BatteriesRoute
-  HealthRoute: typeof HealthRoute
   ApiSplatRoute: typeof ApiSplatRoute
+  ApiHealthRoute: typeof ApiHealthRoute
   ApiRpcSplatRoute: typeof ApiRpcSplatRoute
 }
 
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
-    '/health': {
-      id: '/health'
-      path: '/health'
-      fullPath: '/health'
-      preLoaderRoute: typeof HealthRouteImport
-      parentRoute: typeof rootRouteImport
-    }
-    '/batteries': {
-      id: '/batteries'
-      path: '/batteries'
-      fullPath: '/batteries'
-      preLoaderRoute: typeof BatteriesRouteImport
-      parentRoute: typeof rootRouteImport
-    }
     '/': {
       id: '/'
       path: '/'
@@ -102,6 +78,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/api/health': {
+      id: '/api/health'
+      path: '/api/health'
+      fullPath: '/api/health'
+      preLoaderRoute: typeof ApiHealthRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/$': {
       id: '/api/$'
       path: '/api/$'
@@ -121,9 +104,8 @@ declare module '@tanstack/react-router' {
 
 const rootRouteChildren: RootRouteChildren = {
   IndexRoute: IndexRoute,
-  BatteriesRoute: BatteriesRoute,
-  HealthRoute: HealthRoute,
   ApiSplatRoute: ApiSplatRoute,
+  ApiHealthRoute: ApiHealthRoute,
   ApiRpcSplatRoute: ApiRpcSplatRoute,
 }
 export const routeTree = rootRouteImport

apps/server/src/routes/__root.tsx

@@ -4,7 +4,6 @@ import { ReactQueryDevtoolsPanel } from '@tanstack/react-query-devtools'
 import { createRootRouteWithContext, HeadContent, Scripts } from '@tanstack/react-router'
 import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
 import type { ReactNode } from 'react'
-import { name } from '#package'
 import { ErrorComponent } from '@/components/Error'
 import { NotFoundComponent } from '@/components/NotFound'
 import appCss from '@/styles.css?url'
@@ -24,7 +23,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
         content: 'width=device-width, initial-scale=1',
       },
       {
-        title: name,
+        title: 'Furtherverse',
       },
     ],
     links: [
@@ -35,8 +34,8 @@ export const Route = createRootRouteWithContext<RouterContext>()({
     ],
   }),
   shellComponent: RootDocument,
-  errorComponent: ErrorComponent,
+  errorComponent: () => <ErrorComponent />,
-  notFoundComponent: NotFoundComponent,
+  notFoundComponent: () => <NotFoundComponent />,
 })
 
 function RootDocument({ children }: Readonly<{ children: ReactNode }>) {

apps/server/src/routes/api/$.ts

@@ -3,28 +3,25 @@ import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
 import { onError } from '@orpc/server'
 import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 import { createFileRoute } from '@tanstack/react-router'
-import { name, version } from '#package'
+import { name, version } from '@/../package.json'
-import { env } from '@/env'
 import { handleValidationError, logError } from '@/server/api/interceptors'
 import { router } from '@/server/api/routers'
 
 const handler = new OpenAPIHandler(router, {
-  plugins: env.ENABLE_API_DOCS
+  plugins: [
-    ? [
+    new OpenAPIReferencePlugin({
-        new OpenAPIReferencePlugin({
+      docsProvider: 'scalar',
-          docsProvider: 'scalar',
+      schemaConverters: [new ZodToJsonSchemaConverter()],
-          schemaConverters: [new ZodToJsonSchemaConverter()],
+      specGenerateOptions: {
-          specGenerateOptions: {
+        info: {
-            info: {
+          title: name,
-              title: name,
+          version,
-              version,
+        },
-            },
+      },
-          },
+      docsPath: '/docs',
-          docsPath: '/docs',
+      specPath: '/spec.json',
-          specPath: '/spec.json',
+    }),
-        }),
+  ],
-      ]
-    : [],
   interceptors: [onError(logError)],
   clientInterceptors: [onError(handleValidationError)],
 })
@@ -33,8 +30,6 @@ export const Route = createFileRoute('/api/$')({
   server: {
     handlers: {
       ANY: async ({ request }) => {
-        if (!env.ENABLE_API_DOCS) return new Response('Not Found', { status: 404 })
-
         const { response } = await handler.handle(request, {
           prefix: '/api',
           context: {

apps/server/src/routes/api/health.ts

@@ -0,0 +1,27 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { name, version } from '@/../package.json'
+
+const createHealthResponse = (): Response =>
+  Response.json(
+    {
+      status: 'ok',
+      service: name,
+      version,
+      timestamp: new Date().toISOString(),
+    },
+    {
+      status: 200,
+      headers: {
+        'cache-control': 'no-store',
+      },
+    },
+  )
+
+export const Route = createFileRoute('/api/health')({
+  server: {
+    handlers: {
+      GET: async () => createHealthResponse(),
+      HEAD: async () => new Response(null, { status: 200 }),
+    },
+  },
+})

apps/server/src/routes/index.tsx

@@ -0,0 +1,193 @@
+import { useMutation, useSuspenseQuery } from '@tanstack/react-query'
+import { createFileRoute } from '@tanstack/react-router'
+import type { ChangeEventHandler, SubmitEventHandler } from 'react'
+import { useState } from 'react'
+import { orpc } from '@/client/orpc'
+
+export const Route = createFileRoute('/')({
+  component: Todos,
+  loader: async ({ context }) => {
+    await context.queryClient.ensureQueryData(orpc.todo.list.queryOptions())
+  },
+})
+
+function Todos() {
+  const [newTodoTitle, setNewTodoTitle] = useState('')
+
+  const listQuery = useSuspenseQuery(orpc.todo.list.queryOptions())
+  const createMutation = useMutation(orpc.todo.create.mutationOptions())
+  const updateMutation = useMutation(orpc.todo.update.mutationOptions())
+  const deleteMutation = useMutation(orpc.todo.remove.mutationOptions())
+
+  const handleCreateTodo: SubmitEventHandler<HTMLFormElement> = (e) => {
+    e.preventDefault()
+    if (newTodoTitle.trim()) {
+      createMutation.mutate({ title: newTodoTitle.trim() })
+      setNewTodoTitle('')
+    }
+  }
+
+  const handleInputChange: ChangeEventHandler<HTMLInputElement> = (e) => {
+    setNewTodoTitle(e.target.value)
+  }
+
+  const handleToggleTodo = (id: string, currentCompleted: boolean) => {
+    updateMutation.mutate({
+      id,
+      data: { completed: !currentCompleted },
+    })
+  }
+
+  const handleDeleteTodo = (id: string) => {
+    deleteMutation.mutate({ id })
+  }
+
+  const todos = listQuery.data
+  const completedCount = todos.filter((todo) => todo.completed).length
+  const totalCount = todos.length
+  const progress = totalCount > 0 ? (completedCount / totalCount) * 100 : 0
+
+  return (
+    <div className="min-h-screen bg-slate-50 py-12 px-4 sm:px-6 font-sans">
+      <div className="max-w-2xl mx-auto space-y-8">
+        {/* Header */}
+        <div className="flex items-end justify-between">
+          <div>
+            <h1 className="text-3xl font-bold text-slate-900 tracking-tight">我的待办</h1>
+            <p className="text-slate-500 mt-1">保持专注，逐个击破</p>
+          </div>
+          <div className="text-right">
+            <div className="text-2xl font-semibold text-slate-900">
+              {completedCount}
+              <span className="text-slate-400 text-lg">/{totalCount}</span>
+            </div>
+            <div className="text-xs font-medium text-slate-400 uppercase tracking-wider">已完成</div>
+          </div>
+        </div>
+
+        {/* Add Todo Form */}
+        <form onSubmit={handleCreateTodo} className="relative group z-10">
+          <div className="relative transform transition-all duration-200 focus-within:-translate-y-1">
+            <input
+              type="text"
+              value={newTodoTitle}
+              onChange={handleInputChange}
+              placeholder="添加新任务..."
+              className="w-full pl-6 pr-32 py-5 bg-white rounded-2xl shadow-[0_8px_30px_rgb(0,0,0,0.04)] border-0 ring-1 ring-slate-100 focus:ring-2 focus:ring-indigo-500/50 outline-none transition-all placeholder:text-slate-400 text-lg text-slate-700"
+              disabled={createMutation.isPending}
+            />
+            <button
+              type="submit"
+              disabled={createMutation.isPending || !newTodoTitle.trim()}
+              className="absolute right-3 top-3 bottom-3 px-6 bg-indigo-600 hover:bg-indigo-700 text-white rounded-xl font-medium transition-all shadow-md shadow-indigo-200 disabled:opacity-50 disabled:shadow-none hover:shadow-lg hover:shadow-indigo-300 active:scale-95"
+            >
+              {createMutation.isPending ? '添加中' : '添加'}
+            </button>
+          </div>
+        </form>
+
+        {/* Progress Bar (Only visible when there are tasks) */}
+        {totalCount > 0 && (
+          <div className="h-1.5 w-full bg-slate-200 rounded-full overflow-hidden">
+            <div
+              className="h-full bg-indigo-500 transition-all duration-500 ease-out rounded-full"
+              style={{ width: `${progress}%` }}
+            />
+          </div>
+        )}
+
+        {/* Todo List */}
+        <div className="space-y-3">
+          {todos.length === 0 ? (
+            <div className="py-20 text-center">
+              <div className="inline-flex items-center justify-center w-16 h-16 rounded-full bg-slate-100 mb-4">
+                <svg
+                  className="w-8 h-8 text-slate-400"
+                  fill="none"
+                  viewBox="0 0 24 24"
+                  stroke="currentColor"
+                  aria-hidden="true"
+                >
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
+                </svg>
+              </div>
+              <p className="text-slate-500 text-lg font-medium">没有待办事项</p>
+              <p className="text-slate-400 text-sm mt-1">输入上方内容添加您的第一个任务</p>
+            </div>
+          ) : (
+            todos.map((todo) => (
+              <div
+                key={todo.id}
+                className={`group relative flex items-center p-4 bg-white rounded-xl border border-slate-100 shadow-sm transition-all duration-200 hover:shadow-md hover:border-slate-200 ${
+                  todo.completed ? 'bg-slate-50/50' : ''
+                }`}
+              >
+                <button
+                  type="button"
+                  onClick={() => handleToggleTodo(todo.id, todo.completed)}
+                  className={`flex-shrink-0 w-6 h-6 rounded-full border-2 transition-all duration-200 flex items-center justify-center mr-4 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500 ${
+                    todo.completed
+                      ? 'bg-indigo-500 border-indigo-500'
+                      : 'border-slate-300 hover:border-indigo-500 bg-white'
+                  }`}
+                >
+                  {todo.completed && (
+                    <svg
+                      className="w-3.5 h-3.5 text-white"
+                      fill="none"
+                      viewBox="0 0 24 24"
+                      stroke="currentColor"
+                      strokeWidth={3}
+                      aria-hidden="true"
+                    >
+                      <path strokeLinecap="round" strokeLinejoin="round" d="M5 13l4 4L19 7" />
+                    </svg>
+                  )}
+                </button>
+
+                <div className="flex-1 min-w-0">
+                  <p
+                    className={`text-lg transition-all duration-200 truncate ${
+                      todo.completed
+                        ? 'text-slate-400 line-through decoration-slate-300 decoration-2'
+                        : 'text-slate-700'
+                    }`}
+                  >
+                    {todo.title}
+                  </p>
+                </div>
+
+                <div className="flex items-center opacity-0 group-hover:opacity-100 transition-opacity duration-200 absolute right-4 pl-4 bg-gradient-to-l from-white via-white to-transparent sm:static sm:bg-none">
+                  <span className="text-xs text-slate-400 mr-3 hidden sm:inline-block">
+                    {new Date(todo.createdAt).toLocaleDateString('zh-CN')}
+                  </span>
+                  <button
+                    type="button"
+                    onClick={() => handleDeleteTodo(todo.id)}
+                    className="p-2 text-slate-400 hover:text-red-500 hover:bg-red-50 rounded-lg transition-colors focus:outline-none"
+                    title="删除"
+                  >
+                    <svg
+                      className="w-5 h-5"
+                      fill="none"
+                      viewBox="0 0 24 24"
+                      stroke="currentColor"
+                      strokeWidth={1.5}
+                      aria-hidden="true"
+                    >
+                      <path
+                        strokeLinecap="round"
+                        strokeLinejoin="round"
+                        d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"
+                      />
+                    </svg>
+                  </button>
+                </div>
+              </div>
+            ))
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}

apps/server/src/server/api/context.ts

@@ -0,0 +1,25 @@
+import type { DB } from '@/server/db'
+
+/**
+ * 基础 Context - 所有请求都包含的上下文
+ */
+export interface BaseContext {
+  headers: Headers
+}
+
+/**
+ * 数据库 Context - 通过 db middleware 扩展
+ */
+export interface DBContext extends BaseContext {
+  db: DB
+}
+
+/**
+ * 认证 Context - 通过 auth middleware 扩展（未来使用）
+ *
+ * @example
+ * export interface AuthContext extends DBContext {
+ *   userId: string
+ *   user: User
+ * }
+ */

apps/server/src/server/api/contracts/index.ts

@@ -1,7 +1,7 @@
-import * as battery from './battery.contract'
+import * as todo from './todo.contract'
 
 export const contract = {
-  battery,
+  todo,
 }
 
 export type Contract = typeof contract

apps/server/src/server/api/contracts/todo.contract.ts

@@ -0,0 +1,32 @@
+import { oc } from '@orpc/contract'
+import { createInsertSchema, createSelectSchema, createUpdateSchema } from 'drizzle-orm/zod'
+import { z } from 'zod'
+import { generatedFieldKeys } from '@/server/db/fields'
+import { todoTable } from '@/server/db/schema'
+
+const selectSchema = createSelectSchema(todoTable)
+
+const insertSchema = createInsertSchema(todoTable).omit(generatedFieldKeys)
+
+const updateSchema = createUpdateSchema(todoTable).omit(generatedFieldKeys)
+
+export const list = oc.input(z.void()).output(z.array(selectSchema))
+
+export const create = oc.input(insertSchema).output(selectSchema)
+
+export const update = oc
+  .input(
+    z.object({
+      id: z.uuid(),
+      data: updateSchema,
+    }),
+  )
+  .output(selectSchema)
+
+export const remove = oc
+  .input(
+    z.object({
+      id: z.uuid(),
+    }),
+  )
+  .output(z.void())

apps/server/src/server/api/interceptors.ts

@@ -1,19 +1,13 @@
 import { ORPCError, ValidationError } from '@orpc/server'
 import { z } from 'zod'
-import { getLogger } from '@/server/logger'
-
-const logger = getLogger(['api'])
 
 export const logError = (error: unknown) => {
-  logger.error('Unhandled error in ORPC handler', { error })
+  console.error(error)
 }
 
 export const handleValidationError = (error: unknown) => {
-  if (!(error instanceof ORPCError) || !(error.cause instanceof ValidationError)) return
+  if (error instanceof ORPCError && error.code === 'BAD_REQUEST' && error.cause instanceof ValidationError) {
-
+    // If you only use Zod you can safely cast to ZodIssue[] (per ORPC official docs)
-  if (error.code === 'BAD_REQUEST') {
-    // ORPC widens issues to the Standard Schema shape; contracts here are built from Zod.
-    // Rehydrate to reuse z.prettifyError / z.flattenError.
     const zodError = new z.ZodError(error.cause.issues as z.core.$ZodIssue[])
 
     throw new ORPCError('INPUT_VALIDATION_FAILED', {
@@ -24,7 +18,7 @@ export const handleValidationError = (error: unknown) => {
     })
   }
 
-  if (error.code === 'INTERNAL_SERVER_ERROR') {
+  if (error instanceof ORPCError && error.code === 'INTERNAL_SERVER_ERROR' && error.cause instanceof ValidationError) {
     throw new ORPCError('OUTPUT_VALIDATION_FAILED', {
       cause: error.cause,
     })

apps/server/src/server/api/middlewares/db.middleware.ts

@@ -0,0 +1,11 @@
+import { os } from '@/server/api/server'
+import { getDB } from '@/server/db'
+
+export const db = os.middleware(async ({ context, next }) => {
+  return next({
+    context: {
+      ...context,
+      db: getDB(),
+    },
+  })
+})

apps/server/src/server/api/middlewares/index.ts

@@ -0,0 +1 @@
+export * from './db.middleware'

apps/server/src/server/api/routers/index.ts

@@ -0,0 +1,6 @@
+import { os } from '../server'
+import * as todo from './todo.router'
+
+export const router = os.router({
+  todo,
+})

apps/server/src/server/api/routers/todo.router.ts

@@ -0,0 +1,40 @@
+import { ORPCError } from '@orpc/server'
+import { eq } from 'drizzle-orm'
+import { todoTable } from '@/server/db/schema'
+import { db } from '../middlewares'
+import { os } from '../server'
+
+export const list = os.todo.list.use(db).handler(async ({ context }) => {
+  const todos = await context.db.query.todoTable.findMany({
+    orderBy: { createdAt: 'desc' },
+  })
+  return todos
+})
+
+export const create = os.todo.create.use(db).handler(async ({ context, input }) => {
+  const [newTodo] = await context.db.insert(todoTable).values(input).returning()
+
+  if (!newTodo) {
+    throw new ORPCError('INTERNAL_SERVER_ERROR', { message: 'Failed to create todo' })
+  }
+
+  return newTodo
+})
+
+export const update = os.todo.update.use(db).handler(async ({ context, input }) => {
+  const [updatedTodo] = await context.db.update(todoTable).set(input.data).where(eq(todoTable.id, input.id)).returning()
+
+  if (!updatedTodo) {
+    throw new ORPCError('NOT_FOUND')
+  }
+
+  return updatedTodo
+})
+
+export const remove = os.todo.remove.use(db).handler(async ({ context, input }) => {
+  const [deleted] = await context.db.delete(todoTable).where(eq(todoTable.id, input.id)).returning({ id: todoTable.id })
+
+  if (!deleted) {
+    throw new ORPCError('NOT_FOUND')
+  }
+})

apps/server/src/server/api/types.ts

@@ -0,0 +1,6 @@
+import type { ContractRouterClient, InferContractRouterInputs, InferContractRouterOutputs } from '@orpc/contract'
+import type { Contract } from './contracts'
+
+export type RouterClient = ContractRouterClient<Contract>
+export type RouterInputs = InferContractRouterInputs<Contract>
+export type RouterOutputs = InferContractRouterOutputs<Contract>

apps/server/src/server/db/fields.ts

@@ -0,0 +1,55 @@
+import { sql } from 'drizzle-orm'
+import { timestamp, uuid } from 'drizzle-orm/pg-core'
+import { v7 as uuidv7 } from 'uuid'
+
+// id
+
+const id = (name: string) => uuid(name)
+export const pk = (name: string, strategy?: 'native' | 'extension') => {
+  switch (strategy) {
+    // PG 18+
+    case 'native':
+      return id(name).primaryKey().default(sql`uuidv7()`)
+
+    // PG 13+ with extension
+    case 'extension':
+      return id(name).primaryKey().default(sql`uuid_generate_v7()`)
+
+    // Any PG version
+    default:
+      return id(name)
+        .primaryKey()
+        .$defaultFn(() => uuidv7())
+  }
+}
+
+// timestamp
+
+export const createdAt = (name = 'created_at') => timestamp(name, { withTimezone: true }).notNull().defaultNow()
+
+export const updatedAt = (name = 'updated_at') =>
+  timestamp(name, { withTimezone: true })
+    .notNull()
+    .defaultNow()
+    .$onUpdateFn(() => new Date())
+
+// generated fields
+
+export const generatedFields = {
+  id: pk('id'),
+  createdAt: createdAt('created_at'),
+  updatedAt: updatedAt('updated_at'),
+}
+
+// Helper to create omit keys from generatedFields
+const createGeneratedFieldKeys = <T extends Record<string, unknown>>(fields: T): Record<keyof T, true> => {
+  return Object.keys(fields).reduce(
+    (acc, key) => {
+      acc[key as keyof T] = true
+      return acc
+    },
+    {} as Record<keyof T, true>,
+  )
+}
+
+export const generatedFieldKeys = createGeneratedFieldKeys(generatedFields)

apps/server/src/server/db/index.ts

@@ -0,0 +1,24 @@
+import { drizzle } from 'drizzle-orm/postgres-js'
+import { env } from '@/env'
+import { relations } from '@/server/db/relations'
+
+export const createDB = () =>
+  drizzle({
+    connection: env.DATABASE_URL,
+    relations,
+  })
+
+export type DB = ReturnType<typeof createDB>
+
+export const getDB = (() => {
+  let db: DB | null = null
+
+  return (singleton = true): DB => {
+    if (!singleton) {
+      return createDB()
+    }
+
+    db ??= createDB()
+    return db
+  }
+})()

apps/server/src/server/db/relations.ts

@@ -0,0 +1,4 @@
+import { defineRelations } from 'drizzle-orm'
+import * as schema from './schema'
+
+export const relations = defineRelations(schema, (_r) => ({}))

apps/server/src/server/db/schema/index.ts

@@ -0,0 +1 @@
+export * from './todo'

apps/server/src/server/db/schema/todo.ts

@@ -0,0 +1,8 @@
+import { boolean, pgTable, text } from 'drizzle-orm/pg-core'
+import { generatedFields } from '../fields'
+
+export const todoTable = pgTable('todo', {
+  ...generatedFields,
+  title: text('title').notNull(),
+  completed: boolean('completed').notNull().default(false),
+})

apps/server/src/styles.css

@@ -0,0 +1 @@
+@import "tailwindcss";

apps/server/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@furtherverse/tsconfig/react.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

apps/server/turbo.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "../../node_modules/turbo/schema.json",
+  "extends": ["//"],
+  "tasks": {
+    "build": {
+      "env": ["NODE_ENV", "VITE_*"],
+      "inputs": ["src/**", "public/**", "package.json", "tsconfig.json", "vite.config.ts"],
+      "outputs": [".output/**"]
+    },
+    "compile": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:darwin": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:darwin:arm64": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:darwin:x64": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:linux": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:linux:arm64": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:linux:x64": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:windows": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    },
+    "compile:windows:x64": {
+      "dependsOn": ["build"],
+      "outputs": ["out/**"]
+    }
+  }
+}

apps/server/vite.config.ts

@@ -11,14 +11,21 @@ export default defineConfig({
     tanstackDevtools(),
     tailwindcss(),
     tanstackStart(),
-    react(),
+    react({
+      babel: {
+        plugins: ['babel-plugin-react-compiler'],
+      },
+    }),
     nitro({
       preset: 'bun',
       serveStatic: 'inline',
-      plugins: ['./src/server/plugins/shutdown.ts'],
     }),
   ],
   resolve: {
     tsconfigPaths: true,
   },
+  server: {
+    port: 3000,
+    strictPort: true,
+  },
 })

biome.json

@@ -6,8 +6,7 @@
     "useIgnoreFile": true
   },
   "files": {
-    "ignoreUnknown": false,
+    "ignoreUnknown": false
-    "includes": ["**", "!**/routeTree.gen.ts", "!**/migrations.gen.ts", "!volumes"]
   },
   "formatter": {
     "enabled": true,
@@ -17,10 +16,6 @@
   },
   "linter": {
     "enabled": true,
-    "domains": {
-      "react": "recommended",
-      "types": "all"
-    },
     "rules": {
       "recommended": true,
       "complexity": {
@@ -28,14 +23,6 @@
       },
       "correctness": {
         "noReactPropAssignments": "error"
-      },
-      "style": {
-        "noNonNullAssertion": "error"
-      },
-      "suspicious": {
-        "noExplicitAny": "error",
-        "noImportCycles": "error",
-        "noTsIgnore": "error"
       }
     }
   },
@@ -46,11 +33,6 @@
       "arrowParentheses": "always"
     }
   },
-  "css": {
-    "parser": {
-      "tailwindDirectives": true
-    }
-  },
   "assist": {
     "enabled": true,
     "actions": {

bunfig.toml

@@ -0,0 +1,2 @@
+[install]
+publicHoistPattern = ["@types/*", "bun-types", "nitro*"]

compose.yaml

@@ -1,47 +0,0 @@
-services:
-  db:
-    image: mysql:8.4
-    ports:
-      - "3306:3306"
-    volumes:
-      - mysql_data:/var/lib/mysql
-    environment:
-      - MYSQL_ROOT_PASSWORD=root
-      - MYSQL_DATABASE=battery_soh
-      - MYSQL_USER=battery
-      - MYSQL_PASSWORD=battery
-    healthcheck:
-      test: [ "CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-ubattery", "-pbattery" ]
-      interval: 5s
-      timeout: 5s
-      retries: 20
-
-  seed:
-    build:
-      context: .
-      target: source
-    restart: "no"
-    depends_on:
-      db:
-        condition: service_healthy
-    environment:
-      - DATABASE_URL=mysql://battery:battery@db:3306/battery_soh
-      - SOH_PREDICTION_API_BASE_URL=http://host.docker.internal:8000
-    command: [ "bun", "run", "seed" ]
-
-  app:
-    build: .
-    depends_on:
-      seed:
-        condition: service_completed_successfully
-    extra_hosts:
-      - "host.docker.internal:host-gateway"
-    ports:
-      - "3000:3000"
-    environment:
-      - DATABASE_URL=mysql://battery:battery@db:3306/battery_soh
-      - SOH_PREDICTION_API_BASE_URL=http://host.docker.internal:8000
-      - ENABLE_API_DOCS=true
-
-volumes:
-  mysql_data:

mise.toml

@@ -1,2 +1,3 @@
 [tools]
-bun = "1.3.13"
+bun = "1"
+node = "24"

opencode.jsonc

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "shadcn": {
+      "type": "local",
+      "command": ["bunx", "--bun", "shadcn", "mcp"]
+    },
+    "tanstack": {
+      "type": "remote",
+      "url": "https://tanstack.com/api/mcp"
+    }
+  }
+}

package.json

@@ -1,71 +1,69 @@
 {
-  "name": "battery-soh",
+  "name": "@furtherverse/monorepo",
   "version": "1.0.0",
   "private": true,
   "type": "module",
-  "imports": {
+  "workspaces": [
-    "#package": "./package.json",
+    "apps/*",
-    "#server": "./.output/server/index.mjs"
+    "packages/*"
-  },
+  ],
   "scripts": {
-    "build": "bunx --bun vite build",
+    "build": "turbo run build",
-    "cli": "bun src/bin.ts",
+    "compile": "turbo run compile",
-    "compile": "bun scripts/compile.ts",
+    "compile:darwin": "turbo run compile:darwin",
-    "compile:darwin": "bun run compile:darwin:arm64 && bun run compile:darwin:x64",
+    "compile:linux": "turbo run compile:linux",
-    "compile:darwin:arm64": "bun scripts/compile.ts --target bun-darwin-arm64",
+    "compile:windows": "turbo run compile:windows",
-    "compile:darwin:x64": "bun scripts/compile.ts --target bun-darwin-x64",
+    "dev": "turbo run dev",
-    "compile:linux": "bun run compile:linux:x64 && bun run compile:linux:arm64",
+    "dist": "turbo run dist",
-    "compile:linux:arm64": "bun scripts/compile.ts --target bun-linux-arm64",
+    "dist:linux": "turbo run dist:linux",
-    "compile:linux:x64": "bun scripts/compile.ts --target bun-linux-x64",
+    "dist:mac": "turbo run dist:mac",
-    "compile:windows": "bun run compile:windows:x64",
+    "dist:win": "turbo run dist:win",
-    "compile:windows:x64": "bun scripts/compile.ts --target bun-windows-x64",
+    "fix": "turbo run fix",
-    "dev": "bunx --bun vite dev",
+    "typecheck": "turbo run typecheck"
-    "fix": "biome check --write",
-    "seed": "bun scripts/seed.ts",
-    "test": "bun test",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@logtape/logtape": "^2.0.5",
-    "@logtape/pretty": "^2.0.5",
-    "@orpc/client": "^1.14.0",
-    "@orpc/contract": "^1.14.0",
-    "@orpc/openapi": "^1.14.0",
-    "@orpc/server": "^1.14.0",
-    "@orpc/tanstack-query": "^1.14.0",
-    "@orpc/zod": "^1.14.0",
-    "@radix-ui/react-select": "^2.2.6",
-    "@t3-oss/env-core": "^0.13.11",
-    "@tanstack/react-query": "^5.100.1",
-    "@tanstack/react-router": "^1.168.24",
-    "@tanstack/react-router-ssr-query": "^1.166.11",
-    "@tanstack/react-start": "^1.167.48",
-    "@tanstack/react-table": "^8.21.3",
-    "@tanstack/react-virtual": "^3.13.24",
-    "citty": "^0.2.2",
-    "lru-cache": "^11.3.6",
-    "lucide-react": "^1.14.0",
-    "motion": "^12.38.0",
-    "mysql2": "^3.22.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "recharts": "^3.8.1",
-    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.13",
+    "@biomejs/biome": "^2.4.8",
-    "@tailwindcss/vite": "^4.2.4",
+    "turbo": "^2.8.20",
-    "@tanstack/devtools-vite": "^0.6.0",
+    "typescript": "^5.9.3"
-    "@tanstack/react-devtools": "^0.10.2",
+  },
-    "@tanstack/react-query-devtools": "^5.100.1",
+  "catalog": {
-    "@tanstack/react-router-devtools": "^1.166.13",
+    "@orpc/client": "^1.13.9",
-    "@types/bun": "^1.3.13",
+    "@orpc/contract": "^1.13.9",
-    "@vitejs/plugin-react": "^6.0.1",
+    "@orpc/openapi": "^1.13.9",
-    "drizzle-orm": "^0.45.2",
+    "@orpc/server": "^1.13.9",
-    "drizzle-seed": "^0.3.1",
+    "@orpc/tanstack-query": "^1.13.9",
-    "nitro": "npm:nitro-nightly@3.0.1-20260424-182106-f8cf6ccc",
+    "@orpc/zod": "^1.13.9",
-    "tailwindcss": "^4.2.4",
+    "@t3-oss/env-core": "^0.13.10",
-    "typescript": "^6.0.3",
+    "@tailwindcss/vite": "^4.2.2",
-    "vite": "^8.0.10"
+    "@tanstack/devtools-vite": "^0.5.5",
+    "@tanstack/react-devtools": "^0.9.13",
+    "@tanstack/react-query": "^5.94.4",
+    "@tanstack/react-query-devtools": "^5.94.4",
+    "@tanstack/react-router": "^1.168.1",
+    "@tanstack/react-router-devtools": "^1.166.10",
+    "@tanstack/react-router-ssr-query": "^1.166.10",
+    "@tanstack/react-start": "^1.167.2",
+    "@types/bun": "^1.3.11",
+    "@types/node": "^24.12.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "drizzle-kit": "1.0.0-beta.15-859cf75",
+    "drizzle-orm": "1.0.0-beta.15-859cf75",
+    "electron": "^34.0.0",
+    "electron-builder": "^26.8.1",
+    "electron-vite": "^5.0.0",
+    "motion": "^12.38.0",
+    "nitro": "npm:nitro-nightly@3.0.1-20260320-182900-2218d454",
+    "postgres": "^3.4.8",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tailwindcss": "^4.2.2",
+    "tree-kill": "^1.2.2",
+    "uuid": "^13.0.0",
+    "vite": "^8.0.1",
+    "zod": "^4.3.6"
+  },
+  "overrides": {
+    "@types/node": "catalog:"
   }
 }

packages/tsconfig/base.json

@@ -1,8 +1,9 @@
 {
   "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
   "compilerOptions": {
     "target": "esnext",
-    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "lib": ["ESNext"],
     "module": "preserve",
     "skipLibCheck": true,
 
@@ -19,14 +20,7 @@
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true,
     "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
+    "noImplicitOverride": true
-
-    "jsx": "react-jsx",
-    "types": ["bun"],
-
-    "paths": {
-      "@/*": ["./src/*"]
-    }
   },
-  "exclude": ["node_modules", ".output", "out"]
+  "exclude": ["node_modules"]
 }

packages/tsconfig/bun.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Bun",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "types": ["bun-types"]
+  }
+}

packages/tsconfig/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@furtherverse/tsconfig",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    "./base.json": "./base.json",
+    "./bun.json": "./bun.json",
+    "./react.json": "./react.json"
+  }
+}

packages/tsconfig/react.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "React",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx"
+  }
+}

public/robots.txt

@@ -1,2 +0,0 @@
-User-agent: *
-Disallow:

scripts/seed.ts

@@ -1,138 +0,0 @@
-import { datetime, index, int, mysqlTable, tinyint, varchar } from 'drizzle-orm/mysql-core'
-import { drizzle } from 'drizzle-orm/mysql2'
-import { reset } from 'drizzle-seed'
-import mysql from 'mysql2/promise'
-import { type MYSQL_BOOLEAN, POWER_STATUS, type PowerStatus, toMysqlBoolean } from '@/domain/battery'
-
-type SeedRow = {
-  userId: number
-  mac: string
-  devModel: string
-  devName: string
-  isLowPower: (typeof MYSQL_BOOLEAN)[keyof typeof MYSQL_BOOLEAN]
-  powerStatus: PowerStatus
-  power: number
-  createTime: Date
-  remark: string | null
-}
-
-const lsBatteryInfo = mysqlTable(
-  'ls_battery_info',
-  {
-    id: int('id').autoincrement().primaryKey(),
-    userId: int('user_id').notNull(),
-    mac: varchar('mac', { length: 50 }).notNull(),
-    devModel: varchar('dev_model', { length: 20 }).notNull(),
-    devName: varchar('dev_name', { length: 50 }).notNull(),
-    isLowPower: varchar('is_low_power', { length: 10 }).notNull(),
-    powerStatus: tinyint('power_status').notNull(),
-    power: tinyint('power').notNull(),
-    createTime: datetime('create_time').notNull(),
-    remark: varchar('remark', { length: 500 }),
-  },
-  (table) => [index('idx_ls_battery_info_mac_time_id').on(table.mac, table.createTime, table.id)],
-)
-
-const databaseUrl = process.env.DATABASE_URL
-
-if (!databaseUrl) {
-  throw new Error('DATABASE_URL is required, for example mysql://battery:battery@localhost:3306/battery_soh')
-}
-
-const parsedUrl = new URL(databaseUrl)
-const safeSeedHosts = new Set(['localhost', '127.0.0.1', '0.0.0.0', 'db', 'mysql'])
-
-if (!safeSeedHosts.has(parsedUrl.hostname) && process.env.SEED_ALLOW_REMOTE !== 'true') {
-  throw new Error(
-    `Refusing to seed non-local MySQL host "${parsedUrl.hostname}". Set SEED_ALLOW_REMOTE=true only for disposable test databases.`,
-  )
-}
-
-const devices = [
-  { mac: 'RING-A03', model: 'SR-01', name: '样机-A03', basePower: 96, status: POWER_STATUS.FULL, remark: 'v3.8.2' },
-  { mac: 'RING-B11', model: 'SR-01', name: '样机-B11', basePower: 91, status: POWER_STATUS.CHARGING, remark: 'v3.8.2' },
-  {
-    mac: 'RING-C07',
-    model: 'SR-02',
-    name: '样机-C07',
-    basePower: 88,
-    status: POWER_STATUS.NOT_CHARGING,
-    remark: 'v3.8.1',
-  },
-  {
-    mac: 'RING-D19',
-    model: 'SR-02',
-    name: '样机-D19',
-    basePower: 84,
-    status: POWER_STATUS.NOT_CHARGING,
-    remark: 'v3.7.9',
-  },
-  { mac: 'RING-E21', model: 'SR-03', name: '样机-E21', basePower: 79, status: POWER_STATUS.CHARGING, remark: 'v3.7.9' },
-  { mac: 'RING-F02', model: 'SR-03', name: '样机-F02', basePower: 73, status: POWER_STATUS.NOT_CHARGING, remark: null },
-  { mac: 'RING-G15', model: 'SR-04', name: '样机-G15', basePower: 93, status: POWER_STATUS.FULL, remark: 'v3.9.0' },
-  {
-    mac: 'RING-H09',
-    model: 'SR-04',
-    name: '样机-H09',
-    basePower: 86,
-    status: POWER_STATUS.NOT_CHARGING,
-    remark: 'v3.8.1',
-  },
-] satisfies Array<{
-  mac: string
-  model: string
-  name: string
-  basePower: number
-  status: PowerStatus
-  remark: string | null
-}>
-
-function createSeedRows(now = new Date()): SeedRow[] {
-  return devices.flatMap((device, deviceIndex) =>
-    Array.from({ length: 8 }, (_, historyIndex) => {
-      const createdAt = new Date(now.getTime() - (historyIndex * 24 + deviceIndex * 2) * 60 * 60 * 1000)
-      const power = Math.max(1, Math.min(100, device.basePower - historyIndex * 2 + (deviceIndex % 3)))
-
-      return {
-        userId: 1001 + (deviceIndex % 3),
-        mac: device.mac,
-        devModel: device.model,
-        devName: device.name,
-        isLowPower: toMysqlBoolean(power <= 20 || device.basePower <= 80),
-        powerStatus: historyIndex === 0 ? device.status : POWER_STATUS.NOT_CHARGING,
-        power,
-        createTime: createdAt,
-        remark: device.remark,
-      }
-    }),
-  )
-}
-
-const connection = await mysql.createConnection({ uri: databaseUrl })
-const db = drizzle(connection)
-
-try {
-  await db.execute(`
-    CREATE TABLE IF NOT EXISTS ls_battery_info (
-      id int(11) NOT NULL AUTO_INCREMENT,
-      user_id int(11) NOT NULL,
-      mac varchar(50) NOT NULL,
-      dev_model varchar(20) NOT NULL,
-      dev_name varchar(50) NOT NULL,
-      is_low_power varchar(10) NOT NULL,
-      power_status tinyint(4) NOT NULL,
-      power tinyint(4) NOT NULL,
-      create_time datetime NOT NULL,
-      remark varchar(500) DEFAULT NULL,
-      PRIMARY KEY (id),
-      KEY idx_ls_battery_info_mac_time_id (mac, create_time, id)
-    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
-  `)
-
-  await reset(db, { lsBatteryInfo })
-  await db.insert(lsBatteryInfo).values(createSeedRows())
-
-  process.stdout.write(`Seeded ${devices.length} devices into ls_battery_info.\n`)
-} finally {
-  await connection.end()
-}

src/bin.ts

@@ -1,20 +0,0 @@
-import { defineCommand, runMain } from 'citty'
-import { name, version } from '#package'
-
-// IMPORTANT: keep this file's static imports minimal. Nitro's bun preset
-// emits `.output/server/index.mjs` with a top-level `serve(...)` call, so any
-// eager (transitive) import of it would start the HTTP server even for
-// `--help`. All subcommands are lazy-loaded via citty.
-const main = defineCommand({
-  meta: {
-    name,
-    version,
-    description: 'Fullstack server binary (default subcommand: serve)',
-  },
-  default: 'serve',
-  subCommands: {
-    serve: () => import('@/cli/serve').then((m) => m.default),
-  },
-})
-
-runMain(main)

src/cli/_serve-nitro.d.mts

@@ -1 +0,0 @@
-export default function startNitroServer(): Promise<void>

src/cli/_serve-nitro.mjs

@@ -1,3 +0,0 @@
-export default async function startNitroServer() {
-  await import('#server')
-}

src/cli/serve.ts

@@ -1,12 +0,0 @@
-import { defineCommand } from 'citty'
-
-export default defineCommand({
-  meta: {
-    name: 'serve',
-    description: 'Start the HTTP server',
-  },
-  async run() {
-    const { default: startNitroServer } = await import('./_serve-nitro.mjs')
-    await startNitroServer()
-  },
-})

src/components/Error.tsx

@@ -1,40 +0,0 @@
-export const ErrorComponent = ({ error, reset }: { error: Error; reset: () => void }) => {
-  return (
-    <div className="min-h-screen flex items-center justify-center bg-slate-50 px-4">
-      <div className="max-w-md w-full text-center space-y-6">
-        <div className="inline-flex items-center justify-center w-16 h-16 rounded-full bg-red-100">
-          <svg
-            className="w-8 h-8 text-red-500"
-            fill="none"
-            viewBox="0 0 24 24"
-            stroke="currentColor"
-            strokeWidth={1.5}
-            aria-hidden="true"
-          >
-            <path
-              strokeLinecap="round"
-              strokeLinejoin="round"
-              d="M12 9v3.75m9-.75a9 9 0 11-18 0 9 9 0 0118 0zm-9 3.75h.008v.008H12v-.008z"
-            />
-          </svg>
-        </div>
-        <div>
-          <h1 className="text-2xl font-bold text-slate-900">出错了</h1>
-          <p className="text-slate-500 mt-2">{import.meta.env.DEV ? error.message : '请求失败，请稍后重试'}</p>
-        </div>
-        <div className="flex items-center justify-center gap-4">
-          <button
-            type="button"
-            onClick={reset}
-            className="px-6 py-2.5 bg-indigo-600 hover:bg-indigo-700 text-white rounded-xl font-medium transition-colors"
-          >
-            重试
-          </button>
-          <a href="/" className="px-6 py-2.5 text-slate-600 hover:text-slate-900 font-medium transition-colors">
-            返回首页
-          </a>
-        </div>
-      </div>
-    </div>
-  )
-}

src/components/NotFound.tsx

@@ -1,23 +0,0 @@
-import { Link } from '@tanstack/react-router'
-
-export const NotFoundComponent = () => {
-  return (
-    <div className="min-h-screen flex items-center justify-center bg-slate-50 px-4">
-      <div className="max-w-md w-full text-center space-y-6">
-        <div className="inline-flex items-center justify-center w-16 h-16 rounded-full bg-slate-100">
-          <span className="text-3xl font-bold text-slate-400">404</span>
-        </div>
-        <div>
-          <h1 className="text-2xl font-bold text-slate-900">页面不存在</h1>
-          <p className="text-slate-500 mt-2">您访问的页面可能已被移除或地址有误</p>
-        </div>
-        <Link
-          to="/"
-          className="inline-block px-6 py-2.5 bg-indigo-600 hover:bg-indigo-700 text-white rounded-xl font-medium transition-colors"
-        >
-          返回首页
-        </Link>
-      </div>
-    </div>
-  )
-}

src/components/motion.tsx

@@ -1,128 +0,0 @@
-import { motion, useReducedMotion } from 'motion/react'
-import type { ComponentPropsWithoutRef, ReactNode } from 'react'
-
-export function useMotionConfig() {
-  const shouldReduceMotion = useReducedMotion()
-  return { shouldReduceMotion }
-}
-
-export function MotionHeader({
-  children,
-  delay = 0,
-  className,
-  ...props
-}: { children: ReactNode; delay?: number } & ComponentPropsWithoutRef<typeof motion.header>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.header
-      initial={shouldReduceMotion ? false : { opacity: 0, y: 10 }}
-      animate={{ opacity: 1, y: 0 }}
-      transition={{ duration: 0.5, delay, ease: [0.25, 0.1, 0.25, 1] }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.header>
-  )
-}
-
-export function MotionSection({
-  children,
-  delay = 0,
-  className,
-  ...props
-}: { children: ReactNode; delay?: number } & ComponentPropsWithoutRef<typeof motion.section>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.section
-      initial={shouldReduceMotion ? false : { opacity: 0, y: 10 }}
-      animate={{ opacity: 1, y: 0 }}
-      transition={{ duration: 0.5, delay, ease: [0.25, 0.1, 0.25, 1] }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.section>
-  )
-}
-
-export function MotionDiv({
-  children,
-  delay = 0,
-  className,
-  ...props
-}: { children: ReactNode; delay?: number } & ComponentPropsWithoutRef<typeof motion.div>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.div
-      initial={shouldReduceMotion ? false : { opacity: 0, y: 10 }}
-      animate={{ opacity: 1, y: 0 }}
-      transition={{ duration: 0.5, delay, ease: [0.25, 0.1, 0.25, 1] }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.div>
-  )
-}
-
-export function MotionCardArticle({
-  children,
-  className,
-  ...props
-}: { children: ReactNode } & ComponentPropsWithoutRef<typeof motion.article>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.article
-      whileHover={shouldReduceMotion ? {} : { y: -2 }}
-      transition={{ duration: 0.2, ease: 'easeOut' }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.article>
-  )
-}
-
-export function MotionCardDiv({
-  children,
-  className,
-  ...props
-}: { children: ReactNode } & ComponentPropsWithoutRef<typeof motion.div>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.div
-      whileHover={shouldReduceMotion ? {} : { y: -2 }}
-      transition={{ duration: 0.2, ease: 'easeOut' }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.div>
-  )
-}
-
-export function MotionTableRow({
-  children,
-  className,
-  ...props
-}: { children: ReactNode } & ComponentPropsWithoutRef<typeof motion.tr>) {
-  const { shouldReduceMotion } = useMotionConfig()
-
-  return (
-    <motion.tr
-      initial={shouldReduceMotion ? false : { opacity: 0 }}
-      animate={{ opacity: 1 }}
-      transition={{ duration: 0.3 }}
-      className={className}
-      {...props}
-    >
-      {children}
-    </motion.tr>
-  )
-}

src/components/ui.tsx

@@ -1,181 +0,0 @@
-import * as RadixSelect from '@radix-ui/react-select'
-import { Check, ChevronDown } from 'lucide-react'
-import type { ComponentPropsWithoutRef, ReactNode } from 'react'
-
-type Variant = 'default' | 'muted' | 'success' | 'warning' | 'danger' | 'info'
-
-function cn(...classes: Array<string | false | null | undefined>) {
-  return classes.filter(Boolean).join(' ')
-}
-
-const variantClass: Record<Variant, string> = {
-  default: 'border-white/10 bg-white/[0.04] text-zinc-100',
-  muted: 'border-white/10 bg-zinc-900/70 text-zinc-400',
-  success: 'border-emerald-400/20 bg-emerald-400/10 text-emerald-300',
-  warning: 'border-amber-400/20 bg-amber-400/10 text-amber-300',
-  danger: 'border-red-400/20 bg-red-400/10 text-red-300',
-  info: 'border-teal-400/20 bg-teal-400/10 text-teal-300',
-}
-
-export function Badge({
-  className,
-  variant = 'default',
-  children,
-  ...props
-}: ComponentPropsWithoutRef<'span'> & { variant?: Variant }) {
-  return (
-    <span
-      className={cn(
-        'inline-flex items-center gap-1.5 rounded-full border px-2.5 py-1 text-xs font-medium leading-none',
-        variantClass[variant],
-        className,
-      )}
-      {...props}
-    >
-      {children}
-    </span>
-  )
-}
-
-export function Card({ className, children, ...props }: ComponentPropsWithoutRef<'div'>) {
-  return (
-    <div
-      className={cn('rounded-2xl border border-white/[0.08] bg-zinc-950/60 shadow-2xl shadow-black/20', className)}
-      {...props}
-    >
-      {children}
-    </div>
-  )
-}
-
-export function Button({ className, children, ...props }: ComponentPropsWithoutRef<'button'>) {
-  return (
-    <button
-      className={cn(
-        'inline-flex items-center justify-center gap-2 rounded-lg border border-white/10 bg-white/[0.05] px-4 py-2 text-sm font-medium text-zinc-100 transition-colors hover:border-white/20 hover:bg-white/[0.09] disabled:cursor-not-allowed disabled:opacity-35 disabled:hover:bg-white/[0.05]',
-        className,
-      )}
-      {...props}
-    >
-      {children}
-    </button>
-  )
-}
-
-export function Input({ className, ...props }: ComponentPropsWithoutRef<'input'>) {
-  return (
-    <input
-      className={cn(
-        'h-10 w-full rounded-lg border border-white/10 bg-zinc-950/80 px-3 py-2 text-sm text-zinc-100 placeholder:text-zinc-600 outline-none transition-colors focus:border-teal-400/60 focus:ring-2 focus:ring-teal-400/10',
-        className,
-      )}
-      {...props}
-    />
-  )
-}
-
-export function Select({
-  value,
-  onValueChange,
-  children,
-  className,
-  id,
-}: {
-  value?: string | number
-  onValueChange?: (value: string) => void
-  children: ReactNode
-  className?: string
-  id?: string
-}) {
-  return (
-    <RadixSelect.Root value={value?.toString()} onValueChange={onValueChange}>
-      <RadixSelect.Trigger
-        id={id}
-        className={cn(
-          'flex h-10 w-full items-center justify-between gap-2 rounded-lg border border-white/10 bg-zinc-950/95 px-3 py-2 text-sm text-zinc-100 outline-none transition-colors focus:border-teal-400/60 focus:ring-2 focus:ring-teal-400/10 data-[placeholder]:text-zinc-500',
-          className,
-        )}
-      >
-        <RadixSelect.Value />
-        <RadixSelect.Icon asChild>
-          <ChevronDown className="size-4 opacity-50" />
-        </RadixSelect.Icon>
-      </RadixSelect.Trigger>
-      <RadixSelect.Portal>
-        <RadixSelect.Content
-          className="relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-lg border border-white/10 bg-zinc-950 text-zinc-100 shadow-xl shadow-black/40"
-          position="popper"
-          sideOffset={4}
-        >
-          <RadixSelect.Viewport className="p-1">{children}</RadixSelect.Viewport>
-        </RadixSelect.Content>
-      </RadixSelect.Portal>
-    </RadixSelect.Root>
-  )
-}
-
-export function SelectOption({
-  value,
-  children,
-  className,
-}: {
-  value: string | number
-  children: ReactNode
-  className?: string
-}) {
-  return (
-    <RadixSelect.Item
-      value={value.toString()}
-      className={cn(
-        'relative flex w-full cursor-default select-none items-center rounded-md py-1.5 pl-8 pr-2 text-sm outline-none focus:bg-white/10 focus:text-zinc-50 data-[disabled]:pointer-events-none data-[disabled]:opacity-50',
-        className,
-      )}
-    >
-      <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
-        <RadixSelect.ItemIndicator>
-          <Check className="size-4" />
-        </RadixSelect.ItemIndicator>
-      </span>
-      <RadixSelect.ItemText>{children}</RadixSelect.ItemText>
-    </RadixSelect.Item>
-  )
-}
-
-export function SectionTitle({ icon, title, description }: { icon?: ReactNode; title: string; description?: string }) {
-  return (
-    <div className="flex items-start gap-3">
-      {icon && <div className="mt-0.5 rounded-lg border border-white/10 bg-white/[0.04] p-2 text-teal-300">{icon}</div>}
-      <div>
-        <h3 className="text-lg font-medium text-white">{title}</h3>
-        {description && <p className="mt-1 text-sm text-zinc-400">{description}</p>}
-      </div>
-    </div>
-  )
-}
-
-export function Skeleton({ className, ...props }: ComponentPropsWithoutRef<'div'>) {
-  return <div className={cn('rounded-md bg-white/5 motion-safe:animate-pulse', className)} {...props} />
-}
-
-export function EmptyState({
-  icon,
-  title,
-  description,
-  action,
-  className,
-}: {
-  icon?: ReactNode
-  title: string
-  description?: string
-  action?: ReactNode
-  className?: string
-}) {
-  return (
-    <div className={cn('flex flex-col items-center justify-center py-12 text-center', className)}>
-      {icon && <div className="mb-4 text-zinc-500">{icon}</div>}
-      <h3 className="text-sm font-medium text-zinc-200">{title}</h3>
-      {description && <p className="mt-1 text-sm text-zinc-500 max-w-sm">{description}</p>}
-      {action && <div className="mt-6">{action}</div>}
-    </div>
-  )
-}

src/domain/battery.constants.ts

@@ -1,63 +0,0 @@
-export const POWER_STATUS = {
-  NOT_CHARGING: 0,
-  CHARGING: 1,
-  FULL: 2,
-} as const
-
-export type PowerStatus = (typeof POWER_STATUS)[keyof typeof POWER_STATUS]
-
-export const POWER_STATUS_VALUES = [POWER_STATUS.NOT_CHARGING, POWER_STATUS.CHARGING, POWER_STATUS.FULL] as const
-
-export const BATTERY_LIST_SORT = {
-  CREATED_AT_DESC: 'createdAtDesc',
-  CREATED_AT_ASC: 'createdAtAsc',
-  POWER_DESC: 'powerDesc',
-  POWER_ASC: 'powerAsc',
-} as const
-
-export type BatteryListSort = (typeof BATTERY_LIST_SORT)[keyof typeof BATTERY_LIST_SORT]
-
-export const BATTERY_LIST_SORT_VALUES = [
-  BATTERY_LIST_SORT.CREATED_AT_DESC,
-  BATTERY_LIST_SORT.CREATED_AT_ASC,
-  BATTERY_LIST_SORT.POWER_DESC,
-  BATTERY_LIST_SORT.POWER_ASC,
-] as const
-
-export const MYSQL_BOOLEAN = {
-  TRUE: 'true',
-  FALSE: 'false',
-} as const
-
-export function toMysqlBoolean(value: boolean) {
-  return value ? MYSQL_BOOLEAN.TRUE : MYSQL_BOOLEAN.FALSE
-}
-
-export function fromMysqlBoolean(value: string | boolean) {
-  if (typeof value === 'boolean') return value
-  return value.trim().toLowerCase() === MYSQL_BOOLEAN.TRUE
-}
-
-export const DEVICE_STATUS = {
-  HEALTHY: '健康',
-  WATCH: '关注',
-  WARNING: '预警',
-} as const
-
-export type DeviceStatus = (typeof DEVICE_STATUS)[keyof typeof DEVICE_STATUS]
-
-export const EVENT_SEVERITY = {
-  HIGH: '高',
-  MEDIUM: '中',
-  LOW: '低',
-} as const
-
-export type EventSeverity = (typeof EVENT_SEVERITY)[keyof typeof EVENT_SEVERITY]
-
-export const SOH_THRESHOLDS = {
-  WARNING: 85,
-  WATCH: 90,
-  LOW_POWER: 20,
-  HIGH_RISK_SCORE: 70,
-  WATCH_RISK_SCORE: 40,
-} as const

src/domain/battery.test.ts

@@ -1,151 +0,0 @@
-import { describe, expect, test } from 'bun:test'
-import {
-  createBatteriesResponse,
-  createDashboardSnapshot,
-  DEVICE_STATUS,
-  fromMysqlBoolean,
-  getDeviceStatus,
-  MYSQL_BOOLEAN,
-  POWER_STATUS,
-  toBatteryInfo,
-} from './battery'
-
-const rows = [
-  {
-    id: 1,
-    userId: 7,
-    mac: 'RING-A03',
-    devModel: '2401-A',
-    devName: 'RING-A03',
-    isLowPower: MYSQL_BOOLEAN.FALSE,
-    powerStatus: POWER_STATUS.FULL,
-    power: 94,
-    createTime: new Date('2026-05-10T23:00:00.000Z'),
-    remark: 'v3.8.2',
-  },
-  {
-    id: 2,
-    userId: 7,
-    mac: 'RING-B11',
-    devModel: '2402-B',
-    devName: '',
-    isLowPower: MYSQL_BOOLEAN.TRUE,
-    powerStatus: POWER_STATUS.CHARGING,
-    power: 84,
-    createTime: '2026-05-10 22:00:00',
-    remark: null,
-  },
-]
-
-describe('battery domain', () => {
-  test('preserves legacy SOH status thresholds', () => {
-    expect(getDeviceStatus(91)).toBe(DEVICE_STATUS.HEALTHY)
-    expect(getDeviceStatus(90)).toBe(DEVICE_STATUS.WATCH)
-    expect(getDeviceStatus(85)).toBe(DEVICE_STATUS.WARNING)
-  })
-
-  test('trims MySQL boolean strings before normalization', () => {
-    expect(fromMysqlBoolean(' true ')).toBe(true)
-    expect(fromMysqlBoolean(' false ')).toBe(false)
-  })
-
-  test('builds batteries response counters from records', () => {
-    const now = new Date('2026-05-11T00:00:00.000Z')
-    const items = rows.map(toBatteryInfo)
-    const response = createBatteriesResponse(items, now)
-
-    expect(response.updatedAt).toBe('2026-05-11T00:00:00.000Z')
-    expect(response.total).toBe(items.length)
-    expect(response.lowPower).toBe(1)
-    expect(response.charging).toBe(1)
-    expect(response.nextCursor).toBeNull()
-    expect(response.items[0]?.createTime).toBe('2026-05-10T23:00:00.000Z')
-  })
-
-  test('keeps explicit window summaries for limited history slices', () => {
-    const now = new Date('2026-05-11T00:00:00.000Z')
-    const items = rows.map(toBatteryInfo)
-    const response = createBatteriesResponse(items, now, {
-      total: items.length,
-      lowPower: 1,
-      charging: 1,
-    })
-
-    expect(response.total).toBe(2)
-    expect(response.lowPower).toBe(1)
-    expect(response.charging).toBe(1)
-  })
-
-  test('creates dashboard aggregate shape without using power as fake SOH', () => {
-    const now = new Date('2026-05-11T00:00:00.000Z')
-    const snapshot = createDashboardSnapshot(rows.map(toBatteryInfo), now)
-
-    expect(snapshot.devices).toHaveLength(2)
-    expect(snapshot.devices[0]?.id).toBe('RING-A03')
-    expect(snapshot.devices[0]?.displayName).toBe('RING-A03')
-    expect(snapshot.devices[1]?.id).toBe('RING-B11')
-    expect(snapshot.devices[1]?.displayName).toBe('RING-B11')
-    expect(snapshot.devices.every((device) => device.sohSource === 'unavailable')).toBe(true)
-    expect(snapshot.devices.every((device) => device.soh === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.soh30d === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.soh90d === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.soh60d === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.cycles === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.temperature === null)).toBe(true)
-    expect(snapshot.devices.every((device) => device.chargeEfficiency === null)).toBe(true)
-    expect(snapshot.devices[0]?.firmware).toBe('v3.8.2')
-    expect(snapshot.devices[1]?.firmware).toBe('未提供')
-    expect(snapshot.soh.history).toHaveLength(0)
-    expect(snapshot.soh.forecast).toHaveLength(0)
-    expect(snapshot.summary.totalDevices).toBe(snapshot.devices.length)
-    expect(snapshot.summary.avgSoh).toBeNull()
-    expect(snapshot.summary.avgSoh30d).toBeNull()
-    expect(snapshot.summary.avgSoh90d).toBeNull()
-    expect(snapshot.summary.warningCount + snapshot.summary.watchCount + snapshot.summary.healthyCount).toBe(
-      snapshot.devices.length,
-    )
-  })
-
-  test('uses AI prediction values when available', () => {
-    const now = new Date('2026-05-11T00:00:00.000Z')
-    const items = rows.map(toBatteryInfo)
-    const snapshot = createDashboardSnapshot(
-      items,
-      now,
-      new Map([
-        [
-          'RING-A03',
-          {
-            mac: 'RING-A03',
-            nowSoh: 60,
-            monthSoh: 58,
-            trmonthSoh: 52,
-            riskScore: 40,
-            riskLevel: 'high',
-            status: '危险',
-            modelName: 'XGBoost',
-            cyclesUsed: 6,
-            updatedAt: '2026-05-11T00:00:00.000Z',
-          },
-        ],
-      ]),
-    )
-    const predicted = snapshot.devices.find((device) => device.id === 'RING-A03')
-
-    expect(predicted?.soh).toBe(60)
-    expect(predicted?.sohSource).toBe('prediction')
-    expect(predicted?.soh30d).toBe(58)
-    expect(predicted?.soh90d).toBe(52)
-    expect(predicted?.soh60d).toBeNull()
-    expect(predicted?.cycles).toBe(6)
-    expect(predicted?.firmware).toBe('v3.8.2')
-    expect(predicted?.status).toBe(DEVICE_STATUS.WARNING)
-    expect(predicted?.temperature).toBeNull()
-    expect(predicted?.chargeEfficiency).toBeNull()
-    expect(snapshot.soh.history).toHaveLength(0)
-    expect(snapshot.soh.forecast).toHaveLength(3)
-    expect(snapshot.soh.forecast[0]).toEqual({ month: '当前', value: 60 })
-    expect(snapshot.soh.forecast[1]).toEqual({ month: '30天', value: 58 })
-    expect(snapshot.soh.forecast[2]).toEqual({ month: '90天', value: 52 })
-  })
-})

src/domain/battery.ts

@@ -1,475 +0,0 @@
-import { z } from 'zod'
-import {
-  DEVICE_STATUS,
-  type DeviceStatus,
-  EVENT_SEVERITY,
-  fromMysqlBoolean,
-  POWER_STATUS,
-  type PowerStatus,
-  SOH_THRESHOLDS,
-} from './battery.constants'
-
-export {
-  BATTERY_LIST_SORT,
-  BATTERY_LIST_SORT_VALUES,
-  type BatteryListSort,
-  DEVICE_STATUS,
-  type DeviceStatus,
-  EVENT_SEVERITY,
-  type EventSeverity,
-  fromMysqlBoolean,
-  MYSQL_BOOLEAN,
-  POWER_STATUS,
-  POWER_STATUS_VALUES,
-  type PowerStatus,
-  SOH_THRESHOLDS,
-  toMysqlBoolean,
-} from './battery.constants'
-
-export const powerStatusSchema = z.union([
-  z.literal(POWER_STATUS.NOT_CHARGING),
-  z.literal(POWER_STATUS.CHARGING),
-  z.literal(POWER_STATUS.FULL),
-])
-
-export const deviceStatusSchema = z.union([
-  z.literal(DEVICE_STATUS.HEALTHY),
-  z.literal(DEVICE_STATUS.WATCH),
-  z.literal(DEVICE_STATUS.WARNING),
-])
-
-export const batteryInfoSchema = z.object({
-  id: z.number().int(),
-  userId: z.number().int(),
-  mac: z.string(),
-  devModel: z.string(),
-  devName: z.string(),
-  isLowPower: z.boolean(),
-  powerStatus: powerStatusSchema,
-  power: z.number().int().min(0).max(100),
-  createTime: z.string(),
-  remark: z.string().nullable(),
-})
-export type BatteryInfo = z.infer<typeof batteryInfoSchema>
-
-export const fleetUnitSchema = z.object({
-  id: z.string(),
-  displayName: z.string(),
-  batch: z.string(),
-  firmware: z.string(),
-  cycles: z.number().int().nullable(),
-  soh: z.number().nullable(),
-  sohSource: z.union([z.literal('prediction'), z.literal('unavailable')]),
-  soh30d: z.number().nullable(),
-  soh60d: z.number().nullable(),
-  soh90d: z.number().nullable(),
-  temperature: z.number().nullable(),
-  riskScore: z.number().int(),
-  chargeEfficiency: z.number().nullable(),
-  status: deviceStatusSchema,
-  riskFactors: z.array(z.string()),
-})
-export type FleetUnit = z.infer<typeof fleetUnitSchema>
-
-export const sohPointSchema = z.object({ month: z.string(), value: z.number() })
-export const sohResponseSchema = z.object({
-  history: z.array(sohPointSchema),
-  forecast: z.array(sohPointSchema),
-})
-
-export const eventItemSchema = z.object({
-  time: z.string(),
-  title: z.string(),
-  detail: z.string(),
-  severity: z.union([z.literal(EVENT_SEVERITY.HIGH), z.literal(EVENT_SEVERITY.MEDIUM), z.literal(EVENT_SEVERITY.LOW)]),
-})
-
-export const strategyItemSchema = z.object({
-  name: z.string(),
-  impact: z.string(),
-  scope: z.string(),
-  eta: z.string(),
-})
-
-export const summaryResponseSchema = z.object({
-  totalDevices: z.number().int(),
-  avgSoh: z.number().nullable(),
-  avgSoh30d: z.number().nullable(),
-  avgSoh90d: z.number().nullable(),
-  warningCount: z.number().int(),
-  watchCount: z.number().int(),
-  healthyCount: z.number().int(),
-  batchPerformance: z.array(z.object({ batch: z.string(), avgSoh: z.number().nullable() })),
-  riskFactorCounts: z.array(z.object({ factor: z.string(), count: z.number().int() })),
-  firmwareHealth: z.array(z.object({ firmware: z.string(), avgSoh: z.number().nullable(), count: z.number().int() })),
-  updatedAt: z.string(),
-  executiveSummary: z.string(),
-})
-
-export const dashboardSnapshotSchema = z.object({
-  devices: z.array(fleetUnitSchema),
-  soh: sohResponseSchema,
-  events: z.array(eventItemSchema),
-  strategies: z.array(strategyItemSchema),
-  summary: summaryResponseSchema,
-})
-export type DashboardSnapshot = z.infer<typeof dashboardSnapshotSchema>
-
-export const batteriesResponseSchema = z.object({
-  updatedAt: z.string(),
-  total: z.number().int(),
-  lowPower: z.number().int(),
-  charging: z.number().int(),
-  items: z.array(batteryInfoSchema),
-  nextCursor: z.string().nullable(),
-})
-export type BatteriesResponse = z.infer<typeof batteriesResponseSchema>
-
-export type BatteriesPageSummary = {
-  total?: number
-  lowPower?: number
-  charging?: number
-}
-
-export type BatteryPrediction = {
-  mac: string
-  nowSoh: number
-  monthSoh: number
-  trmonthSoh: number
-  riskScore: number | null
-  riskLevel: string | null
-  status: string | null
-  modelName: string | null
-  cyclesUsed: number | null
-  updatedAt: string | null
-}
-
-const round1 = (value: number) => Math.round(value * 10) / 10
-
-const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value))
-
-const pad2 = (value: number) => value.toString().padStart(2, '0')
-
-const formatDateTime = (date: Date) =>
-  `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`
-
-export function getDeviceStatus(soh: number): DeviceStatus {
-  if (soh <= SOH_THRESHOLDS.WARNING) return DEVICE_STATUS.WARNING
-  if (soh <= SOH_THRESHOLDS.WATCH) return DEVICE_STATUS.WATCH
-  return DEVICE_STATUS.HEALTHY
-}
-
-function getDeviceStatusByRisk(prediction: BatteryPrediction): DeviceStatus {
-  const riskText = `${prediction.riskLevel ?? ''} ${prediction.status ?? ''}`.toLowerCase()
-
-  if (
-    riskText.includes('high') ||
-    riskText.includes('danger') ||
-    riskText.includes('危险') ||
-    riskText.includes('高')
-  ) {
-    return DEVICE_STATUS.WARNING
-  }
-  if (
-    riskText.includes('medium') ||
-    riskText.includes('warning') ||
-    riskText.includes('关注') ||
-    riskText.includes('中')
-  ) {
-    return DEVICE_STATUS.WATCH
-  }
-
-  if (prediction.riskScore !== null) {
-    if (prediction.riskScore >= SOH_THRESHOLDS.HIGH_RISK_SCORE) return DEVICE_STATUS.WARNING
-    if (prediction.riskScore >= SOH_THRESHOLDS.WATCH_RISK_SCORE) return DEVICE_STATUS.WATCH
-  }
-
-  return getDeviceStatus(prediction.nowSoh)
-}
-
-export function normalizePowerStatus(value: number): PowerStatus {
-  if (value === POWER_STATUS.CHARGING || value === POWER_STATUS.FULL) return value
-  return POWER_STATUS.NOT_CHARGING
-}
-
-export function normalizeLowPower(value: string | boolean): boolean {
-  return fromMysqlBoolean(value)
-}
-
-export type BatteryInfoSourceRow = {
-  id: number
-  userId: number
-  mac: string
-  devModel: string
-  devName: string
-  isLowPower: string | boolean
-  powerStatus: number
-  power: number
-  createTime: Date | string
-  remark: string | null
-}
-
-export function toBatteryInfo(row: BatteryInfoSourceRow): BatteryInfo {
-  return {
-    id: row.id,
-    userId: row.userId,
-    mac: row.mac,
-    devModel: row.devModel,
-    devName: row.devName,
-    isLowPower: normalizeLowPower(row.isLowPower),
-    powerStatus: normalizePowerStatus(row.powerStatus),
-    power: row.power,
-    createTime: row.createTime instanceof Date ? row.createTime.toISOString() : String(row.createTime),
-    remark: row.remark,
-  }
-}
-
-export function createBatteriesResponse(
-  items: BatteryInfo[],
-  now = new Date(),
-  summary: BatteriesPageSummary = {},
-  nextCursor: string | null = null,
-): BatteriesResponse {
-  return {
-    updatedAt: now.toISOString(),
-    total: summary.total ?? items.length,
-    lowPower: summary.lowPower ?? items.filter((item) => item.isLowPower).length,
-    charging: summary.charging ?? items.filter((item) => item.powerStatus === POWER_STATUS.CHARGING).length,
-    items,
-    nextCursor,
-  }
-}
-
-function toFleetUnit(item: BatteryInfo, prediction?: BatteryPrediction): FleetUnit {
-  const hasPrediction = Boolean(prediction)
-  const soh = prediction ? round1(clamp(prediction.nowSoh, 0, 100)) : null
-  const status = prediction
-    ? getDeviceStatusByRisk(prediction)
-    : item.isLowPower || item.power <= SOH_THRESHOLDS.LOW_POWER
-      ? DEVICE_STATUS.WATCH
-      : DEVICE_STATUS.HEALTHY
-  const riskFactors: string[] = []
-
-  if (item.isLowPower || item.power <= SOH_THRESHOLDS.LOW_POWER) riskFactors.push('低电量')
-  if (item.powerStatus === POWER_STATUS.CHARGING) riskFactors.push('充电中')
-  if (!hasPrediction) riskFactors.push('健康预测不可用')
-  if (prediction && status === DEVICE_STATUS.WARNING) riskFactors.push('衰减加速')
-  if (item.remark?.includes('v3.7')) riskFactors.push('旧固件')
-  if (prediction?.riskLevel) riskFactors.push(`预测风险:${prediction.riskLevel}`)
-
-  const soh30d = prediction ? round1(clamp(prediction.monthSoh, 0, 100)) : null
-  const soh90d = prediction ? round1(clamp(prediction.trmonthSoh, 0, 100)) : null
-  const soh60d = null
-  const temperature = null
-  const chargeEfficiency = null
-  const fallbackRiskScore =
-    (item.isLowPower || item.power <= SOH_THRESHOLDS.LOW_POWER ? 60 : 0) +
-    (item.powerStatus === POWER_STATUS.CHARGING ? 20 : 0)
-  const riskScore = Math.round(clamp(prediction?.riskScore ?? fallbackRiskScore, 0, 100))
-
-  return {
-    id: item.mac,
-    displayName: item.devName || item.mac,
-    batch: item.devModel,
-    firmware: item.remark ?? '未提供',
-    cycles: prediction?.cyclesUsed ?? null,
-    soh,
-    sohSource: prediction ? 'prediction' : 'unavailable',
-    soh30d,
-    soh60d,
-    soh90d,
-    temperature,
-    riskScore,
-    chargeEfficiency,
-    status,
-    riskFactors,
-  }
-}
-
-function createSohResponse(devices: FleetUnit[]) {
-  const predictedDevices = devices.filter((unit) => unit.soh !== null)
-  if (predictedDevices.length === 0) return { history: [], forecast: [] }
-
-  const avgNow = averageNullable(predictedDevices.map((unit) => unit.soh))
-  const avgMonth = averageNullable(predictedDevices.map((unit) => unit.soh30d))
-  const avgTrmonth = averageNullable(predictedDevices.map((unit) => unit.soh90d))
-
-  const forecast = [
-    avgNow === null ? null : { month: '当前', value: round1(clamp(avgNow, 0, 100)) },
-    avgMonth === null ? null : { month: '30天', value: round1(clamp(avgMonth, 0, 100)) },
-    avgTrmonth === null ? null : { month: '90天', value: round1(clamp(avgTrmonth, 0, 100)) },
-  ].filter((point): point is { month: string; value: number } => point !== null)
-
-  return {
-    history: [],
-    forecast,
-  }
-}
-
-function summarizeBy<T extends string>(items: FleetUnit[], getKey: (item: FleetUnit) => T) {
-  return Object.entries(
-    items.reduce<Record<string, { sum: number; valueCount: number; count: number }>>((acc, item) => {
-      const key = getKey(item)
-      const entry = acc[key] ?? { sum: 0, valueCount: 0, count: 0 }
-      if (item.soh !== null) {
-        entry.sum += item.soh
-        entry.valueCount += 1
-      }
-      entry.count += 1
-      acc[key] = entry
-      return acc
-    }, {}),
-  )
-}
-
-function averageNullable(values: Array<number | null>) {
-  const available = values.filter((value) => value !== null)
-
-  if (available.length === 0) return null
-  return available.reduce((sum, value) => sum + value, 0) / available.length
-}
-
-function createSummary(devices: FleetUnit[], now: Date) {
-  const totalDevices = devices.length
-
-  if (totalDevices === 0) {
-    return {
-      totalDevices,
-      avgSoh: null,
-      avgSoh30d: null,
-      avgSoh90d: null,
-      warningCount: 0,
-      watchCount: 0,
-      healthyCount: 0,
-      batchPerformance: [],
-      riskFactorCounts: [],
-      firmwareHealth: [],
-      updatedAt: formatDateTime(now),
-      executiveSummary: '当前没有可用于电池健康分析的真实设备记录。',
-    }
-  }
-
-  const avgSoh = averageNullable(devices.map((unit) => unit.soh))
-  const avgSoh30d = averageNullable(devices.map((unit) => unit.soh30d))
-  const avgSoh90d = averageNullable(devices.map((unit) => unit.soh90d))
-  const warningCount = devices.filter((unit) => unit.status === DEVICE_STATUS.WARNING).length
-  const watchCount = devices.filter((unit) => unit.status === DEVICE_STATUS.WATCH).length
-  const healthyCount = devices.filter((unit) => unit.status === DEVICE_STATUS.HEALTHY).length
-  const batchPerformance = summarizeBy(devices, (unit) => unit.batch)
-    .map(([batch, data]) => ({ batch, avgSoh: data.valueCount > 0 ? round1(data.sum / data.valueCount) : null }))
-    .sort((a, b) => (b.avgSoh ?? -1) - (a.avgSoh ?? -1))
-  const firmwareHealth = summarizeBy(devices, (unit) => unit.firmware)
-    .map(([firmware, data]) => ({
-      firmware,
-      avgSoh: data.valueCount > 0 ? round1(data.sum / data.valueCount) : null,
-      count: data.count,
-    }))
-    .sort((a, b) => (b.avgSoh ?? -1) - (a.avgSoh ?? -1))
-  const riskFactorCounts = Object.entries(
-    devices.reduce<Record<string, number>>((acc, unit) => {
-      for (const factor of unit.riskFactors) {
-        acc[factor] = (acc[factor] ?? 0) + 1
-      }
-      return acc
-    }, {}),
-  )
-    .map(([factor, count]) => ({ factor, count }))
-    .sort((a, b) => b.count - a.count)
-  const weakestModel = batchPerformance.at(-1)?.batch ?? '当前设备型号'
-  const weakestRemark = firmwareHealth.at(-1)?.firmware ?? '未提供备注'
-  const predictedDevices = devices.filter((unit) => unit.soh !== null).length
-  const missingPredictionDevices = totalDevices - predictedDevices
-
-  return {
-    totalDevices,
-    avgSoh: avgSoh === null ? null : round1(avgSoh),
-    avgSoh30d: avgSoh30d === null ? null : round1(avgSoh30d),
-    avgSoh90d: avgSoh90d === null ? null : round1(avgSoh90d),
-    warningCount,
-    watchCount,
-    healthyCount,
-    batchPerformance,
-    riskFactorCounts,
-    firmwareHealth,
-    updatedAt: formatDateTime(now),
-    executiveSummary:
-      avgSoh === null
-        ? '当前健康预测暂不可用，系统仍会展示设备电量、充电状态与低电量风险。请稍后复查或联系管理员。'
-        : `当前共有 ${predictedDevices} 台设备具备健康预测，${missingPredictionDevices} 台设备暂无预测结果。建议重点关注 ${weakestModel} 型号与 ${weakestRemark} 备注设备，优先处理低电量和充电中的设备，并在下次同步后复查未来 30/90 天健康趋势。`,
-  }
-}
-
-function createEvents(devices: FleetUnit[], now: Date) {
-  if (devices.length === 0) return []
-
-  const predictedDevices = devices.filter((unit) => unit.soh !== null)
-  const warningDevices = devices.filter((unit) => unit.status === DEVICE_STATUS.WARNING)
-  const missingPredictionDevices = devices.length - predictedDevices.length
-
-  return [
-    {
-      time: formatDateTime(now),
-      title: '风险快照',
-      detail: `本次概览包含 ${devices.length} 台设备，其中 ${predictedDevices.length} 台具备健康预测，${warningDevices.length} 台处于预警状态。`,
-      severity: warningDevices.length > 0 ? EVENT_SEVERITY.HIGH : EVENT_SEVERITY.LOW,
-    },
-    {
-      time: formatDateTime(now),
-      title: '预测可用性快照',
-      detail:
-        missingPredictionDevices > 0
-          ? `当前有 ${missingPredictionDevices} 台设备暂无健康预测，相关趋势将暂不展示。`
-          : '当前所有设备均已具备健康预测，可继续观察趋势变化。',
-      severity: missingPredictionDevices > 0 ? EVENT_SEVERITY.MEDIUM : EVENT_SEVERITY.LOW,
-    },
-  ] satisfies DashboardSnapshot['events']
-}
-
-function createStrategies(devices: FleetUnit[]) {
-  if (devices.length === 0) return []
-
-  const warningDevices = devices.filter((unit) => unit.status === DEVICE_STATUS.WARNING)
-  const powerAttentionDevices = devices.filter(
-    (unit) => unit.riskFactors.includes('充电中') || unit.riskFactors.includes('低电量'),
-  )
-  const missingPredictionDevices = devices.filter((unit) => unit.soh === null)
-
-  return [
-    {
-      name: '优先处理预警设备',
-      impact: `当前有 ${warningDevices.length} 台设备处于预警状态，建议先复核供电、连接与预测结果。`,
-      scope: warningDevices.length > 0 ? `${warningDevices.length} 台预警设备` : '当前设备',
-      eta: '本次巡检周期内',
-    },
-    {
-      name: '提升预测覆盖',
-      impact:
-        missingPredictionDevices.length > 0
-          ? `当前有 ${missingPredictionDevices.length} 台设备暂无健康预测，建议在下次同步后复查。`
-          : `当前已有 ${devices.length} 台设备具备预测结果，可继续观察健康变化。`,
-      scope:
-        powerAttentionDevices.length > 0
-          ? `${powerAttentionDevices.length} 台充电中或低电量设备`
-          : missingPredictionDevices.length > 0
-            ? `${missingPredictionDevices.length} 台缺失预测设备`
-            : '当前设备',
-      eta: '下次同步后复查',
-    },
-  ] satisfies DashboardSnapshot['strategies']
-}
-
-export function createDashboardSnapshot(
-  items: BatteryInfo[],
-  now = new Date(),
-  predictions: ReadonlyMap<string, BatteryPrediction> = new Map(),
-): DashboardSnapshot {
-  const devices = items.map((item) => toFleetUnit(item, predictions.get(item.mac)))
-
-  return {
-    devices,
-    soh: createSohResponse(devices),
-    events: createEvents(devices, now),
-    strategies: createStrategies(devices),
-    summary: createSummary(devices, now),
-  }
-}

src/env.ts

@@ -1,20 +0,0 @@
-import { createEnv } from '@t3-oss/env-core'
-import { z } from 'zod'
-
-export const env = createEnv({
-  server: {
-    DATABASE_URL: z.url({ protocol: /^mysql$/ }),
-    ENABLE_API_DOCS: z.stringbool().default(false),
-    LOG_DB: z.stringbool().default(false),
-    LOG_FORMAT: z.enum(['pretty', 'json']).optional(),
-    LOG_LEVEL: z.enum(['trace', 'debug', 'info', 'warning', 'error', 'fatal']).default('info'),
-    SOH_PREDICTION_API_BASE_URL: z.url({ protocol: /^https?$/ }),
-    SOH_PREDICTION_CACHE_TTL_SECONDS: z.coerce.number().int().positive().default(86_400),
-    SOH_PREDICTION_NEGATIVE_CACHE_TTL_SECONDS: z.coerce.number().int().positive().default(300),
-    SOH_PREDICTION_TIMEOUT_MS: z.coerce.number().int().positive().default(10_000),
-  },
-  clientPrefix: 'VITE_',
-  client: {},
-  runtimeEnv: process.env,
-  emptyStringAsUndefined: true,
-})

src/routes/batteries.tsx

@@ -1,530 +0,0 @@
-import { useQuery } from '@tanstack/react-query'
-import { createFileRoute, Link, useNavigate } from '@tanstack/react-router'
-import { createColumnHelper, flexRender, getCoreRowModel, useReactTable } from '@tanstack/react-table'
-import { ArrowLeft, Battery, BatteryCharging, BatteryLow, FilterX, Search, X, Zap } from 'lucide-react'
-import { useEffect, useMemo, useState } from 'react'
-import { z } from 'zod'
-import { orpc } from '@/client/orpc'
-import { MotionCardDiv, MotionHeader, MotionSection, MotionTableRow } from '@/components/motion'
-import { Badge, Button, Card, EmptyState, Input, SectionTitle, Select, SelectOption, Skeleton } from '@/components/ui'
-import type { BatteryInfo, BatteryListSort, PowerStatus } from '@/domain/battery'
-import { BATTERY_LIST_SORT, BATTERY_LIST_SORT_VALUES, POWER_STATUS, POWER_STATUS_VALUES } from '@/domain/battery'
-
-const pageSizeOptions = [20, 50, 100] as const
-type PageSizeOption = (typeof pageSizeOptions)[number]
-const firstPageCursor = '__FIRST_PAGE__'
-const allPowerStatusValue = 'all'
-const loadingRowKeys = Array.from({ length: 10 }, (_, index) => `loading-row-${index}`)
-
-const searchFilterSchema = z.preprocess(
-  (value) => (typeof value === 'string' ? value.trim() || undefined : value),
-  z.string().min(1).max(100).optional(),
-)
-
-const cursorSchema = z.preprocess(
-  (value) => (typeof value === 'string' ? value.trim() || undefined : value),
-  z.string().min(1).max(1024).optional(),
-)
-
-const searchSchema = z.object({
-  search: searchFilterSchema,
-  lowPower: z.boolean().optional(),
-  powerStatus: z
-    .union([z.literal(POWER_STATUS.NOT_CHARGING), z.literal(POWER_STATUS.CHARGING), z.literal(POWER_STATUS.FULL)])
-    .optional(),
-  sort: z.enum(BATTERY_LIST_SORT_VALUES).optional().default(BATTERY_LIST_SORT.CREATED_AT_DESC),
-  pageSize: z.coerce
-    .number()
-    .pipe(z.union([z.literal(20), z.literal(50), z.literal(100)]))
-    .optional()
-    .default(50),
-  cursor: cursorSchema,
-  cursors: z.array(z.string().min(1).max(1024)).max(100).optional().default([]),
-})
-
-export const Route = createFileRoute('/batteries')({
-  validateSearch: (search) => searchSchema.parse(search),
-  component: BatteriesPage,
-  errorComponent: () => (
-    <main className="flex min-h-screen items-center justify-center bg-[#09090B]">
-      <div className="text-center">
-        <p className="text-lg text-red-400">数据加载失败</p>
-        <p className="mt-2 text-sm text-zinc-500">请检查筛选条件后重试。</p>
-      </div>
-    </main>
-  ),
-})
-
-const powerStatusLabel: Record<PowerStatus, string> = {
-  [POWER_STATUS.NOT_CHARGING]: '未充电',
-  [POWER_STATUS.CHARGING]: '充电中',
-  [POWER_STATUS.FULL]: '已充满',
-}
-
-const powerStatusVariant: Record<PowerStatus, 'muted' | 'info' | 'success'> = {
-  [POWER_STATUS.NOT_CHARGING]: 'muted',
-  [POWER_STATUS.CHARGING]: 'info',
-  [POWER_STATUS.FULL]: 'success',
-}
-
-function powerBarColor(power: number, isLowPower: boolean): string {
-  if (isLowPower || power <= 20) return 'bg-red-500'
-  if (power <= 50) return 'bg-amber-500'
-  return 'bg-teal-500'
-}
-
-const columnHelper = createColumnHelper<BatteryInfo>()
-
-function parseSort(value: string): BatteryListSort {
-  return BATTERY_LIST_SORT_VALUES.find((option) => option === value) ?? BATTERY_LIST_SORT.CREATED_AT_DESC
-}
-
-function parsePowerStatus(value: string): PowerStatus | undefined {
-  if (value === allPowerStatusValue) return undefined
-
-  const parsed = Number(value)
-
-  return POWER_STATUS_VALUES.find((option) => option === parsed)
-}
-
-function parsePageSize(value: string): PageSizeOption {
-  const parsed = Number(value)
-
-  return pageSizeOptions.find((option) => option === parsed) ?? 50
-}
-
-function BatteriesPage() {
-  const search = Route.useSearch()
-  const navigate = useNavigate({ from: Route.fullPath })
-  const [localSearch, setLocalSearch] = useState(search.search || '')
-
-  useEffect(() => {
-    setLocalSearch(search.search ?? '')
-  }, [search.search])
-
-  useEffect(() => {
-    const timer = setTimeout(() => {
-      const trimmedSearch = localSearch.trim()
-      const nextSearch = trimmedSearch || undefined
-
-      if (nextSearch !== search.search) {
-        navigate({
-          search: (prev) => ({ ...prev, search: nextSearch, cursor: undefined, cursors: [] }),
-        })
-      }
-    }, 500)
-    return () => clearTimeout(timer)
-  }, [localSearch, navigate, search.search])
-
-  const { data, error, isPending, isPlaceholderData } = useQuery(
-    orpc.battery.batteries.queryOptions({
-      input: {
-        search: search.search,
-        lowPower: search.lowPower,
-        powerStatus: search.powerStatus,
-        sort: search.sort,
-        pageSize: search.pageSize,
-        cursor: search.cursor,
-      },
-      refetchInterval: 30_000,
-      placeholderData: (prev) => prev,
-    }),
-  )
-
-  const columns = useMemo(
-    () => [
-      columnHelper.accessor('devName', {
-        header: '设备名称',
-        cell: (info) => (
-          <div className="flex flex-col">
-            <span className="font-medium text-zinc-100">{info.getValue()}</span>
-            <span className="text-[10px] text-zinc-500 tabular-nums">{info.row.original.mac}</span>
-          </div>
-        ),
-      }),
-      columnHelper.accessor('devModel', {
-        header: '型号',
-        cell: (info) => <span className="text-zinc-400">{info.getValue()}</span>,
-      }),
-      columnHelper.accessor('power', {
-        header: '电量',
-        cell: (info) => {
-          const power = info.getValue()
-          const isLow = info.row.original.isLowPower
-          return (
-            <div className="flex items-center gap-3">
-              <span className="w-8 text-right tabular-nums font-medium">{power}%</span>
-              <div className="h-1.5 w-16 overflow-hidden rounded-full bg-zinc-800">
-                <div className={`h-full ${powerBarColor(power, isLow)}`} style={{ width: `${power}%` }} />
-              </div>
-            </div>
-          )
-        },
-      }),
-      columnHelper.accessor('powerStatus', {
-        header: '状态',
-        cell: (info) => {
-          const status = info.getValue()
-          return <Badge variant={powerStatusVariant[status]}>{powerStatusLabel[status]}</Badge>
-        },
-      }),
-      columnHelper.accessor('createTime', {
-        header: '最后更新',
-        cell: (info) => (
-          <span className="text-zinc-500 tabular-nums">{new Date(info.getValue()).toLocaleString('zh-CN')}</span>
-        ),
-      }),
-    ],
-    [],
-  )
-
-  const table = useReactTable({
-    data: data?.items ?? [],
-    columns,
-    getCoreRowModel: getCoreRowModel(),
-  })
-
-  const hasActiveFilters = Boolean(search.search || search.lowPower || search.powerStatus !== undefined)
-  const clearFilters = () => {
-    setLocalSearch('')
-    navigate({
-      search: (prev) => ({
-        ...prev,
-        search: undefined,
-        lowPower: undefined,
-        powerStatus: undefined,
-        cursor: undefined,
-        cursors: [],
-      }),
-    })
-  }
-
-  const handleNextPage = () => {
-    if (!isPlaceholderData && data?.nextCursor) {
-      const nextCursor = data.nextCursor
-      navigate({
-        search: (prev) => ({
-          ...prev,
-          cursor: nextCursor,
-          cursors: [...(prev.cursors || []), prev.cursor || firstPageCursor].slice(-100),
-        }),
-      })
-    }
-  }
-
-  const handlePrevPage = () => {
-    const newCursors = [...(search.cursors || [])]
-    const lastCursor = newCursors.pop()
-    navigate({
-      search: (prev) => ({
-        ...prev,
-        cursor: lastCursor === firstPageCursor ? undefined : lastCursor,
-        cursors: newCursors,
-      }),
-    })
-  }
-
-  if (error) {
-    return (
-      <main className="flex min-h-screen items-center justify-center bg-[#09090B]">
-        <div className="text-center">
-          <p className="text-lg text-red-400">数据加载失败</p>
-          <p className="mt-2 text-sm text-zinc-500">请稍后重试，或联系管理员检查数据源连接。</p>
-        </div>
-      </main>
-    )
-  }
-
-  return (
-    <main className="min-h-screen bg-[#09090B] text-zinc-100">
-      {/* Background gradient */}
-      <div className="pointer-events-none fixed inset-0 z-0 flex justify-center">
-        <div className="h-[600px] w-[1000px] -translate-y-1/2 rounded-full bg-teal-900/5 blur-[100px]" />
-      </div>
-
-      <div className="relative z-10 mx-auto max-w-7xl px-6 py-8">
-        <MotionHeader>
-          <div className="flex flex-col gap-5 lg:flex-row lg:items-end lg:justify-between">
-            <div>
-              <Badge variant="info" className="mb-4">
-                <Battery className="size-3.5" /> 实时设备数据
-              </Badge>
-              <h1 className="text-3xl font-light tracking-tight text-white">设备状态明细</h1>
-              <p className="mt-2 max-w-2xl text-sm leading-6 text-zinc-400">
-                查看最新设备状态，快速定位低电量、充电中和长期未更新的设备。
-              </p>
-              <p className="mt-2 text-xs tabular-nums text-zinc-500">
-                {data ? `更新于 ${new Date(data.updatedAt).toLocaleString('zh-CN')}` : '加载中…'}
-              </p>
-            </div>
-            <nav>
-              <Link
-                to="/"
-                className="inline-flex items-center gap-2 rounded-lg border border-white/10 bg-white/[0.04] px-3 py-2 text-sm text-zinc-300 transition-colors hover:border-teal-400/30 hover:text-teal-300"
-              >
-                <ArrowLeft className="size-4" /> 返回健康看板
-              </Link>
-            </nav>
-          </div>
-
-          <dl className="mt-8 grid grid-cols-1 gap-4 sm:grid-cols-3">
-            <MotionCardDiv className="rounded-2xl border border-white/[0.08] bg-zinc-950/60 shadow-2xl shadow-black/20 p-5">
-              <dt className="flex items-center gap-2 text-xs font-medium text-zinc-500">
-                <Battery className="size-4 text-zinc-400" /> 设备总数
-              </dt>
-              <dd className="mt-3 text-3xl font-light tabular-nums text-white">{data?.total ?? '-'}</dd>
-            </MotionCardDiv>
-            <MotionCardDiv className="rounded-2xl border border-white/[0.08] bg-zinc-950/60 shadow-2xl shadow-black/20 p-5">
-              <dt className="flex items-center gap-2 text-xs font-medium text-zinc-500">
-                <BatteryLow className="size-4 text-red-400" /> 低电量
-              </dt>
-              <dd className="mt-3 text-3xl font-light tabular-nums text-red-300">{data?.lowPower ?? '-'}</dd>
-            </MotionCardDiv>
-            <MotionCardDiv className="rounded-2xl border border-white/[0.08] bg-zinc-950/60 shadow-2xl shadow-black/20 p-5">
-              <dt className="flex items-center gap-2 text-xs font-medium text-zinc-500">
-                <BatteryCharging className="size-4 text-teal-300" /> 充电中
-              </dt>
-              <dd className="mt-3 text-3xl font-light tabular-nums text-teal-300">{data?.charging ?? '-'}</dd>
-            </MotionCardDiv>
-          </dl>
-        </MotionHeader>
-
-        <MotionSection delay={0.1} className="mt-10">
-          <Card className="mb-6 p-5">
-            <div className="mb-5 flex flex-wrap items-center justify-between gap-3">
-              <SectionTitle
-                icon={<Search className="size-4" />}
-                title="筛选设备"
-                description="按设备名称、编号、电量与充电状态快速缩小排查范围。"
-              />
-              {hasActiveFilters && (
-                <Button type="button" className="h-9 px-3 text-xs" onClick={clearFilters}>
-                  <FilterX className="size-3.5" /> 清除筛选
-                </Button>
-              )}
-            </div>
-            <div className="flex flex-wrap items-end gap-4">
-              <div className="flex flex-col gap-2 min-w-[260px] flex-1">
-                <label htmlFor="search-input" className="text-xs font-medium text-zinc-500">
-                  设备名称 / 设备编号
-                </label>
-                <div className="relative">
-                  <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-zinc-600" />
-                  <Input
-                    id="search-input"
-                    type="text"
-                    placeholder="搜索设备名称或编号..."
-                    maxLength={100}
-                    className="pl-9 pr-9"
-                    value={localSearch}
-                    onChange={(e) => setLocalSearch(e.target.value)}
-                  />
-                  {localSearch && (
-                    <button
-                      type="button"
-                      aria-label="清空搜索内容"
-                      onClick={() => setLocalSearch('')}
-                      className="absolute right-3 top-1/2 -translate-y-1/2 text-zinc-500 hover:text-zinc-300"
-                    >
-                      <X className="size-4" />
-                    </button>
-                  )}
-                </div>
-              </div>
-
-              <div className="flex flex-col gap-2">
-                <label htmlFor="power-status-select" className="text-xs font-medium text-zinc-500">
-                  充电状态
-                </label>
-                <Select
-                  id="power-status-select"
-                  value={search.powerStatus ?? allPowerStatusValue}
-                  onValueChange={(value) => {
-                    navigate({
-                      search: (prev) => ({
-                        ...prev,
-                        powerStatus: parsePowerStatus(value),
-                        cursor: undefined,
-                        cursors: [],
-                      }),
-                    })
-                  }}
-                >
-                  <SelectOption value={allPowerStatusValue}>所有充电状态</SelectOption>
-                  <SelectOption value={POWER_STATUS.NOT_CHARGING}>未充电</SelectOption>
-                  <SelectOption value={POWER_STATUS.CHARGING}>充电中</SelectOption>
-                  <SelectOption value={POWER_STATUS.FULL}>已充满</SelectOption>
-                </Select>
-              </div>
-
-              <div className="flex flex-col gap-2">
-                <label htmlFor="sort-select" className="text-xs font-medium text-zinc-500">
-                  排序
-                </label>
-                <Select
-                  id="sort-select"
-                  value={search.sort}
-                  onValueChange={(value) => {
-                    navigate({
-                      search: (prev) => ({
-                        ...prev,
-                        sort: parseSort(value),
-                        cursor: undefined,
-                        cursors: [],
-                      }),
-                    })
-                  }}
-                >
-                  <SelectOption value={BATTERY_LIST_SORT.CREATED_AT_DESC}>最新更新</SelectOption>
-                  <SelectOption value={BATTERY_LIST_SORT.CREATED_AT_ASC}>最早更新</SelectOption>
-                  <SelectOption value={BATTERY_LIST_SORT.POWER_DESC}>电量从高到低</SelectOption>
-                  <SelectOption value={BATTERY_LIST_SORT.POWER_ASC}>电量从低到高</SelectOption>
-                </Select>
-              </div>
-
-              <div className="flex flex-col gap-2">
-                <label htmlFor="page-size-select" className="text-xs font-medium text-zinc-500">
-                  每页条数
-                </label>
-                <Select
-                  id="page-size-select"
-                  value={search.pageSize}
-                  onValueChange={(value) => {
-                    navigate({
-                      search: (prev) => ({
-                        ...prev,
-                        pageSize: parsePageSize(value),
-                        cursor: undefined,
-                        cursors: [],
-                      }),
-                    })
-                  }}
-                >
-                  <SelectOption value="20">20 条/页</SelectOption>
-                  <SelectOption value="50">50 条/页</SelectOption>
-                  <SelectOption value="100">100 条/页</SelectOption>
-                </Select>
-              </div>
-
-              <label
-                htmlFor="low-power-checkbox"
-                className="inline-flex h-10 cursor-pointer items-center gap-2 rounded-lg border border-white/10 bg-white/[0.04] px-3 text-sm text-zinc-300 transition-colors hover:bg-white/[0.07]"
-              >
-                <input
-                  id="low-power-checkbox"
-                  type="checkbox"
-                  className="rounded border-white/10 bg-zinc-950 text-teal-500 focus:ring-teal-500/50"
-                  checked={search.lowPower ?? false}
-                  onChange={(e) =>
-                    navigate({
-                      search: (prev) => ({
-                        ...prev,
-                        lowPower: e.target.checked || undefined,
-                        cursor: undefined,
-                        cursors: [],
-                      }),
-                    })
-                  }
-                />
-                <Zap className="size-4 text-amber-300" /> 仅显示低电量设备
-              </label>
-            </div>
-          </Card>
-
-          <Card className="overflow-hidden">
-            <div className="overflow-x-auto max-h-[600px]">
-              <table className={`w-full border-collapse text-left text-sm ${isPlaceholderData ? 'opacity-60' : ''}`}>
-                <thead className="sticky top-0 z-10 bg-zinc-950/90 backdrop-blur-sm">
-                  {table.getHeaderGroups().map((headerGroup) => (
-                    <tr key={headerGroup.id} className="border-b border-white/5 bg-white/[0.02]">
-                      {headerGroup.headers.map((header) => (
-                        <th key={header.id} className="px-6 py-4 font-medium text-zinc-500 whitespace-nowrap">
-                          {flexRender(header.column.columnDef.header, header.getContext())}
-                        </th>
-                      ))}
-                    </tr>
-                  ))}
-                </thead>
-                <tbody className="divide-y divide-white/[0.02]">
-                  {isPending && !isPlaceholderData ? (
-                    loadingRowKeys.map((key) => (
-                      <tr key={key}>
-                        <td className="px-6 py-4">
-                          <Skeleton className="h-5 w-32" />
-                          <Skeleton className="mt-1.5 h-3 w-24" />
-                        </td>
-                        <td className="px-6 py-4">
-                          <Skeleton className="h-4 w-20" />
-                        </td>
-                        <td className="px-6 py-4">
-                          <div className="flex items-center gap-3">
-                            <Skeleton className="h-4 w-8" />
-                            <Skeleton className="h-1.5 w-16 rounded-full" />
-                          </div>
-                        </td>
-                        <td className="px-6 py-4">
-                          <Skeleton className="h-6 w-16 rounded-full" />
-                        </td>
-                        <td className="px-6 py-4">
-                          <Skeleton className="h-4 w-32" />
-                        </td>
-                      </tr>
-                    ))
-                  ) : data?.items.length === 0 ? (
-                    <tr>
-                      <td colSpan={columns.length} className="h-64">
-                        <EmptyState
-                          icon={<Battery className="size-8" />}
-                          title="未找到符合条件的设备"
-                          description={
-                            hasActiveFilters ? '尝试调整筛选条件或清除筛选以查看更多设备。' : '当前暂无设备数据接入。'
-                          }
-                          action={
-                            hasActiveFilters ? (
-                              <Button onClick={clearFilters}>
-                                <FilterX className="size-4" /> 清除筛选
-                              </Button>
-                            ) : undefined
-                          }
-                        />
-                      </td>
-                    </tr>
-                  ) : (
-                    table.getRowModel().rows.map((row) => (
-                      <MotionTableRow key={row.id} className="transition-colors hover:bg-white/[0.02]">
-                        {row.getVisibleCells().map((cell) => (
-                          <td key={cell.id} className="px-6 py-4 whitespace-nowrap">
-                            {flexRender(cell.column.columnDef.cell, cell.getContext())}
-                          </td>
-                        ))}
-                      </MotionTableRow>
-                    ))
-                  )}
-                </tbody>
-              </table>
-            </div>
-          </Card>
-
-          <div className="mt-6 flex items-center justify-between text-sm text-zinc-500">
-            <div>
-              当前显示 {data?.items.length ?? 0} 台设备
-              {data?.total ? ` (共 ${data.total} 台)` : ''}
-            </div>
-            <div className="flex items-center gap-2">
-              <Button
-                type="button"
-                onClick={handlePrevPage}
-                disabled={isPlaceholderData || (!search.cursor && (!search.cursors || search.cursors.length === 0))}
-              >
-                上一页
-              </Button>
-              <Button type="button" onClick={handleNextPage} disabled={isPlaceholderData || !data?.nextCursor}>
-                下一页
-              </Button>
-            </div>
-          </div>
-        </MotionSection>
-      </div>
-    </main>
-  )
-}

src/routes/health.ts

@@ -1,9 +0,0 @@
-import { createFileRoute } from '@tanstack/react-router'
-
-export const Route = createFileRoute('/health')({
-  server: {
-    handlers: {
-      GET: () => new Response('ok', { status: 200, headers: { 'content-type': 'text/plain' } }),
-    },
-  },
-})

src/routes/index.tsx

@@ -1,670 +0,0 @@
-import { useQuery } from '@tanstack/react-query'
-import { createFileRoute, Link } from '@tanstack/react-router'
-import { Activity, AlertTriangle, ArrowRight, ShieldCheck, Tags, TrendingDown } from 'lucide-react'
-import {
-  Area,
-  CartesianGrid,
-  ComposedChart,
-  Line,
-  ReferenceLine,
-  ResponsiveContainer,
-  Tooltip,
-  XAxis,
-  YAxis,
-} from 'recharts'
-import type { NameType, ValueType } from 'recharts/types/component/DefaultTooltipContent'
-import { orpc } from '@/client/orpc'
-import { MotionCardArticle, MotionCardDiv, MotionHeader, MotionSection } from '@/components/motion'
-import { Badge, Card, EmptyState, SectionTitle } from '@/components/ui'
-import type { DashboardSnapshot, DeviceStatus } from '@/domain/battery'
-import { BATTERY_LIST_SORT, DEVICE_STATUS } from '@/domain/battery'
-
-export const Route = createFileRoute('/')({
-  component: Dashboard,
-  errorComponent: ({ error }) => (
-    <main className="flex min-h-screen items-center justify-center bg-[#09090B]">
-      <div className="text-center">
-        <p className="text-lg text-red-400">数据加载失败</p>
-        <p className="mt-2 text-sm text-[#71717A]">{error.message}</p>
-      </div>
-    </main>
-  ),
-})
-
-function buildChartData(soh: DashboardSnapshot['soh']) {
-  const chartData: { month: string; history?: number; forecast?: number }[] = soh.history.map((h) => ({
-    month: h.month,
-    history: h.value,
-    forecast: undefined,
-  }))
-
-  if (chartData.length > 0 && soh.forecast.length > 0) {
-    // Overlap: last history point is also first forecast point
-    const last = chartData[chartData.length - 1]
-    if (last) {
-      last.forecast = soh.forecast[0]?.value
-    }
-  }
-
-  const forecastStart = chartData.length > 0 ? 1 : 0
-
-  for (let i = forecastStart; i < soh.forecast.length; i++) {
-    const f = soh.forecast[i]
-    if (f) {
-      chartData.push({
-        month: f.month,
-        history: undefined,
-        forecast: f.value,
-      })
-    }
-  }
-
-  return chartData
-}
-
-const statusVariantMap: Record<DeviceStatus, 'success' | 'warning' | 'danger'> = {
-  [DEVICE_STATUS.HEALTHY]: 'success',
-  [DEVICE_STATUS.WATCH]: 'warning',
-  [DEVICE_STATUS.WARNING]: 'danger',
-}
-
-const severityVariantMap: Record<DashboardSnapshot['events'][number]['severity'], 'danger' | 'warning' | 'muted'> = {
-  高: 'danger',
-  中: 'warning',
-  低: 'muted',
-}
-
-function formatChartTooltip(value: ValueType | undefined, name: NameType | undefined) {
-  const numericValue = typeof value === 'number' ? value : Number(value)
-
-  return [
-    `${Number.isFinite(numericValue) ? numericValue.toFixed(1) : (value ?? '-')}%`,
-    name === 'history' ? '历史观测' : '趋势预测',
-  ]
-}
-
-function formatPercent(value: number | null) {
-  return value === null ? '—' : value.toFixed(1)
-}
-
-function formatPercentWithUnit(value: number | null) {
-  return value === null ? '预测不可用' : `${value.toFixed(1)}%`
-}
-
-function formatDelta(from: number | null, to: number | null) {
-  if (from === null || to === null) return '预测不可用'
-  const delta = from - to
-
-  if (delta < 0) return `${Math.abs(delta).toFixed(1)}% 改善`
-  if (delta === 0) return '0.0% 持平'
-  return `${delta.toFixed(1)}% 衰减`
-}
-
-function widthPercent(value: number | null) {
-  return `${Math.max(0, Math.min(100, value ?? 0))}%`
-}
-
-function Dashboard() {
-  const { data, error, isPending } = useQuery(orpc.battery.dashboard.queryOptions())
-
-  if (error) {
-    return (
-      <main className="flex min-h-screen items-center justify-center bg-[#09090B]">
-        <div className="text-center">
-          <p className="text-lg text-red-400">数据加载失败</p>
-          <p className="mt-2 text-sm text-[#71717A]">{error.message}</p>
-        </div>
-      </main>
-    )
-  }
-
-  if (isPending || !data) {
-    return (
-      <main className="flex min-h-screen items-center justify-center bg-[#09090B]">
-        <p className="text-[#71717A]">加载中…</p>
-      </main>
-    )
-  }
-
-  const { devices, soh, events, strategies, summary } = data
-  const {
-    totalDevices,
-    avgSoh,
-    avgSoh30d,
-    avgSoh90d,
-    warningCount,
-    watchCount,
-    healthyCount,
-    batchPerformance,
-    riskFactorCounts,
-    firmwareHealth,
-    updatedAt,
-    executiveSummary,
-  } = summary
-  const chartData = buildChartData(soh)
-
-  return (
-    <main className="min-h-screen w-full bg-[#09090B] font-sans text-[#F4F4F5]">
-      {/* Background gradient */}
-      <div className="pointer-events-none fixed inset-0 z-0 flex justify-center">
-        <div className="h-[800px] w-[1200px] -translate-y-1/2 rounded-full bg-teal-900/10 blur-[120px]" />
-      </div>
-
-      <div className="relative z-10 mx-auto max-w-[1400px] px-6 pb-24 pt-12 lg:px-12">
-        {/* Header */}
-        <MotionHeader className="mb-12 flex flex-col gap-6 lg:flex-row lg:items-end lg:justify-between">
-          <div className="max-w-3xl">
-            <Badge variant="info" className="mb-4">
-              <Activity className="size-3.5" /> 实时数据与健康预测
-            </Badge>
-            <h1 className="text-4xl font-light tracking-tight text-white sm:text-5xl">电池健康与风险洞察</h1>
-          </div>
-          <div className="flex flex-col items-end gap-3 text-right">
-            <Badge variant="muted">基于当前可用数据生成</Badge>
-            <p className="text-xs tabular-nums text-[#71717A]">数据更新时间: {updatedAt}</p>
-            <Link
-              to="/batteries"
-              search={{ pageSize: 50, sort: BATTERY_LIST_SORT.CREATED_AT_DESC, cursors: [] }}
-              className="inline-flex items-center gap-1 text-xs text-teal-400 hover:text-teal-300"
-            >
-              设备电池实时状态 <ArrowRight className="size-3" />
-            </Link>
-          </div>
-        </MotionHeader>
-
-        {/* Executive Summary */}
-        <MotionSection delay={0.1} className="mb-12 rounded-xl border border-teal-900/30 bg-teal-950/10 p-6">
-          <h2 className="mb-3 text-sm font-medium text-teal-400">执行摘要</h2>
-          <p className="text-base leading-relaxed text-[#A1A1AA]">{executiveSummary}</p>
-        </MotionSection>
-
-        {/* Primary KPI Row */}
-        <MotionSection delay={0.2} className="mb-12 grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-5">
-          {/* Hero KPI */}
-          <MotionCardArticle className="relative overflow-hidden rounded-2xl border border-white/10 bg-white/[0.03] p-8 lg:col-span-2">
-            <div className="absolute inset-x-0 top-0 h-1 bg-gradient-to-r from-teal-500/50 to-transparent" />
-            <p className="text-sm font-medium text-[#A1A1AA]">当前平均健康度</p>
-            <div className="mt-4 flex items-baseline gap-2">
-              <h2 className="text-6xl font-light tabular-nums text-white">{formatPercent(avgSoh)}</h2>
-              {avgSoh !== null && <span className="text-2xl text-[#71717A]">%</span>}
-            </div>
-            <div className="mt-6 flex items-center gap-3 text-sm">
-              <span className="inline-flex items-center gap-1.5 text-emerald-400">
-                <span className="h-1.5 w-1.5 rounded-full bg-emerald-400" />
-                {avgSoh === null ? '健康预测暂不可用' : '预测已返回'}
-              </span>
-              <span className="text-[#71717A]">|</span>
-              <span className="text-[#A1A1AA]">共 {totalDevices} 台设备</span>
-            </div>
-          </MotionCardArticle>
-
-          {/* Regular KPIs */}
-          <MotionCardArticle className="rounded-2xl border border-white/[0.06] bg-white/[0.02] p-6 transition-colors hover:border-white/10">
-            <p className="text-sm text-[#A1A1AA]">30 天预测均值</p>
-            <div className="mt-3 flex items-baseline gap-1">
-              <h2 className="text-4xl font-light tabular-nums text-white">{formatPercent(avgSoh30d)}</h2>
-              {avgSoh30d !== null && <span className="text-lg text-[#71717A]">%</span>}
-            </div>
-            <div className="mt-4 flex items-center gap-1.5 text-sm">
-              <span className="text-red-400">↘</span>
-              <span className="tabular-nums text-[#A1A1AA]">{formatDelta(avgSoh, avgSoh30d)}</span>
-            </div>
-          </MotionCardArticle>
-
-          <MotionCardArticle className="rounded-2xl border border-white/[0.06] bg-white/[0.02] p-6 transition-colors hover:border-white/10">
-            <p className="text-sm text-[#A1A1AA]">90 天预测均值</p>
-            <div className="mt-3 flex items-baseline gap-1">
-              <h2 className="text-4xl font-light tabular-nums text-white">{formatPercent(avgSoh90d)}</h2>
-              {avgSoh90d !== null && <span className="text-lg text-[#71717A]">%</span>}
-            </div>
-            <div className="mt-4 flex items-center gap-1.5 text-sm">
-              <span className="text-red-400">↘</span>
-              <span className="tabular-nums text-[#A1A1AA]">{formatDelta(avgSoh, avgSoh90d)}</span>
-            </div>
-          </MotionCardArticle>
-
-          <MotionCardArticle className="rounded-2xl border border-white/[0.06] bg-white/[0.02] p-6 transition-colors hover:border-white/10">
-            <p className="text-sm text-[#A1A1AA]">高风险设备</p>
-            <div className="mt-3 flex items-baseline gap-1">
-              <h2 className="text-4xl font-light tabular-nums text-white">{warningCount}</h2>
-              <span className="text-lg text-[#71717A]">台</span>
-            </div>
-            <div className="mt-4 flex items-center gap-1.5 text-sm">
-              <span className="text-amber-400">↗</span>
-              <span className="tabular-nums text-[#A1A1AA]">
-                占比 {totalDevices > 0 ? ((warningCount / totalDevices) * 100).toFixed(1) : 0}%
-              </span>
-            </div>
-          </MotionCardArticle>
-        </MotionSection>
-
-        {/* Divider */}
-        <hr className="my-12 border-white/5" />
-
-        {/* Health trend chart */}
-        <MotionSection delay={0.3} className="mb-12">
-          <Card className="p-8">
-            <header className="mb-8 flex flex-wrap items-end justify-between gap-4">
-              <SectionTitle
-                icon={<TrendingDown className="size-4" />}
-                title="健康趋势预测"
-                description="展示当前健康度与未来 30/90 天趋势；数据不足时保持空态，避免误导判断。"
-              />
-              <div className="flex items-center gap-6 text-sm text-[#A1A1AA]">
-                {soh.history.length > 0 && (
-                  <span className="inline-flex items-center gap-2">
-                    <span className="h-2 w-4 rounded-full bg-teal-400" />
-                    历史观测值
-                  </span>
-                )}
-                <span className="inline-flex items-center gap-2">
-                  <span className="h-2 w-4 rounded-full bg-indigo-400" />
-                  预测趋势
-                </span>
-              </div>
-            </header>
-
-            <div className="w-full h-[320px]">
-              {chartData.length > 0 ? (
-                <ResponsiveContainer width="100%" height="100%">
-                  <ComposedChart data={chartData} margin={{ top: 24, right: 24, bottom: 8, left: 0 }}>
-                    <defs>
-                      <linearGradient id="historyFill" x1="0" y1="0" x2="0" y2="1">
-                        <stop offset="0%" stopColor="#2DD4BF" stopOpacity={0.25} />
-                        <stop offset="100%" stopColor="#2DD4BF" stopOpacity={0} />
-                      </linearGradient>
-                      <linearGradient id="forecastFill" x1="0" y1="0" x2="0" y2="1">
-                        <stop offset="0%" stopColor="#818CF8" stopOpacity={0.25} />
-                        <stop offset="100%" stopColor="#818CF8" stopOpacity={0} />
-                      </linearGradient>
-                    </defs>
-                    <CartesianGrid stroke="#ffffff" strokeOpacity={0.05} vertical={false} />
-                    <XAxis dataKey="month" tick={{ fill: '#A1A1AA', fontSize: 12 }} axisLine={false} tickLine={false} />
-                    <YAxis
-                      domain={[(min: number) => Math.floor(min) - 2, (max: number) => Math.ceil(max) + 2]}
-                      tick={{ fill: '#A1A1AA', fontSize: 12 }}
-                      axisLine={false}
-                      tickLine={false}
-                      tickFormatter={(v: number) => `${v}%`}
-                      width={48}
-                    />
-                    <Tooltip
-                      contentStyle={{
-                        backgroundColor: '#18181B',
-                        border: '1px solid rgba(255,255,255,0.1)',
-                        borderRadius: 8,
-                        fontSize: 13,
-                        color: '#F4F4F5',
-                        boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.5)',
-                      }}
-                      itemStyle={{ color: '#E4E4E7', fontWeight: 500 }}
-                      formatter={formatChartTooltip}
-                      labelStyle={{ color: '#A1A1AA', marginBottom: 6 }}
-                    />
-                    <ReferenceLine
-                      y={85}
-                      stroke="#F87171"
-                      strokeOpacity={0.6}
-                      strokeDasharray="4 4"
-                      label={{
-                        value: '85% 预警线',
-                        fill: '#F87171',
-                        fontSize: 12,
-                        position: 'right',
-                      }}
-                    />
-                    <Area
-                      type="monotone"
-                      dataKey="history"
-                      fill="url(#historyFill)"
-                      stroke="none"
-                      connectNulls={false}
-                      tooltipType="none"
-                    />
-                    <Area
-                      type="monotone"
-                      dataKey="forecast"
-                      fill="url(#forecastFill)"
-                      stroke="none"
-                      connectNulls={false}
-                      tooltipType="none"
-                    />
-                    <Line
-                      type="monotone"
-                      dataKey="history"
-                      stroke="#2DD4BF"
-                      strokeWidth={2.5}
-                      dot={{
-                        fill: '#09090B',
-                        stroke: '#2DD4BF',
-                        strokeWidth: 2,
-                        r: 3,
-                      }}
-                      connectNulls={false}
-                    />
-                    <Line
-                      type="monotone"
-                      dataKey="forecast"
-                      stroke="#818CF8"
-                      strokeWidth={2.5}
-                      strokeDasharray="4 4"
-                      dot={{
-                        fill: '#09090B',
-                        stroke: '#818CF8',
-                        strokeWidth: 2,
-                        r: 3,
-                      }}
-                      connectNulls={false}
-                    />
-                  </ComposedChart>
-                </ResponsiveContainer>
-              ) : (
-                <div className="flex h-full items-center justify-center rounded-xl border border-dashed border-white/10 bg-white/[0.02]">
-                  <EmptyState
-                    icon={<TrendingDown className="size-8" />}
-                    title="暂无健康趋势数据"
-                    description="当前设备数据不足以生成可靠的健康趋势预测，请等待系统收集更多数据。"
-                  />
-                </div>
-              )}
-            </div>
-          </Card>
-        </MotionSection>
-
-        {/* Two-column grid */}
-        <MotionSection delay={0.4} className="mb-12 grid grid-cols-1 gap-8 lg:grid-cols-2">
-          {/* Left Column */}
-          <div className="space-y-8">
-            {/* Risk Distribution */}
-            <div>
-              <div className="mb-6">
-                <SectionTitle icon={<ShieldCheck className="size-4" />} title="健康分布" />
-              </div>
-              <div className="space-y-5">
-                <div>
-                  <div className="mb-2 flex justify-between text-sm">
-                    <span className="text-[#A1A1AA]">健康 (&gt; 90%)</span>
-                    <span className="tabular-nums text-white">
-                      {healthyCount} 台{' '}
-                      <span className="text-[#71717A]">
-                        / {totalDevices > 0 ? ((healthyCount / totalDevices) * 100).toFixed(1) : 0}%
-                      </span>
-                    </span>
-                  </div>
-                  <div className="h-1.5 overflow-hidden rounded-full bg-white/5">
-                    <div
-                      className="h-full rounded-full bg-emerald-400"
-                      style={{ width: `${totalDevices > 0 ? (healthyCount / totalDevices) * 100 : 0}%` }}
-                    />
-                  </div>
-                </div>
-                <div>
-                  <div className="mb-2 flex justify-between text-sm">
-                    <span className="text-[#A1A1AA]">关注 (85% - 90%)</span>
-                    <span className="tabular-nums text-white">
-                      {watchCount} 台{' '}
-                      <span className="text-[#71717A]">
-                        / {totalDevices > 0 ? ((watchCount / totalDevices) * 100).toFixed(1) : 0}%
-                      </span>
-                    </span>
-                  </div>
-                  <div className="h-1.5 overflow-hidden rounded-full bg-white/5">
-                    <div
-                      className="h-full rounded-full bg-amber-400"
-                      style={{ width: `${totalDevices > 0 ? (watchCount / totalDevices) * 100 : 0}%` }}
-                    />
-                  </div>
-                </div>
-                <div>
-                  <div className="mb-2 flex justify-between text-sm">
-                    <span className="text-[#A1A1AA]">预警 (&le; 85%)</span>
-                    <span className="tabular-nums text-white">
-                      {warningCount} 台{' '}
-                      <span className="text-[#71717A]">
-                        / {totalDevices > 0 ? ((warningCount / totalDevices) * 100).toFixed(1) : 0}%
-                      </span>
-                    </span>
-                  </div>
-                  <div className="h-1.5 overflow-hidden rounded-full bg-white/5">
-                    <div
-                      className="h-full rounded-full bg-red-400"
-                      style={{ width: `${totalDevices > 0 ? (warningCount / totalDevices) * 100 : 0}%` }}
-                    />
-                  </div>
-                </div>
-              </div>
-            </div>
-
-            {/* Regional Performance */}
-            <div>
-              <h3 className="mb-6 text-lg font-medium text-white">设备型号健康度概览</h3>
-              <div className="space-y-4">
-                {batchPerformance.length > 0 ? (
-                  batchPerformance.map((item) => (
-                    <div key={item.batch} className="flex items-center gap-4">
-                      <span className="w-20 text-sm text-[#A1A1AA]">{item.batch}</span>
-                      <div className="flex-1">
-                        <div className="h-1.5 overflow-hidden rounded-full bg-white/5">
-                          <div
-                            className="h-full rounded-full bg-white/20"
-                            style={{ width: widthPercent(item.avgSoh) }}
-                          />
-                        </div>
-                      </div>
-                      <span className="w-20 text-right text-sm tabular-nums text-white">
-                        {formatPercentWithUnit(item.avgSoh)}
-                      </span>
-                    </div>
-                  ))
-                ) : (
-                  <div className="text-sm text-[#71717A]">暂无数据</div>
-                )}
-              </div>
-            </div>
-          </div>
-
-          {/* Right Column */}
-          <div className="space-y-8">
-            {/* Event Timeline */}
-            <div>
-              <div className="mb-6">
-                <SectionTitle icon={<AlertTriangle className="size-4" />} title="风险与趋势概览" />
-              </div>
-              <div className="relative border-l border-white/10 pl-5">
-                {events.length > 0 ? (
-                  events.map((event) => (
-                    <div key={event.time + event.title} className="mb-6 last:mb-0">
-                      <div
-                        className={`absolute -left-[4px] mt-1.5 h-2 w-2 rounded-full ${
-                          event.severity === '高' ? 'bg-red-400' : 'bg-amber-400'
-                        }`}
-                      />
-                      <div className="mb-1 flex items-center gap-3">
-                        <span className="text-xs font-medium tabular-nums text-[#71717A]">{event.time}</span>
-                        <Badge variant={severityVariantMap[event.severity]}>{event.severity}风险</Badge>
-                      </div>
-                      <h4 className="text-sm font-medium text-[#F4F4F5]">{event.title}</h4>
-                      <p className="mt-1 text-sm leading-relaxed text-[#A1A1AA]">{event.detail}</p>
-                    </div>
-                  ))
-                ) : (
-                  <div className="text-sm text-[#71717A]">暂无数据</div>
-                )}
-              </div>
-            </div>
-
-            {/* Risk Factor Frequency */}
-            <div>
-              <div className="mb-6">
-                <SectionTitle icon={<Tags className="size-4" />} title="主要风险因子分布" />
-              </div>
-              <div className="flex flex-wrap gap-2">
-                {riskFactorCounts.length > 0 ? (
-                  riskFactorCounts.map((item) => (
-                    <Badge key={item.factor} variant={item.factor.includes('不可用') ? 'warning' : 'default'}>
-                      {item.factor}
-                      <span className="rounded-full bg-white/10 px-1.5 py-0.5 tabular-nums text-white">
-                        {item.count}
-                      </span>
-                    </Badge>
-                  ))
-                ) : (
-                  <div className="text-sm text-[#71717A]">暂无数据</div>
-                )}
-              </div>
-            </div>
-          </div>
-        </MotionSection>
-
-        {/* Divider */}
-        <hr className="my-12 border-white/5" />
-
-        {/* Device Table */}
-        <MotionSection delay={0.5} className="mb-12">
-          <div className="mb-6 flex items-end justify-between">
-            <div>
-              <h3 className="text-xl font-medium text-white">重点关注设备</h3>
-              <p className="mt-1 text-sm text-[#A1A1AA]">按风险优先级展示当前健康度与未来 30/90 天趋势。</p>
-            </div>
-          </div>
-          <Card className="overflow-hidden">
-            <div className="overflow-x-auto">
-              <table className="w-full min-w-[1000px] border-collapse text-left text-sm">
-                <thead>
-                  <tr className="border-b border-white/10 bg-white/[0.02] text-zinc-400">
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">设备标识</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">设备型号</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">当前健康度</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">30天预测</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">90天预测</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">风险评分</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">状态</th>
-                    <th className="px-6 py-4 font-medium whitespace-nowrap">主要风险因子</th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y divide-white/5">
-                  {devices.length > 0 ? (
-                    devices
-                      .slice()
-                      .sort((a, b) => b.riskScore - a.riskScore)
-                      .map((unit) => (
-                        <tr key={unit.id} className="transition-colors hover:bg-white/[0.04]">
-                          <td className="px-6 py-4 font-medium text-white">{unit.displayName}</td>
-                          <td className="px-6 py-4 text-[#A1A1AA]">{unit.batch}</td>
-                          <td className="px-6 py-4 tabular-nums text-white">{formatPercentWithUnit(unit.soh)}</td>
-                          <td className="px-6 py-4 tabular-nums text-[#A1A1AA]">
-                            {formatPercentWithUnit(unit.soh30d)}
-                          </td>
-                          <td className="px-6 py-4 tabular-nums text-[#A1A1AA]">
-                            {formatPercentWithUnit(unit.soh90d)}
-                          </td>
-                          <td className="px-6 py-4">
-                            <div className="flex items-center gap-2">
-                              <div className="h-1.5 w-12 overflow-hidden rounded-full bg-white/5">
-                                <div
-                                  className={`h-full rounded-full ${
-                                    unit.riskScore >= 75
-                                      ? 'bg-red-400'
-                                      : unit.riskScore >= 45
-                                        ? 'bg-amber-400'
-                                        : 'bg-emerald-400'
-                                  }`}
-                                  style={{ width: `${unit.riskScore}%` }}
-                                />
-                              </div>
-                              <span className="tabular-nums text-white">{unit.riskScore}</span>
-                            </div>
-                          </td>
-                          <td className="px-6 py-4">
-                            <Badge variant={statusVariantMap[unit.status]}>{unit.status}</Badge>
-                          </td>
-                          <td className="px-6 py-4">
-                            <div className="flex flex-wrap gap-1.5">
-                              {unit.riskFactors.length > 0 ? (
-                                unit.riskFactors.map((factor) => (
-                                  <Badge key={factor} variant={factor.includes('不可用') ? 'warning' : 'default'}>
-                                    {factor}
-                                  </Badge>
-                                ))
-                              ) : (
-                                <span className="text-[#71717A]">-</span>
-                              )}
-                            </div>
-                          </td>
-                        </tr>
-                      ))
-                  ) : (
-                    <tr>
-                      <td colSpan={8} className="px-6 py-12">
-                        <EmptyState
-                          icon={<Activity className="size-8" />}
-                          title="暂无设备数据"
-                          description="当前没有可用于健康分析的设备记录。"
-                        />
-                      </td>
-                    </tr>
-                  )}
-                </tbody>
-              </table>
-            </div>
-          </Card>
-        </MotionSection>
-
-        {/* Bottom Row */}
-        <MotionSection delay={0.5} className="grid grid-cols-1 gap-8 lg:grid-cols-3">
-          {/* Strategy Cards */}
-          <div className="lg:col-span-2">
-            <h3 className="mb-6 text-lg font-medium text-white">行动建议</h3>
-            <div className="grid gap-4 sm:grid-cols-2">
-              {strategies.length > 0 ? (
-                strategies.map((item, index) => (
-                  <MotionCardDiv
-                    key={item.name}
-                    className="relative overflow-hidden rounded-xl border border-white/[0.06] bg-white/[0.02] p-5"
-                  >
-                    <div
-                      className={`absolute bottom-0 left-0 top-0 w-1 ${index === 0 ? 'bg-red-400' : index === 1 ? 'bg-amber-400' : 'bg-teal-400'}`}
-                    />
-                    <h4 className="font-medium text-white">{item.name}</h4>
-                    <p className="mt-2 text-sm text-[#A1A1AA]">{item.impact}</p>
-                    <div className="mt-4 flex flex-wrap gap-4 text-xs text-[#71717A]">
-                      <span>范围: {item.scope}</span>
-                      <span>时效: {item.eta}</span>
-                    </div>
-                  </MotionCardDiv>
-                ))
-              ) : (
-                <div className="text-sm text-[#71717A] col-span-2">暂无策略建议</div>
-              )}
-            </div>
-          </div>
-
-          {/* Firmware Comparison */}
-          <div>
-            <h3 className="mb-6 text-lg font-medium text-white">备注分组健康度对比</h3>
-            <div className="rounded-xl border border-white/[0.06] bg-white/[0.02] p-5">
-              <div className="space-y-4">
-                {firmwareHealth.length > 0 ? (
-                  firmwareHealth.map((item) => (
-                    <div key={item.firmware} className="flex items-center justify-between">
-                      <div>
-                        <div className="text-sm font-medium text-white">{item.firmware}</div>
-                        <div className="text-xs text-[#71717A]">{item.count} 台设备</div>
-                      </div>
-                      <div className="text-right">
-                        <div className="text-sm tabular-nums text-white">{formatPercentWithUnit(item.avgSoh)}</div>
-                        <div className="text-xs text-[#71717A]">平均健康度</div>
-                      </div>
-                    </div>
-                  ))
-                ) : (
-                  <div className="text-sm text-[#71717A]">暂无数据</div>
-                )}
-              </div>
-            </div>
-          </div>
-        </MotionSection>
-      </div>
-    </main>
-  )
-}

src/server/api/context.ts

@@ -1,3 +0,0 @@
-export interface BaseContext {
-  headers: Headers
-}

src/server/api/contracts/battery.contract.ts

@@ -1,35 +0,0 @@
-import { oc } from '@orpc/contract'
-import { z } from 'zod'
-import {
-  BATTERY_LIST_SORT,
-  BATTERY_LIST_SORT_VALUES,
-  batteriesResponseSchema,
-  dashboardSnapshotSchema,
-  POWER_STATUS,
-} from '@/domain/battery'
-
-export const dashboard = oc.input(z.void()).output(dashboardSnapshotSchema)
-
-const batteryListInputSchema = z.object({
-  pageSize: z.number().int().min(1).max(100).default(50),
-  cursor: z.string().min(1).max(1024).optional(),
-  search: z.preprocess(
-    (value) => (typeof value === 'string' ? value.trim() || undefined : value),
-    z.string().min(1).max(100).optional(),
-  ),
-  lowPower: z.boolean().optional(),
-  powerStatus: z
-    .union([z.literal(POWER_STATUS.NOT_CHARGING), z.literal(POWER_STATUS.CHARGING), z.literal(POWER_STATUS.FULL)])
-    .optional(),
-  sort: z.enum(BATTERY_LIST_SORT_VALUES).default(BATTERY_LIST_SORT.CREATED_AT_DESC),
-})
-
-export const batteries = oc.input(batteryListInputSchema).output(batteriesResponseSchema)
-
-export const history = oc
-  .input(
-    z.object({
-      mac: z.string().min(1),
-    }),
-  )
-  .output(batteriesResponseSchema)

src/server/api/routers/battery.router.ts

@@ -1,72 +0,0 @@
-import { createBatteriesResponse, createDashboardSnapshot, POWER_STATUS } from '@/domain/battery'
-import { os } from '@/server/api/server'
-import {
-  getBatteryHistory,
-  getBatteryPredictionHistories,
-  getLatestBatteryPage,
-  getLatestBatteryPerDevice,
-} from '@/server/battery/mysql'
-import { isPredictionEnabled, predictSoh } from '@/server/prediction/client'
-
-const dashboardPredictionConcurrency = 5
-
-async function mapWithConcurrency<T, R>(
-  items: T[],
-  concurrency: number,
-  handler: (item: T) => Promise<R>,
-): Promise<R[]> {
-  const results: R[] = []
-  let nextIndex = 0
-
-  async function worker() {
-    while (nextIndex < items.length) {
-      const index = nextIndex
-      nextIndex += 1
-      const item = items[index]
-      if (item !== undefined) results[index] = await handler(item)
-    }
-  }
-
-  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, worker))
-
-  return results
-}
-
-export const dashboard = os.battery.dashboard.handler(async () => {
-  const items = await getLatestBatteryPerDevice()
-  const predictionHistories = isPredictionEnabled()
-    ? await getBatteryPredictionHistories(items.map((item) => item.mac))
-    : new Map()
-  const predictionEntries = isPredictionEnabled()
-    ? await mapWithConcurrency(items, dashboardPredictionConcurrency, async (item) => {
-        const prediction = await predictSoh(item, predictionHistories.get(item.mac) ?? [])
-
-        return prediction ? ([item.mac, prediction] as const) : null
-      })
-    : []
-  const predictions = new Map(predictionEntries.filter((entry) => entry !== null))
-
-  return createDashboardSnapshot(items, new Date(), predictions)
-})
-
-export const batteries = os.battery.batteries.handler(async ({ input }) => {
-  const page = await getLatestBatteryPage(input)
-
-  return createBatteriesResponse(
-    page.items,
-    new Date(),
-    { total: page.total, lowPower: page.lowPower, charging: page.charging },
-    page.nextCursor,
-  )
-})
-
-export const history = os.battery.history.handler(async ({ input }) => {
-  const items = await getBatteryHistory(input.mac)
-
-  // History returns a limited window, so the counters must describe only this returned slice.
-  return createBatteriesResponse(items, new Date(), {
-    total: items.length,
-    lowPower: items.filter((item) => item.isLowPower).length,
-    charging: items.filter((item) => item.powerStatus === POWER_STATUS.CHARGING).length,
-  })
-})

src/server/api/routers/index.ts

@@ -1,6 +0,0 @@
-import { os } from '@/server/api/server'
-import * as battery from './battery.router'
-
-export const router = os.router({
-  battery,
-})

src/server/api/types.ts

@@ -1,5 +0,0 @@
-import type { ContractRouterClient, InferContractRouterOutputs } from '@orpc/contract'
-import type { Contract } from './contracts'
-
-export type RouterClient = ContractRouterClient<Contract>
-export type RouterOutputs = InferContractRouterOutputs<Contract>

src/server/battery/mysql.ts

@@ -1,332 +0,0 @@
-import mysql, { type Pool, type RowDataPacket } from 'mysql2/promise'
-
-import {
-  BATTERY_LIST_SORT,
-  type BatteryInfo,
-  type BatteryInfoSourceRow,
-  type BatteryListSort,
-  MYSQL_BOOLEAN,
-  POWER_STATUS,
-  type PowerStatus,
-  toBatteryInfo,
-  toMysqlBoolean,
-} from '@/domain/battery'
-import { env } from '@/env'
-
-const historyLimit = 500
-const predictionHistoryLimit = 10
-type BatteryInfoMysqlRow = RowDataPacket & BatteryInfoSourceRow
-type CountMysqlRow = RowDataPacket & {
-  total: number
-  lowPower: number | string | null
-  charging: number | string | null
-}
-
-export type LatestBatteryPageInput = {
-  pageSize: number
-  cursor?: string
-  search?: string
-  lowPower?: boolean
-  powerStatus?: PowerStatus
-  sort?: BatteryListSort
-}
-
-export type LatestBatteryPage = {
-  items: BatteryInfo[]
-  nextCursor: string | null
-  total?: number
-  lowPower?: number
-  charging?: number
-}
-
-type PageCursor = {
-  sort: BatteryListSort
-  createTime: string
-  id: number
-  power?: number
-}
-
-let pool: Pool | undefined
-
-function getBatteryPool() {
-  pool ??= mysql.createPool({
-    uri: env.DATABASE_URL,
-    waitForConnections: true,
-    connectionLimit: 5,
-    namedPlaceholders: true,
-    dateStrings: true,
-  })
-
-  return pool
-}
-
-export async function closeBatteryPool() {
-  if (!pool) return
-
-  await pool.end()
-  pool = undefined
-}
-
-const sourceColumns = `
-  id,
-  user_id AS userId,
-  mac,
-  dev_model AS devModel,
-  dev_name AS devName,
-  is_low_power AS isLowPower,
-  power_status AS powerStatus,
-  power,
-  create_time AS createTime,
-  remark
-`
-
-const normalizedColumns = `
-  id,
-  userId,
-  mac,
-  devModel,
-  devName,
-  isLowPower,
-  powerStatus,
-  power,
-  createTime,
-  remark
-`
-
-const latestRecordPredicate = `
-  NOT EXISTS (
-    SELECT 1
-    FROM ls_battery_info AS newer_record
-    WHERE newer_record.mac = current_record.mac
-      AND (
-        newer_record.create_time > current_record.create_time
-        OR (newer_record.create_time = current_record.create_time AND newer_record.id > current_record.id)
-      )
-  )
-`
-
-const orderByBySort: Record<BatteryListSort, string> = {
-  [BATTERY_LIST_SORT.CREATED_AT_DESC]: 'current_record.create_time DESC, current_record.id DESC',
-  [BATTERY_LIST_SORT.CREATED_AT_ASC]: 'current_record.create_time ASC, current_record.id ASC',
-  [BATTERY_LIST_SORT.POWER_DESC]: 'current_record.power DESC, current_record.create_time DESC, current_record.id DESC',
-  [BATTERY_LIST_SORT.POWER_ASC]: 'current_record.power ASC, current_record.create_time DESC, current_record.id DESC',
-}
-
-function toNumber(value: number | string | null | undefined) {
-  if (value === null || value === undefined) return 0
-  return Number(value)
-}
-
-function encodeCursor(item: BatteryInfo, sort: BatteryListSort) {
-  const cursor: PageCursor = {
-    sort,
-    createTime: item.createTime,
-    id: item.id,
-    power: sort === BATTERY_LIST_SORT.POWER_ASC || sort === BATTERY_LIST_SORT.POWER_DESC ? item.power : undefined,
-  }
-
-  return Buffer.from(JSON.stringify(cursor)).toString('base64url')
-}
-
-function decodeCursor(value: string | undefined, sort: BatteryListSort): PageCursor | null {
-  if (!value) return null
-
-  try {
-    const decoded = JSON.parse(Buffer.from(value, 'base64url').toString('utf8')) as Partial<PageCursor>
-    if (decoded.sort !== sort || typeof decoded.createTime !== 'string' || typeof decoded.id !== 'number') return null
-    if (
-      (sort === BATTERY_LIST_SORT.POWER_ASC || sort === BATTERY_LIST_SORT.POWER_DESC) &&
-      typeof decoded.power !== 'number'
-    ) {
-      return null
-    }
-
-    return decoded as PageCursor
-  } catch {
-    return null
-  }
-}
-
-function escapeLike(value: string) {
-  return value.replace(/[\\%_]/g, (match) => `\\${match}`)
-}
-
-function normalizeCursorDateTime(value: string) {
-  return value.includes('T') ? value.slice(0, 19).replace('T', ' ') : value
-}
-
-function createLatestWhere(input: LatestBatteryPageInput, cursor: PageCursor | null) {
-  const clauses = [latestRecordPredicate]
-  const params: Record<string, string | number> = {}
-
-  if (input.search) {
-    clauses.push(
-      "(current_record.mac LIKE :search ESCAPE '\\\\' OR current_record.dev_name LIKE :search ESCAPE '\\\\' OR current_record.dev_model LIKE :search ESCAPE '\\\\')",
-    )
-    params.search = `%${escapeLike(input.search)}%`
-  }
-
-  if (input.lowPower !== undefined) {
-    clauses.push('LOWER(TRIM(current_record.is_low_power)) = :lowPower')
-    params.lowPower = toMysqlBoolean(input.lowPower)
-  }
-
-  if (input.powerStatus !== undefined) {
-    clauses.push('current_record.power_status = :powerStatus')
-    params.powerStatus = input.powerStatus
-  }
-
-  if (cursor) {
-    params.cursorCreateTime = normalizeCursorDateTime(cursor.createTime)
-    params.cursorId = cursor.id
-
-    switch (input.sort ?? BATTERY_LIST_SORT.CREATED_AT_DESC) {
-      case BATTERY_LIST_SORT.CREATED_AT_ASC:
-        clauses.push(
-          '(current_record.create_time > :cursorCreateTime OR (current_record.create_time = :cursorCreateTime AND current_record.id > :cursorId))',
-        )
-        break
-      case BATTERY_LIST_SORT.POWER_DESC:
-        params.cursorPower = cursor.power ?? 0
-        clauses.push(
-          '(current_record.power < :cursorPower OR (current_record.power = :cursorPower AND (current_record.create_time < :cursorCreateTime OR (current_record.create_time = :cursorCreateTime AND current_record.id < :cursorId))))',
-        )
-        break
-      case BATTERY_LIST_SORT.POWER_ASC:
-        params.cursorPower = cursor.power ?? 0
-        clauses.push(
-          '(current_record.power > :cursorPower OR (current_record.power = :cursorPower AND (current_record.create_time < :cursorCreateTime OR (current_record.create_time = :cursorCreateTime AND current_record.id < :cursorId))))',
-        )
-        break
-      case BATTERY_LIST_SORT.CREATED_AT_DESC:
-        clauses.push(
-          '(current_record.create_time < :cursorCreateTime OR (current_record.create_time = :cursorCreateTime AND current_record.id < :cursorId))',
-        )
-        break
-    }
-  }
-
-  return { whereSql: clauses.map((clause) => `(${clause})`).join(' AND '), params }
-}
-
-export async function getBatteryHistory(mac: string): Promise<BatteryInfo[]> {
-  const [rows] = await getBatteryPool().query<BatteryInfoMysqlRow[]>(
-    `
-      SELECT ${sourceColumns}
-      FROM ls_battery_info
-      WHERE mac = :mac
-      ORDER BY create_time DESC, id DESC
-      LIMIT :limit
-    `,
-    { mac, limit: historyLimit },
-  )
-
-  return rows.map(toBatteryInfo)
-}
-
-export async function getBatteryPredictionHistory(mac: string): Promise<BatteryInfo[]> {
-  const [rows] = await getBatteryPool().query<BatteryInfoMysqlRow[]>(
-    `
-      SELECT ${sourceColumns}
-      FROM ls_battery_info
-      WHERE mac = :mac
-      ORDER BY create_time DESC, id DESC
-      LIMIT :limit
-    `,
-    { mac, limit: predictionHistoryLimit },
-  )
-
-  return rows.map(toBatteryInfo).reverse()
-}
-
-export async function getBatteryPredictionHistories(macAddresses: string[]): Promise<Map<string, BatteryInfo[]>> {
-  if (macAddresses.length === 0) return new Map()
-
-  const params = Object.fromEntries(macAddresses.map((mac, index) => [`mac${index}`, mac]))
-  const placeholders = macAddresses.map((_, index) => `:mac${index}`).join(', ')
-  const [rows] = await getBatteryPool().query<BatteryInfoMysqlRow[]>(
-    `
-      SELECT ${normalizedColumns}
-      FROM (
-        SELECT
-          ${sourceColumns},
-          ROW_NUMBER() OVER (PARTITION BY mac ORDER BY create_time DESC, id DESC) AS history_rank
-        FROM ls_battery_info
-        WHERE mac IN (${placeholders})
-      ) AS ranked_history
-      WHERE ranked_history.history_rank <= :limit
-      ORDER BY ranked_history.mac ASC, ranked_history.createTime ASC, ranked_history.id ASC
-    `,
-    { ...params, limit: predictionHistoryLimit },
-  )
-
-  const histories = new Map<string, BatteryInfo[]>()
-  for (const item of rows.map(toBatteryInfo)) {
-    histories.set(item.mac, [...(histories.get(item.mac) ?? []), item])
-  }
-
-  return histories
-}
-
-export async function getLatestBatteryPage(input: LatestBatteryPageInput): Promise<LatestBatteryPage> {
-  const sort = input.sort ?? BATTERY_LIST_SORT.CREATED_AT_DESC
-  const pageSize = Math.min(Math.max(input.pageSize, 1), 100)
-  const cursor = decodeCursor(input.cursor, sort)
-  const { whereSql, params } = createLatestWhere({ ...input, sort, pageSize }, cursor)
-  const countWhere = createLatestWhere({ ...input, sort, pageSize }, null)
-  const queryLimit = pageSize + 1
-
-  const [rows] = await getBatteryPool().query<BatteryInfoMysqlRow[]>(
-    `
-      SELECT ${sourceColumns}
-      FROM ls_battery_info AS current_record
-      WHERE ${whereSql}
-      ORDER BY ${orderByBySort[sort]}
-      LIMIT :limit
-    `,
-    { ...params, limit: queryLimit },
-  )
-
-  const pageItems = rows.slice(0, pageSize).map(toBatteryInfo)
-  const lastPageItem = pageItems.at(-1)
-  const nextCursor = rows.length > pageSize && lastPageItem ? encodeCursor(lastPageItem, sort) : null
-
-  const [countRows] = await getBatteryPool().query<CountMysqlRow[]>(
-    `
-      SELECT
-        COUNT(*) AS total,
-        COALESCE(SUM(CASE WHEN LOWER(TRIM(current_record.is_low_power)) = '${MYSQL_BOOLEAN.TRUE}' THEN 1 ELSE 0 END), 0) AS lowPower,
-        COALESCE(SUM(CASE WHEN current_record.power_status = ${POWER_STATUS.CHARGING} THEN 1 ELSE 0 END), 0) AS charging
-      FROM ls_battery_info AS current_record
-      WHERE ${countWhere.whereSql}
-    `,
-    countWhere.params,
-  )
-  const counts = countRows[0]
-
-  return {
-    items: pageItems,
-    nextCursor,
-    total: toNumber(counts?.total),
-    lowPower: toNumber(counts?.lowPower),
-    charging: toNumber(counts?.charging),
-  }
-}
-
-export async function getLatestBatteryPerDevice(limit?: number): Promise<BatteryInfo[]> {
-  const appliedLimit = typeof limit === 'number' && limit > 0 ? limit : undefined
-  const limitSql = appliedLimit ? '\n    LIMIT :limit' : ''
-  const queryParams = appliedLimit ? { limit: appliedLimit } : {}
-
-  const [rows] = await getBatteryPool().query<BatteryInfoMysqlRow[]>(
-    `
-    SELECT ${sourceColumns}
-    FROM ls_battery_info AS current_record
-    WHERE ${latestRecordPredicate}
-    ORDER BY current_record.create_time DESC, current_record.id DESC${limitSql}
-  `,
-    queryParams,
-  )
-
-  return rows.map(toBatteryInfo)
-}

src/server/logger.ts

@@ -1,19 +0,0 @@
-import { configureSync, getConfig, getConsoleSink, getJsonLinesFormatter } from '@logtape/logtape'
-import { prettyFormatter } from '@logtape/pretty'
-import { env } from '@/env'
-
-if (getConfig() === null) {
-  const format = env.LOG_FORMAT ?? (process.stdout.isTTY ? 'pretty' : 'json')
-
-  configureSync({
-    sinks: {
-      console: getConsoleSink({ formatter: format === 'pretty' ? prettyFormatter : getJsonLinesFormatter() }),
-    },
-    loggers: [
-      { category: [], lowestLevel: env.LOG_LEVEL, sinks: ['console'] },
-      { category: ['logtape', 'meta'], lowestLevel: 'warning', sinks: ['console'], parentSinks: 'override' },
-    ],
-  })
-}
-
-export { getLogger } from '@logtape/logtape'