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)

---

## UI 原型（Design 阶段产物）

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

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

**交互流程：**
- 点击省份柱子 → 进入该省城市下钻视图
- 点击面包屑「全国」或「返回全国」按钮 → 返回省份视图

> PM 审核要点：布局、交互路径、数据说明是否符合预期，确认后在本 PR approve。

---

## 技术规格（Tech Lead 确认）

**数据链路：**

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

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

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

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

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

**各端影响：** 仅 admin 端

---

## 审核清单

### PM 审核（原型）
- [ ] 页面布局符合预期？
- [ ] 省份下钻 / 返回交互路径正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？

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

**通过后：** PM + Tech Lead 均 Approve → Merge → 召开评审会议 → 进入 Plan 阶段

TEXT

is_first_created

INTEGER

is_deleted

INTEGER