patrol — 面向制造与实体企业的设备日常运维平台:覆盖点检、巡检、报修维修、保养与备件,一设备一码一档。
灵策云设备管理与巡检用一套系统承载制造企业与实体企业的设备日常运维,目标是设备全生命周期一体化监管:巡检与保养规范化、故障早发现早处理、处置过程全程留痕。
围绕这个目标,产品按“先建资料、再录设备、后跑单据”的顺序组织:
| 分组 | 模块 | 职责 |
|---|---|---|
| 基础资料 | 设备类型、车间、安装地点、供应商、仓库、备件信息 | 各单据下拉与关联数据的来源,先建资料再录设备 |
| 设备档案 | 设备档案 | 一设备一档一码,汇总点检、巡检、维修、报废、保养、备件更换与变动历史 |
| 标准 | 点检标准、巡检方案、保养等级与频次 | 挂在设备上,开单时按设备编号自动带出检查项 |
| 执行 | 设备点检单、设备巡检单 | 按计划或扫码发起,记录逐项检查结果、现场照片与异常描述 |
| 处理 | 设备维修单、设备报废单 | 报修→派工→维修→验收(不通过回退重新派工);报废需多级审批 |
| 保养 | 保养计划表、设备保养单 | 计划按频次自动下发保养单,无需手工开单 |
| 备件 | 备件入库单、备件领用单 | 入库台账,以及维修与保养时的备件领用记录 |
| 分析 | 设备状态明细、结果统计 | 设备当前状态、巡检完成率、漏检与维修时效 |
三条贯穿全局的设计约束:
- 设备状态是枢纽。点检、巡检、派工、保养完成、报废都会回写设备档案的状态与“最近一次”时间字段,因此状态流转必须收敛在一处,不能散落在各单据的提交逻辑里。
- 扫码即入口。设备标识牌上的二维码直达该设备的点检、巡检、报修,避免现场人员翻列表找人找设备。
- 档案是单据的聚合视图。每次操作都是一次带留痕的单据提交,档案只负责汇总与展示,不作为录入主体。
主要使用者是巡检人员、设备管理员、维修主管与设备部门负责人。适用边界是日常运维;点检标准库、备件库存、OEE 等更重的专业设备管理体系需要在此基础上扩展。
当前进度:脚手架阶段。路由、鉴权、数据库接入已就绪,上表业务模块尚未实现。
| 层 | 选型 |
|---|---|
| 框架 | React 19 + TanStack Start(SSR / Server Functions) |
| 路由 | TanStack Router(文件式路由,src/routes) |
| 样式 | Tailwind CSS v4 + shadcn/ui 组件(src/components/ui) |
| 数据库 | SQLite + Drizzle ORM(better-sqlite3 驱动) |
| 鉴权 | Better Auth(邮箱密码,cookie 集成 TanStack Start) |
| 部署 | Nitro(通用 Node 适配器,输出自包含服务) |
| 可观测 | Sentry(错误采集 + Server Function 埋点) |
| 工程 | TypeScript、Vite 8、ESLint 9、Prettier、pnpm |
需要 Node ≥ 22.12(Vite 8 的最低要求;20.19+ 亦可)与 pnpm 10。
pnpm install1. 配置环境变量 — .env.local 中三个必需项:
| 变量 | 说明 |
|---|---|
DATABASE_URL |
SQLite 文件路径,本地默认 dev.db |
BETTER_AUTH_SECRET |
会话签名密钥,用 pnpm dlx @better-auth/cli secret 生成 |
BETTER_AUTH_URL |
应用地址,本地为 http://localhost:3000 |
VITE_SENTRY_DSN / VITE_SENTRY_ORG / VITE_SENTRY_PROJECT / SENTRY_AUTH_TOKEN 可留空,本地开发只会收到警告。
2. 建库
pnpm db:push # 将 src/db/schema.ts 同步到 dev.db3. 启动
pnpm dev # http://localhost:3000dev 脚本通过 dotenv-cli 加载 .env.local,并预加载 instrument.server.mjs 以初始化 Sentry。
注意:
src/lib/auth.ts目前未配置database,用户数据不会落库。接入 SQLite 需在betterAuth({ ... })中传入drizzleAdapter(db, { provider: 'sqlite' })。
src/
├─ routes/ # 文件式路由;__root.tsx 是全局外壳,api/ 放服务端端点
├─ components/ui/ # shadcn/ui 原语,vendored,勿手改(lint/format 已排除)
├─ db/ # schema.ts 定义表结构,index.ts 导出 drizzle 实例
├─ lib/ # auth(服务端)、auth-client(浏览器)、工具函数
├─ hooks/ # 通用 React hooks
├─ integrations/ # 第三方集成的 UI 片段(如 better-auth 的头部用户菜单)
├─ router.tsx # 路由实例,Sentry 错误采集入口
└─ styles.css # Tailwind 入口与主题变量
| 命令 | 作用 |
|---|---|
pnpm dev |
开发服务器(3000 端口,加载 .env.local) |
pnpm build |
生产构建到 .output/,并拷贝 instrument.server.mjs |
pnpm start |
以生产模式运行 .output/server/index.mjs |
pnpm typecheck |
tsc --noEmit |
pnpm lint / pnpm lint:fix |
ESLint(含类型感知规则) |
pnpm format / pnpm format:check |
Prettier |
pnpm db:generate |
依据 schema 生成迁移文件 |
pnpm db:migrate |
执行迁移 |
pnpm db:push |
直接把 schema 推到数据库(开发用) |
pnpm db:studio |
打开 Drizzle Studio |
CI(.github/workflows/ci.yml)在 push 到 main 和所有 PR 上运行 lint、format:check、typecheck 与 build。
构建产物是自包含的 Node 服务:
pnpm build
pnpm start把 .output/ 推送到任意 Node 主机(Render、Fly.io、自有 VPS)即可。其他平台预设见 Nitro 部署文档。
生产环境务必设置 BETTER_AUTH_URL 为真实域名,否则会话 cookie 域不匹配。