SQLite Web: gitea.db

id

Primary key. INTEGER NOT NULL

poster_id

INTEGER

issue_id

INTEGER

comment_id

INTEGER

edited_unix

INTEGER

content_text

## 关联 Intent

[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)

---

## 审核顺序：PM 先确认原型，再由 Tech Lead Approve Spec

---

## 第一步：PM 确认原型

**原型链接：** https://claude.ai/code/artifact/f78c807a-ae4c-4261-bd42-fb73da2336a9

页面状态：
- ① 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图排行
- ② 广东省城市下钻 — 面包屑「全国 › 广东省」+ 城市排行 + 返回全国

交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回省份视图。

**PM 审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？

✅ **PM 确认方式：在本 PR 评论「原型确认 ✅」即可，无需 Approve**

---

## 第二步：Tech Lead 审核 Spec（PM 确认后进行）

**数据链路：**

> 待确认：ahead_family_servers._shop_id 是否关联 ahead_yc_shop._id，Build 阶段查库验证。

**新增接口（新建控制器 DeviceOnlineReport.php）：**
- POST /DeviceOnlineReport/getStats — 省份排行 + 当月总数
- POST /DeviceOnlineReport/getCityStats — 城市下钻

**前端：** Vue 页面组件 + ECharts 横向柱状图，点击省份下钻到城市视图

**权限：** agent_id 从 session 取，agent_id=0 为超管不过滤

**安全要点：**
- month 参数正则校验 /^\d{4}-\d{2}$/
- province_id 强制 intval()
- agent_id 从 session 取，不信任前端传参

**Tech Lead 审核 checklist：**
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？

✅ **Tech Lead 直接 Approve → Merge → 召开评审会议 → 进入 Plan 阶段**

TEXT

is_first_created

INTEGER

is_deleted

INTEGER