12451
|
0441d91d1f
|
feat(users+cabinets): 用户管理加角色过滤、数据范围仅操作员可配、柜子详情透出电表读数
## 1. 用户管理：角色过滤（页面总共只有三种角色，默认罗列全部太吵）
前端加角色下拉 + 后端 `GET /users` 新增 `role` 参数（0/1/2，越界当作不过滤）。
后端把 `build_user_list_where` 从**二元穷举 match 重构为条件累加** ——
加第三个过滤器时穷举会涨到 8 分支且极易漏。同时修一个潜在坑：
**OR 条件必须整体加括号**，否则 `phone LIKE ? OR name LIKE ?` 与
`organization_id = ?` 用 AND 混排时会变成
`(A AND phone LIKE ?) OR name LIKE ?`，把组织/角色过滤整个击穿
（搜个姓名就跨组织串数据）。
新增 6 个守门单测（含"占位符个数必须与 bind 次数一致"的反证），
已自证能失败：去掉 OR 括号 → 2 个用例 FAILED，还原 → 6 passed。
## 2. 数据范围：仅操作员(role=0)可配
按用户口径：
- **总管理员**：豁免范围限制，不需要配；
- **企业管理员**：天然管理本组织全部设备，配项目级范围反而有歧义；
- **操作员**：才需要设置可管理的项目。
前端对该按钮按 `record.role !== 0` 置灰并加 title 说明。
**创建/编辑时操作员必须选组织**（没有企业归属就看不到任何设备），校验文案也分开提示。
## 3. 柜子详情：透出电表读数
接口早已返回 `meter_wh`/`meter_at`，但**前端从没接过**（用户看不到）。
现加到详情页基本信息行（IMEI/ICCID/名称 之后），Wh → kWh 展示并附收到时刻；
`null` = 从未上报过，显示 `-` 而**不是 0 度**。
## ⛔ 表号：系统里没有，做不了
全仓搜不到 `meter_no`/`meter_id`/`meter_sn`/`表号`，协议里 `cabinet.meter`
只是读数（Wh），**没有电表编号字段**。这需要硬件侧在协议里加字段，
平台无法单方面补。
## ⚠️ 我这次犯的流程错误（已修正）
改了 Rust 代码后**只跑了 cargo check/test，没重新 `zigbuild` release 产物**，
`deploy -SkipBuild` 于是把几小时前的旧二进制发上去了 —— 第一次实测角色过滤
三种角色全返回、监控词。重建后才通过。
**教训：改 Rust 后必须重建 release 产物再发。**
## 验收
- `cargo check --all-targets` 两服务：**0 error / 0 warning**
- `cargo test --bin pms-api`：**210 passed**（204 + 6 新）
- web `npm run typecheck`：exit 0
- **角色过滤实测**（测试环境，临时超管+自签 JWT，用完即删）：
```
role=0 → 2 人，role 集合 [0] OK
role=1 → 1 人，role 集合 [1] OK
role=2 → 2 人，role 集合 [2] OK
不带 role → [0,1,2] OK
role=0 + keyword → 1 人 OK（keyword 单独查命中 0，证明不是靠关键字通过）
role=9 越界 → 5 人 OK（当作不过滤）
```
- 已发布测试 + 生产（四服务 active、0 ERROR、消费链探测通过、二进制时间戳已核对）
|
2026-09-21 05:02:09 +08:00 |
|
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
|
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
|
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
|
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 |
|