admin/charging-cabinet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
92 Commits 1 Branch 0 Tags
Commit Graph

28 Commits

Author SHA1 Message Date
12451
8e7435005e refactor(landing): 改为全屏主视觉 + 毛玻璃文案面板（消除"贴图硬边"） 
## 问题

分栏布局里，产品图是 4:3 矩形、自带浅灰蓝背景，贴在页面白底上有一道
**明显的竖直硬边**；上一提交用径向遮罩缓解了，但本质上"图在盒子里"这个
结构仍会让人觉得过渡生硬（用户指出，并建议：做成一张全图，左边没内容或
少量内容，或者左边用毛玻璃、背后能稍微看到内容）。

## 方案（按用户建议）

**一张全图做底 + 左侧毛玻璃面板**，从结构上消除"过渡"这件事：

1. **重新生成主视觉图**（Agnes Image 图生图，2K 16:9）：
   - 柜子置于画面**右侧约四成**，左侧约六成是**纯净负空间**（无物体/阴影/文字）
   - ⛔ 明确声明画面内**不出现任何文字、数字、字母、水印、logo**
     （v1 的教训：提示词里写了十六进制色值和"36"，模型把它们**当文字画进了图里**，
     左侧出现"36 智能充电电柜 / #0366e6"。故颜色只描述为"品牌蓝"，绝不写 hex）
2. **全屏背景**：`.bg` 用 `background-size: cover` 铺满视口（保持宽高比、永不变形）
3. **左侧白纱**：`.bg::after` 叠一层从左到右渐淡的白色轻纱，保证文字对比度
4. **毛玻璃面板**（核心）：
   ```css
   background: rgba(255,255,255,0.58);
   backdrop-filter: blur(26px) saturate(1.5);
   border: 1px solid rgba(255,255,255,0.72);
   border-radius: 22px;
   box-shadow: 0 24px 60px rgba(15,20,25,0.10), inset 0 1px 0 rgba(255,255,255,0.85);
   ```
   背后的柜子与渐变会**隐约透出**，边界从"贴图的硬边"变成"玻璃的质感"。

## 清理

- 删除 `deploy/landing/hero.jpg`（分栏布局废弃，146KB）
- 删除 `.hero` / `.hero::before` / `.hero img` 全部 CSS 与 HTML（含此前的 mask 方案）
- 媒体查询改为：窄屏收紧面板宽度、减弱白纱让图更多露出

## 文件

| 文件 | 变化 |
|---|---|
| `deploy/landing/hero-full.jpg` | 新增（1920×1077，114.7KB） |
| `deploy/landing/index.html` | 全屏背景 + 毛玻璃面板；删 hero 相关 |
| `deploy/landing/hero.jpg` | **删除** |

## 实测（发布后打真实 URL）

```
200  114.7KB image/jpeg    hero-full.jpg
200   68.6KB image/jpeg    og-image.jpg
200   21.1KB image/svg+xml favicon.svg
200   12.3KB image/svg+xml logo.svg
404  text/html             hero.jpg      （已删）
```
HTML 已确认含 `background: url("hero-full.jpg")`、两条 `backdrop-filter`、
`<div class="copy">`，且不再有 `class="hero"` / `mask-image`。

## 备注

生成按 Agnes **串行**要求执行：全程一次一个任务（v1 失败 → v2 成功）。
 2026-09-21 03:09:26 +08:00
12451
a3b14e9cb8 fix(landing): 产品图硬边框融进页面白底（径向遮罩） 
## 问题

上一提交把产品图换成分栏布局后，图片是 4:3 矩形、自带浅灰蓝渐变背景，
贴在页面白底上出现一道**明显的竖直硬边** —— 柜子像被"贴"上去而不是融在页面里。
（用户看截图指出"这个过渡很突然"。）

## 修法

给 `.hero img` 加**径向渐变遮罩**，让中心（柜体）保持不透明、四缘渐变透明：

```css
-webkit-mask-image: radial-gradient(ellipse 72% 86% at 50% 50%, #000 58%, transparent 92%);
mask-image: radial-gradient(ellipse 72% 86% at 50% 50%, #000 58%, transparent 92%);
```

椭圆半径按**柜体在画面里的实际占比**取（约占宽 50%、高 84%），
因此柜体完全落在实心区内不受影响，只有图片自身的背景在边缘处化开。

同时**移除 CSS `drop-shadow`**：遮罩会把它一起切掉，导致影子被拦腰截断；
且这张图自带地面投影，CSS 投影本来也是多余的。

不改图片本身、不重新生成 —— 纯 CSS，随时可调。

## 实测

线上 HTML 已确认含两条 `mask-image`（含 `-webkit-` 前缀）且不再有 `drop-shadow`；
`hero.jpg` / `og-image.jpg` / `favicon.svg` / `logo.svg` 均 200 正常。
 2026-09-21 02:37:22 +08:00
12451
fe5eaa51c4 feat(landing): 首页主图升级 + 补 og:image 社交分享图（用 Agnes Image 生成） 
## 主图：906KB 平淡白底照 → 146KB 影棚级产品图

原 `hero-bg.png` 是 1312×736 的产品照，柜子偏在画面右侧、左侧大片死白，
且被 `background-size:100% 100%` 横向拉伸 34%（见上一提交的分栏改造）。

本次用 **Agnes Image 2.5 Flash 图生图**升级：
- 输入：原图压缩到 1024 宽（51KB）作 Data URI
- 提示词：保持 6×6 共 36 仓的矩阵布局（**产品规格是真的，不能改**），
  柜体居中构图，换成干净现代的商业影棚环境，品牌蓝 #0366e6 轮廓光，
  玻璃仓门反光、地面投影与倒影，明亮浅色基调
- 输出 2K 4:3（2304×1728）→ 压到 1800 宽 JPEG q87 = **145.9KB**

## og:image：从缺失到补齐

原页面**完全没有** og/Twitter 元信息 —— 链接被分享到微信/Twitter 时没有预览图。
现补全 `og:type/site_name/title/description/image/url` + `twitter:card=summary_large_image`
等，配图用 2K 16:9 生成后压到标准 1200×630 = 68.6KB。

## 文件

| 文件 | 变化 |
|---|---|
| `deploy/landing/hero.jpg` | 新增（145.9KB，1800×1350） |
| `deploy/landing/og-image.jpg` | 新增（68.6KB，1200×673） |
| `deploy/landing/index.html` | 主图 `hero-bg.png`→`hero.jpg`；补 og/Twitter 元信息 |
| `deploy/landing/hero-bg.png` | **删除**（905.9KB，已无人引用） |

首屏图片总体积：905.9KB → **214.5KB**（-76%）。

## 实测（发布后打真实 URL）

```
200  145.9KB image/jpeg   app.anzhizhichong.com/hero.jpg
200   68.6KB image/jpeg   app.anzhizhichong.com/og-image.jpg
200   21.1KB image/svg+xml favicon.svg
200   12.3KB image/svg+xml logo.svg
404  text/html            hero-bg.png   （文件确已删除）
```
HTML 已确认引用 `hero.jpg` 且含 `og:image` / `twitter:card`。

## 过程中修掉的 CLI 缺陷

生成时撞到 Windows **进程命令行 32KB 上限**（Data URI base64 走参数直接 `WinError 206`）。
已给两个 CLI 补上本地文件入参：`--image-file`（图像）、
`--image-file`/`--first-frame-file`/`--last-frame-file`/`--audio-file`（视频），
内部转 Data URI，不再走命令行。

## 备注

生成按 Agnes 的**串行**要求执行：两个任务一次一个，顺序完成（主图 → og 图）。
 2026-09-21 02:31:55 +08:00
12451
318501d6e7 feat: 全站统一横版锁标（官网页头 + 管理端登录页改用 logo.svg） 
## 背景

上一提交把官网页头换成了**方形**品牌图标（favicon.svg）+ 文字 span，
用户指出仓库里本就有**横版带字样**的锁标 —— 确实有：
`logo/纯色横向.svg`（12.4KB）与 `logo/纯色横向@2x.png`（74.7KB）。

**重要发现**：`logo/纯色横向@2x.png` 与 `software/web/public/logo.png`
**是同一个文件**（SHA256 均为 `8E40298E…`、76523 B、3025×829）——
即管理端登录页早就在用这套设计，只是 PNG 拷贝，且我此前没认出来。

## 改动

新增 `logo.svg`（由 `logo/纯色横向.svg` 机械变换，**渲染零差异**）：

1. `<style>` 的 class 上色 → 内联 `fill`（14 处）；
2. 中文 id（`图层_2`/`图层_1-2`）→ ASCII；`data-name` 元数据删除；
3. 删 `<style>` 与空掉的 `<defs>`；加 `<title>`。

> 该 SVG 的 `<text>` 元素数为 **0** —— "艾动智能"字样**已转为路径**，
> 无字体依赖，任何环境渲染都一致。

落点：

| 位置 | 改动 |
|---|---|
| `deploy/landing/logo.svg` | 新增；官网页头 `<img src="logo.svg">` |
| `deploy/landing/index.html` | 删掉 `<span class="top-name">`（字样已在锁标里，否则重复）及失效的 `.top-name` CSS |
| `software/web/public/logo.svg` | 新增；`Login.tsx` 由 `logo.png` 改指 `logo.svg` |
| `software/web/public/logo.png` | **删除**（全仓已无引用，74.7KB 死文件） |

## 渲染等价验证

resvg 逐像素比对（600×164）：**393600 字节零差异**。

## 实测（发布后打真实 URL）

```
200  21.1KB  app.anzhizhichong.com/favicon.svg       （tab 图标，方形变体）
200  12.3KB  app.anzhizhichong.com/logo.svg          （官网页头）
200  12.3KB  app.anzhizhichong.com/pms/logo.svg      （管理端登录页·生产）
200  12.3KB  test.anzhizhichong.com/pms/logo.svg     （管理端登录页·测试）
200  21.1KB  test.anzhizhichong.com/pms/favicon.svg
```
三处 logo.svg 均确认含 `<title>艾动智能</title>` 与 `fill="#0366e6"` 路径。

## 一个差点误判的"异常"

`/pms/logo.png` 返回 **HTTP 200**，一度以为旧文件没删掉。
实测其 `Content-Type` 是 **`text/html`**、0.47KB（内容是 index.html）——
nginx `location /pms/` 配了 `try_files $uri $uri/ /pms/index.html`（SPA 回退），
**任何**不存在路径都返回 200。对照测试：访问一个肯定不存在的
`/pms/definitely-not-exist-xyz.png` 同样 200 + index.html。
服务器目录实测已无 `logo.png`。**是 404 的预期写错了，不是文件没删。**

## 验收

- `npm run typecheck`：exit 0
- `npm run build`：exit 0，产物仅 `logo.svg`（12.3KB，无 logo.png）
- 已发布：生产（web + 官网）、测试（web）
- 生产 0 ERROR、域名 401/200；nginx `nginx -t` 通过后 reload
 2026-09-21 01:24:58 +08:00
12451
8df2c0c7a0 feat(landing): 官网页头 logo 换成品牌图标（与 favicon 同源） 
## 背景

上一提交给全站上了 favicon（取自 `logo/圆切独立LOGO.svg`），但官网页头左上角
仍在用 `logo-1.png` —— 那是一套**不同的设计**（蓝圆角柜 + 6 节电池 + 侧把手/底脚），
与品牌图标（柜顶闪电 + 白色大圆弧）不是同一个图形，全站风格不统一。

## 改动

`deploy/landing/index.html`：
- `<img class="logo" src="logo-1.png">` → `<img class="logo" src="favicon.svg">`
  —— **直接用 favicon 同一个文件**，不再复制第二份，从机制上保证两处不会不一致；
- `.logo` 加 `border-radius: 10px`：品牌图标是满幅方形（本身无圆角），
  48px 下加一点圆角更像 app 图标，不至于是一块硬方块。

## 顺带核对（未改动）

- **管理端登录页** `web/public/logo.png` 是**横版锁标**（同一品牌图形 +
  "艾动智能"字样，蓝字白底）—— 与品牌图标同源，只是配色/版式不同；
  登录页单独居中用横版合理，**保持不动**。
- **小程序**无 favicon/页头 logo 概念（tabBar 图标是另一套 PNG），不适用。

## 实测

线上 HTML 已确认变更：
```
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
border-radius: 10px;
<img class="logo" src="favicon.svg" alt="艾动智能">
```
`favicon.svg` 仍 200 / 21.1KB；nginx `nginx -t` 通过后 reload。

## 可选的后续清理（未做，等你决定）

`deploy/landing/` 下这些文件**已无任何引用**（`index.html` 里只剩
`favicon.svg` 与 CSS 背景 `hero-bg.png`）：
`logo-1.png`(398KB) / `logo-2.png`(374KB) / `logo-3.png`(471KB) / `cabinet.png`(1MB)
—— 要不要一并删掉（含线上 `/data/landing/`）？
 2026-09-21 01:07:25 +08:00
12451
2aa002ca02 feat: 全站统一 favicon.svg（取自品牌 logo，替换 Vite 模板紫色闪电） 
## 背景

- `software/web/public/favicon.svg` 一直是 **Vite/Arco 模板自带的紫色闪电**
  （`#863bff`），与项目品牌无关；
- 官网 `deploy/landing/index.html` **完全没有 favicon 引用**；
- 仓库里本来就有品牌 logo：`logo/圆切独立LOGO.svg`（蓝色渐变底 + 白色充电柜
  6 仓 + 柜顶青色闪电 + 右侧白色圆弧 + 底部青色弧线）。

## 做法

新增规范文件 `logo/favicon.svg`，由 `圆切独立LOGO.svg` **机械变换**而来
（不改任何路径数据）：

1. `<style>` 里的 class 上色 → **内联成 `fill`/`opacity` 属性**（favicon 渲染器
   对 SVG 内 CSS 支持不一，内联更稳）；
2. 渐变 ID `未命名的渐变_5`（中文）→ **`lgBrandBlue`**（ASCII）
   （`url(#中文)` 在部分渲染链路上会断）；
3. 删掉 `<style>` 块；
4. 加 `<title>艾动智能 · 充电柜</title>`。

变换前后**渲染等价已用 resvg 逐像素验证**：
- 16px / 32px（favicon 真实尺寸）：**逐字节一致**；
- 256px：262144 字节中 3 字节不同，且集中在**同一个抗锯齿边界像素** (173,46)，
  最大单通道差 9/255 —— 渐变舍入，视觉无差异。

## 落点

| 位置 | 改动 |
|---|---|
| `logo/favicon.svg` | 新增（规范源） |
| `software/web/public/favicon.svg` | 覆盖（管理端；`index.html` L5 已有 `<link rel="icon">`，无需改） |
| `deploy/landing/favicon.svg` | 新增 |
| `deploy/landing/index.html` | 补 `<link rel="icon" type="image/svg+xml" href="/favicon.svg" />` |

**小程序（h5-uniapp）不适用**：微信小程序没有浏览器 favicon 概念
（无 HTML 入口，实测 `src/` 下无 index.html）；tabBar 图标是另一套 PNG，不属 favicon。

## 实测（发布后打真实 URL）

```
app.anzhizhichong.com/favicon.svg        → 200 image/svg+xml 21.1KB  新logo ✓
app.anzhizhichong.com/pms/favicon.svg    → 200 image/svg+xml 21.1KB  新logo ✓
test.anzhizhichong.com/pms/favicon.svg   → 200 image/svg+xml 21.1KB  新logo ✓
```
三处均确认**无旧模板紫色残留**（`863bff`）。

`test.anzhizhichong.com/favicon.svg` 返回 404 是**预期**：测试域名 nginx
`root /data/pms_dev`，官网只挂生产域名。

## 验收

- `npm run build`：exit 0，产物含新 favicon.svg（21.1KB）
- 已发布：生产（web + 官网 favicon/index.html）、测试（web）
- nginx `nginx -t` 通过后 reload；生产 0 ERROR、域名 401/200
 2026-09-21 00:54:39 +08:00
12451
471b61d277 fix(test)+fix(deploy)+docs: 探针状态语义反转修复、退出码补齐、文档校订 
1) probe_export.py：任务状态语义**搞反了**（导出成功也会被判失败）
   - download_tasks.status 的权威语义是 0 排队 / 1 处理中 / **2 完成** / 3 失败
     （db/migrate.rs:225 列注释；写入侧 charge_records.rs::mark_task_completed 写的就是 2）。
   - 该脚本此前**等 status == 1（处理中）当成功、把 status == 2（完成）判成"导出失败"**
     —— 典型假红。已按权威语义订正，并与另外两处**本来就正确**的口径对齐：
     web/src/pages/charge-records/DownloadCenter.tsx::statusText、
     test/schema_alignment_e2e.py（等 status in (2,3) 再断言 == 2）。
   - 同批修正退出码分类：账号缺 charge_record:export（403）由 exit 1 改为
     **exit 2「未验证」** —— 本项要验证的是"降权成 pms 后能否往 exports/ 落盘"，
     没权限根本走不到那一步，报 1 是**把夹具缺陷说成产品缺陷**（误报与假绿同样有害）。
   - 允许用 PMS_PROBE_PHONE / PMS_PROBE_PASSWORD 换成有权限的账号。
   - **C 项结论（由落盘物证直接判定，不依赖该脚本）**：测试环境
     exports/充电记录__-.xlsx 5559 B、生产同类产物 5457 B，属主均为 pms:pms；
     两环境 exports/uploads 目录均 pms:pms，两 api-server 单元均 User=pms/Group=pms
     ⇒ 降权进程确实能落盘。已在 README 写明并给出取证依据。

2) deploy-prod.ps1 的退出码（此前失败的探针只打印 ❌ 就继续，脚本仍以 0 退出）
   - 消费链路探测失败（exit 1）现在**记入失败清单**并以 exit 1 收尾；
     "未验证"（隧道没起）默认仍不计失败（环境问题会误报），
     但新增 **-StrictVerify** 开关供 CI/无人值守使用，打开即 exit 1。
   - 好处：把这条从"打印了 ❌ 却 exit 0"（仓库第 8 条假绿）里摘出来。

3) 统一退出码 0/1/2 落地到本批脚本，并对每个失败路径实测取证：
   - test/tcp_e2e_smoke.py：13/13 通过（含未登录业务报文被静默丢弃）；先复位夹具再跑。
   - test/security-hardening/ 新增 verdict.py 判据容器（未跟踪 → 本次入库）；
     4 个探针全部按失败→exit 1 改造，并各实测过失败路径。
   - 实测结果（2026-09-20 发布后回归）：smoke_prod 4/4 exit 0、
     probe_prod 5/5 exit 0、probe_upload 6/6 exit 0。

4) 工具与文档
   - tools/db.py 默认库由**生产 pms 改为测试 pms_dev**（可用 PMS_MYSQL_DB 覆盖，
     切生产时打印醒目警告）—— "以为在测测试库、实际打生产"的隐患。
   - tools/db_schema_diff.py：连不上必须是 exit 2，绝不伪装成"无漂移"的 0。
   - 新增 tools/dev-tunnel.ps1（入库，SSH 隧道；口令走 PMS_SSH_PASSWORD 环境变量），
     配套 tools/dev-tunnel-run.ps1 自愈启动器**保持 gitignore**（内含口令）。
   - deploy/nginx/nginx.conf 镜像随线上同步（移除 stream 转发；与线上逐字节一致）。
   - AGENTS.md / README.md：补「踩过的坑」第 7/8 条（掐断上游管道会杀被测进程、
     打印 ❌ 却 exit 0 是假绿）、退出码约定、本地开发改 SSH 隧道、
     在线判据口径订正、order_timeout 守门补齐、小程序 vue-tsc 门禁与其抓到的两个真 BUG。

发布验收（本次统一发布，按 device→api 顺序）：
- 测试环境与生产环境四服务 active，端口 9000/9001/3000/3001 正确，ERROR 均为 0；
- 生产迁移按判据 grep '更新列注释' 实测对齐 cabinets.status 列注释；
- 结构漂移 python tools/db_schema_diff.py = 0 处漂移 / exit 0（--vs-ddl 两库同样 0）；
- schema_alignment_e2e --env dev 全部通过 exit 0；
- 生产域名 /api/pms/cabinets -> 401、/pms/ -> 200；消费链路探测通过。
 2026-09-20 04:31:42 +08:00
12451
61adcdeaf9 fix(security)+fix(api)+docs: 越权面修复、登录门控与状态语义对齐、文档全面校对 
- 越权面（全部 before/after 实测可复现，10 条）：cabinets/filter 的 project_id/organization_id
  参数分支越权（客户可拿对方向柜全字段）、organization-tree 返回全量组织树、
  cabin-boards/compartments/cabinets 三个 options 无归属校验、batteries 无归属（改为经
  charge_orders→cabinets→projects 间接归属）、feedback 跨组织读且能改他人状态、
  GET /downloads/{id} 漏 user_id 过滤（跨用户元数据泄露）、
  POST /downloads/cleanup 全局删除所有组织导出（改客户侧只清自己）、
  /api/nodes/* 仅需登录（客户可读内网 IP 并注销节点）→ 收紧 role_level>=2；
  /api/devices/stats 同样收紧；新增共享闸门 auth::require_super_admin
- TCP 登录门控：下行投递改为"登录前白名单"（PRE_LOGIN_ALLOWED_ACTS），与上行同一规则
- 60 秒超时对齐协议：挂起项 TTL 120→60 + 值内嵌 deadline 精确判窗 + 超时 WARN（兼容老格式）
- 下发前在线判据改连接级认证标记 device:authed:{imei}（消除"管理端显示成功、设备收不到"）
  ⚠️ device-server 与 api-server 必须同批发布
- 协议对齐：auth_str 登记校验提到限流之前、build_spec Topology 分支 clamp(15/8)、
  行号引用改小节引用、修 3 处错引小节
- 状态语义：compartments.status 只表占用，充满/故障由通道状态派生；柜级 status1/status2
  与开门按钮（柜级独立动作不联动）；列注释对齐（cabinets.status 补 2=禁用、
  charge_orders.status 标注 2 保留未使用）
- 假绿单测修复：超时 SQL 抽常量 + 纯函数孪生体双向断言（方向写反必红）
- RSSI 两端统一为同源纯函数 5 档（小程序显示随之变化）+ test/rssi_signal.test.mjs
- nginx：扫码入口 abstract 限流（zone=scan_abstract_zone 30r/m burst=20）+ 主配置仓库镜像
- 文档：AGENTS.md 新增「踩过的坑」7 条教训 + 部署注意事项 11 条 + 文档口径优先级；
  docs/API.md 接口总表 80 条与 mod.rs 逐条一致、Redis 契约按代码重写、9 处事实错误修正；
  权威协议文档 v1.1.1（协议行为未变，仅修订文档自身的错误/矛盾/缺失）
 2026-09-20 03:23:00 +08:00
12451
ee92102f3c feat(scope)+fix(db)+feat(security): 数据范围(项目级)生效、库列类型对齐、安全加固、状态位分层展示、能耗实时聚合 
- user_scopes 由"假开关"做成生效：粒度到项目级（组织隔离 ∧ 项目∈范围，取交集）；未配置=不限制（逐字向后兼容）；
  总管理员豁免；脏数据保守忽略不锁死；配置期校验存在性+归属；逐接口叠加（列表/详情/写操作/Excel 导出落 scope_project_ids）；
  前端新增"数据范围"弹窗入口。顺带修 GET /api/charge-orders 此前完全没有组织隔离（跨租户泄露）、
  GET /api/projects/{id}/cabinets 的 500
- 数据库列类型系统性对齐：扫描并修复 pms_dev 32 项 / pms 18 项漂移（时间列统一 DATETIME，sqlx NaiveDateTime 只兼容 DATETIME）；
  DECIMAL→BIGINT 与列注释口径拉平；修复生产 GET /api/charge-orders、GET /api/device-logs 必然 500 的根因；
  恢复 7 张表丢失的 updated_at ON UPDATE（行为变化，已记入 AGENTS.md）；修正 SCHEMA_SQL 前向引用（空库建表必崩）；
  新增 tools/db_schema_diff.py（漂移检查，退出码可接部署前置）与 test/schema_alignment_e2e.py
- 安全加固四项：上传去 .svg + 魔数嗅探（堵存储型 XSS）；登录失败锁定(5次/15分)+challenge 限流+并发闸门+验证码容差收紧；
  服务降权 root→pms；nginx 安全头 + limit_req + CORS 白名单收敛
- TCP 连接登录门控（上行+下行同一规则）：login 前只放行 auth_str/login（PRE_LOGIN_ALLOWED_ACTS）
- 状态位按归属层级展示：柜级 status1/status2 显示在柜子（含柜门 + 开门按钮，独立动作不联动业务）、
  仓体级 batt_status/pow_status 显示在仓体；两端解析函数同源同名
- 能耗报表改实时聚合 charge_records（原 energy_stats 全表只读不写导致报表恒 0）+ 补复合索引
- 组织可见性：新增 GET /api/my-organizations（工厂全量、客户仅本组织）
- 仓体 status 仅表占用，充满/故障由 Redis 通道状态派生
- 订单/占用/队列运维缺口：h5 建单漏单、214 仓体自愈、device:reports 上限、死信 TTL、LimitNOFILE、
  每日 mysqldump + 回滚点保留 5 次
- 文档：AGENTS.md 补层级可见性/数据范围/状态位约定/数据库工具/行为变化；docs/API.md 删除废弃 TCP 章节、接口总表对齐 mod.rs
 2026-09-20 02:44:51 +08:00
12451
db1264953a fix(ops): 恢复能力与运维缺口修复（建表顺序/备份/建单漏单/214仓体/队列上限/NOFILE） 
## 恢复能力（此前实际为 0）
- migrate.rs 的 SCHEMA_SQL 存在前向引用：charge_orders 建表引用其后才创建的 compartments
  → 全新空库必然报 MySQL 1824，而 main.rs 是 .expect("数据库迁移失败") + Restart=always
  → 无限崩溃循环。修正为把 cabin_boards/compartments 移到 cabinets 之后
  （只挪位置、21 条语句字符数完全一致；实测旧版 20/21 → 新版 21/21，
   并用真实二进制在全新空库跑通、建出 21 表 153 列）
- 新增每日备份 deploy/backup-db.sh + deploy/pms-backup.cron：
  pms 与 pms_dev 各一份，--single-transaction --routines --triggers，单库 dump（无 USE/CREATE DATABASE，
  演练可安全恢复到临时库），.part 原子 mv、gzip -t 校验、记录表数与精确行数、保留 7 天、flock 防重叠、
  任一库失败则跳过清理并 exit 1（避免失败时误删旧备份）。cron 已真实触发验证；
  恢复演练：21 表逐表行数一致（1339=1339）后清理无残留
- migrate.rs 每次启动无条件 ALTER cabinets.abstract_id 改为先查 information_schema 再决定，
  实测老库触发 1 次、后续启动 0 次

## 订单与占用
- h5.rs start_charge：校验顺序改为 权限→归属→设备启用→设备在线→建单→下发（原为先建单后校验，
  设备离线时会留下幽灵单）；取不到 bat_in 登记（48h TTL 过期）时不再跳过建单，改为按未知电池建单
  （与设备侧 handle_device_on 兜底一致）—— 此前会导致整段会话无订单/无记录/无电量
- report_worker.rs 新增无订单却标占用的兜底复位（优先按通道 batt_status bit7，拿不到状态时按
  超过 12 小时未更新），并已幂等清零生产历史遗留下的 214 行；两库复查均为 0

## 队列与资源上限
- device-server：device:reports 加 LPUSH→LLEN→LTRIM 0 199999→LLEN 的 pipeline 与越界 WARN
  （此前无上限：68 柜停 8 天、1000 柜停 13 小时即打满 1GB Redis，且会连累同实例既有生产平台）
- 死信队列加 LTRIM 0 9999 + EXPIRE 7 天，写入时 WARN 带累计死信数
- 两服务各加 600s 一次的队列深度 INFO 日志（可观测性）
- 4 个 systemd 单元（仓库 + 线上已安装）加 LimitNOFILE=65535（原软限制 1024，约 1000 柜即 accept 失败）

## 文档
- docs/API.md：接口总表 71 → 79 条并与 mod.rs 的 79 次 .route( 注册双向比对一致；
  修正 system:log（种子里不存在的权限码）→ operation_log:view、登出 GET→POST、能耗导出 → energy:export；
  补齐 21 个未记录接口；新增"列表响应包装"与"关键数值字段单位"两节

## 超长函数
- report_worker.rs handle_bat_out 100→63、ensure_charge_order 88→68；users.rs update_user 81→45
  （纯重构：字符串字面量多重集零差异，allow/unwrap/expect/panic 计数不变）

## 验收
- cargo check 两服务 0 error/0 warning；cargo test api 90 + device 22 全过
- 前端真实类型检查 npm run typecheck（= tsc -b；原 `tsc --noEmit` 因 tsconfig 是 solution 文件而空跑=假绿）
- 端到端联调（测试环境）13/13；生产已部署并验证：服务 active、health 200、ERROR 0、
  消费链路正常、214 仓体清零、唯一索引在位
 2026-09-20 01:21:17 +08:00
12451
999885c38f feat(protocol): TCP v1.1 协议对齐 + 平台侧兜底 + 生产部署修复 
协议（唯一权威文档：docs/柜控板固件对接文档.md）
- 应答必带 act（与请求一致）、msg_id 与请求一致；判"应答 vs 指令"只看有没有 suc
- dev_id 只在 auth_str/login 携带；其余报文用内部字段 _dev_id 路由（下发前由 device-server 摘除）
- id 只表示动作目标（柜级省略 / 一段=单板 / 两段=仓体级），不再含 IMEI
- msg_id 每连接从 1 起自增；60 秒交互超时；status_post 每通道 18 字符 hex 全量上报
- 未登录连接 30 秒内未 login 即断开；未登录只放行 auth_str/login

平台侧实现
- 上行解析按新结构重写（cabinet/boards/battery），删除废弃的 status/parsed_status
- 订单：唯一入口 = on；bat_in 只登记电池台账；4 条结束路径统一走 finalize_order（含充电记录落库）
- 新增设备日志保留策略（90 天，分批删除）；未登记 IMEI 静默丢弃；停电标记按 status1 bit0 恢复清除
- 待确认第 13 项兜底：平台侧按 电压 × 电流 × 时间 积分计算订单电量（workers/energy.rs）
- 待确认第 18 项兜底：status_post bit7 连续 2 次无电池 → 判定电池被拔走并提前结单

修复（均为部署后才暴露的问题）
- 队列消费禁用 BRPOP：无限阻塞会因代理掐连接永久卡死（零错误日志）；有限超时也只是
  "超时才醒"，下行指令延迟 15~45 秒 → 改为 RPOP 非阻塞轮询，延迟降到 0.1~0.2 秒
- sync_iccid 把可空列 iccid 按 Option<String> 解码 → 整条 login 失败（ICCID 未上报的新柜子永远登录不上）
- 迁移读 information_schema.COLUMN_COMMENT 需 CAST(... AS CHAR)（MySQL 8 驱动报 VARBINARY，否则迁移 panic）
- 部署注意事项：.env 不支持行内注释；pscp 上传需 chmod +x；运行中二进制需 .new + mv 原子替换

部署
- 生产迁到 API 9000 / TCP 9001（systemd 单元补 EnvironmentFile、nginx 同步指向）
- 新增 deploy/deploy-prod.ps1（本地一键：构建→校验→备份→原子替换→重启→验收→无副作用探测）
- 废弃 deploy-prod.sh / deploy-test.sh（原脚本会在 target/release 找产物、装重复 systemd 单元、
  并用本地 .env 覆盖线上 .env）

质量
- 单测：api-server 39 个 / device-server 13 个（含协议示例逐值断言、跨模块 Redis key 契约）
- 两服务 cargo check 零错误零告警；web tsc --noEmit 通过
- test/tcp_e2e_smoke.py 端到端联调 13/13 通过
 2026-09-19 23:41:09 +08:00
12451
b553c4e519 feat: API 统一 + 设备详情补全 + H5 导航优化 
- API 路由统一: 移除 /api/h5/，统一 /api/pms/ 入口
- 二进制改名: api-server -> pms-api（与服务名一致）
- nginx: 合并 /api/ + /pms/api/ 为 /api/pms/
- 新增 docs/API.md 接口文档
- 后端: CabinetDetail 增加 rssi/pow_fail/address/soc 等字段
- Redis 管道批量读取仓体实时数据（SOC/电压/电流/功率）
- DB: 所有 TIMESTAMP 列改为 DATETIME（修复类型不匹配）
- 用户管理: 新增创建时间/修改时间列，状态改用 Switch
- 角色管理/用户管理: 操作按钮改为图标
- PC 设备详情: 基本信息补全 RSSI/ICCID/电源/地址
- PC 卡片: 通道统计改用 Lucide 图标，颜色统一
- PC 二维码: canvas 渲染，含编号文字，支持右键下载
- H5: 按 uni-app 规范修正导航（navigateTo 替代 reLaunch）
- H5: 详情页加返回导航条
- H5: 扫码支持摄像头（jsQR）+ ?id= 参数
- H5: 底部 tabBar 在所有页面常显
- H5: 首页统计改为 6 项（设备/通道/空闲/充电/充满/故障）
- H5: 下拉刷新 / 上拉加载
- 产品首页: 添加业务联系
- 文档: 清理过时文件，补充缺失规范章节
 2026-07-04 04:03:02 +08:00
12451
06765f99db feat: H5 用户端 Taro 重写 + 前后端接口对齐修复 
- 使用 Taro + React 重写 H5 用户端（替换旧的 React+Vite+H5 实现）
- 6 个页面：登录、首页、设备列表、设备详情、仓体详情、个人中心
- Zustand 状态管理 + API 层封装 11 个接口
- 后端 H5 路由：新增仪表盘/项目/设备/充电控制接口，组织数据隔离
- 扫码入口：/h5/{abstract_id} → 免认证查设备 + 登录后跳转
- 管理端：新增绑定码管理、二维码展示下载、设备绑定/替换 IMEI
- 产品落地页更新（hero-bg + logo 替换）
- 接口对齐修复：修正 action 路径/请求体，DashboardData 和 CabinetItem 字段匹配后端
- 布局兼容性：grid → flex，提升移动浏览器兼容性
- 移除旧 H5 项目 software/h5/
 2026-07-03 02:45:00 +08:00
12451
cb6708b9b9 fix: nginx代理路径修复，/pms/api/ → /api/ 2026-07-02 18:50:04 +08:00
12451
9b5789fb75 refactor: H5和WEB前端分离，H5独立项目，扫码路径改为/h5/ 2026-07-02 18:23:13 +08:00
12451
60d04cd2bb fix: nginx代理端口改为3000（与实际服务匹配） 2026-07-02 18:12:14 +08:00
12451
b7546ec7d8 fix: 设置vite base为/pms/，修复资源路径问题 2026-07-02 17:53:58 +08:00
12451
7c70802cee fix: 修复PMS静态资源路径问题，添加assets location 2026-07-02 17:50:04 +08:00
12451
e24af59615 fix: 修复/pms不带斜杠404问题，添加重定向 2026-07-02 17:47:57 +08:00
12451
a3f4f5929c feat: 底部添加公司名称无锡艾动电子有限公司 2026-07-02 17:46:49 +08:00
12451
524dc768dd feat: 重新设计产品介绍页，现代科技风格，添加ICP备案 2026-07-02 17:44:50 +08:00
12451
2ff83033f5 feat: 使用AI生成的充电柜真实图片替换CSS动画 2026-07-02 17:41:00 +08:00
12451
23c91c075d feat: 重新设计产品介绍页，CSS充电柜动画，修复4卡片布局 2026-07-02 17:36:25 +08:00
12451
a87ff96c14 fix: 修复产品介绍页HTML引号转义问题 2026-07-02 15:49:50 +08:00
12451
2633c830c9 refactor: 分离产品介绍页(/data/landing)和PMS前端(/data/pms/web) 2026-07-02 15:42:51 +08:00
12451
9358db42e7 feat: 添加产品介绍首页，根目录指向 /data/www 2026-07-02 15:40:18 +08:00
12451
652bde44c4 fix: nginx配置修正Gitea路由 /doc/ 而非 /pms/doc/ 2026-07-02 15:18:45 +08:00
12451
7a04f6da53 chore: 测试/正式环境端口分离，更新部署配置 
- API: 测试:3000, 正式:9000
- TCP: 测试:3001, 正式:9001
- 部署路径: /data/pms (正式), /data/pms_dev (测试)
- URL: /pms/ 前缀
- 添加 systemd 服务单元和部署脚本
- 更新 nginx 配置和 AGENTS.md 文档
 2026-07-02 14:58:47 +08:00