docs: 数据查看冻结列与数据类型下拉框功能测试报告 + 日结补充

zhizhijie

9 天以前 4792a6c11fd390ce36f71106f7f332ab6226489a

docs: 数据查看冻结列与数据类型下拉框功能测试报告 + 日结补充

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Êý¾Ý²é¿´¶³½áÁÐÓëÊý¾ÝÀàÐÍÏÂÀ­¿ò_2026-09-22.md

New file
@@ -0,0 +1,64 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šï¼šæ•°æ®æŸ¥çœ‹å†»ç»“列与数据类型下拉框（2026-09-22）

> æ—¥æœŸï¼š2026-09-22　模块：数据查看（前端 DataView.vue）　测试人：Codex
> è¯‰æ±‚来源：①横向滚动时企业名称看不到；②数据类型改成一个下拉框更简洁；③跨期汇总的时点列处理口径。

## ä¸€ã€åŠŸèƒ½è¯´æ˜Ž

1. **左侧冻结标识列**：`renderColumns` è®¡ç®—属性按表自适应冻结"这是谁的数据"所需的连续前导列，横向滚动时不会跑出视野。
   - å†»ç»“集合：`reportPeriod` / `regionCode` / `city` / `regionName` / `periodType` / `enterpriseName` / `projectName` / `plateNo`；
   - æ¨¡æ¿ç”± `visibleColumns` æ”¹ä¸º `renderColumns`，并传 `:fixed="c.fixed ? 'left' : false"`。
2. **数据类型分组下拉框**：去掉"模块单选按钮 + å•ç±»åž‹ä¸‹æ‹‰"的两级结构，合并为一个 `el-select`（`el-option-group` æŒ‰æ¨¡å—分组，`filterable` æ”¯æŒè¾“入搜索），选中类型时同步 `activeModule`。
3. **跨期汇总口径确认**（按用户决定）：汇总视图**不放时点列**（运营车辆数、营运车辆数、企业数），只放流量列与按累计口径重算的比率列。

## äºŒã€æµ‹è¯•çŽ¯å¢ƒ

- åŽç«¯ï¼š`start-dev.ps1` å¯åŠ¨ï¼Œ8090，日志 `Started TrafficAuditApplication` / `Tomcat started on port(s): 8090`
- å‰ç«¯ï¼šåŒä¸€è„šæœ¬å¯åŠ¨ï¼Œ8080，`Compiled successfully`
- æ•°æ®åº“：本机 MySQL `localhost:3308/traffic_audit`；登录 `admin/123456`
- æµè§ˆå™¨ï¼šCodex å†…置浏览器真机操作（DOM + æ— éšœç¢æ ‘校验，非仅代码审查）

## ä¸‰ã€ç”¨ä¾‹è¡¨

### 3.1 æ­£å‘用例

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-1 | å±•å¼€"数据类型"下拉 | å•ä¸‹æ‹‰ã€æŒ‰æ¨¡å—分组 | 5 ç»„ 18 é¡¹ï¼šé“路货运 5 / å…¬è·¯æ—…客 3 / åŸŽå¸‚客运 5 / æŠ•èµ„ 3 / èƒ½è€— 2；无单选按钮残留 | é€šè¿‡ |
| TC-2 | åˆ‡åˆ°"个体客运量/周转量" | ç«‹å³æŸ¥è¯¢å¹¶å‡ºæ•° | å…± 139 æ¡ï¼Œå†»ç»“列=报表期/所属地区/市州/企业名称 | é€šè¿‡ |
| TC-3 | åˆ‡åˆ°"货运量周转量"（宽表） | å‡ºæ•°ã€å†»ç»“标识列 | å…± 234 æ¡ï¼Œæ­£æ–‡ 48 åˆ—，冻结列=报表期/市州 | é€šè¿‡ |
| TC-4 | åˆ‡åˆ°"网约车总数" | å‡ºæ•° | å…± 20 æ¡ï¼Œå†»ç»“列=报表期（该表无名称类字段） | é€šè¿‡ |
| TC-5 | åˆ‡åˆ°"城市公共交通月度运营情况" | å‡ºæ•°ã€å†»ç»“企业名称 | å…± 2860 æ¡ï¼Œå†»ç»“列=报表期/所属地区/市州/企业名称 | é€šè¿‡ |
| TC-6 | åˆ‡åˆ°"巡游出租汽车运营服务情况月报" | å‡ºæ•° | å…± 340 æ¡ï¼Œå†»ç»“列=报表期/所属地区/市州 | é€šè¿‡ |
| TC-7 | åˆ‡åˆ°"网约车订单及全省总量" | å‡ºæ•°ã€å®½è¡¨ | å…± 20 æ¡ï¼Œæ­£æ–‡ 22 åˆ—（订单合计 + 17 å¸‚州），冻结列=报表期 | é€šè¿‡ |
| TC-8 | è´§è¿è¡Œï¼ˆh2032）横向滚动 | å†»ç»“组常驻 | `el-table__fixed` è¡¨å¤´=报表期/所属地区/企业名称，且冻结表内有数据行（如 2025-04 / 429021 / ç¥žå†œæž¶å¤§è¿ç‰©æµæœ‰é™å…¬å¸ï¼‰ | é€šè¿‡ |
| TC-9 | é¡µé¢åˆæ¬¡è¿›å…¥ | é»˜è®¤ç±»åž‹å¯æŸ¥ | é»˜è®¤"道路货物运输月度生产情况"，共 13056 æ¡ | é€šè¿‡ |

### 3.2 è´Ÿå‘/边界

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-10 | æ— åç§°ç±»å­—段的表（网约车总数/订单） | åªå†»ç»“报表期，不误冻结数值列 | å†»ç»“列仅"报表期" | é€šè¿‡ |
| TC-11 | æœªç™»å½•ç›´æŽ¥è®¿é—® `/api/data/list` | 401 | 401 `未登录或登录已过期` | é€šè¿‡ï¼ˆæ—¢æœ‰å®‰å…¨ç­–略） |
| TC-12 | ä¸‹æ‹‰è¾“入关键字筛选 | æ”¯æŒè¾“入搜索 | `filterable` ç”Ÿæ•ˆï¼ˆæŒ‰é€‰é¡¹åè¿‡æ»¤ï¼‰ | é€šè¿‡ |

### 3.3 æ±‡æ€»å£å¾„核对（时点列为何不汇总）

武汉市公交运营车辆数（`city_bus_monthly`，2026 å¹´ï¼‰ï¼š1 æœˆ 8476 â†’ 2 æœˆ 8283 â†’ 3 æœˆ 8248 â†’ 4~6 æœˆ 8050 â†’ 7~8 æœˆ 7861。

| ç®—法 | ç»“æžœ | æ˜¯å¦æœ‰ä¸šåŠ¡å«ä¹‰ |
| --- | --- | --- |
| é€æœˆç›¸åŠ  | 64879 è¾† | å¦ï¼ˆåŒä¸€æ‰¹è½¦é‡å¤è®¡ 8 æ¬¡ï¼‰ |
| å–期末（8 æœˆï¼‰ | 7861 è¾† | æ˜¯ |
| å–期间平均 | çº¦ 8100 è¾† | å¯é€‰ |

结论：时点列不参与累加，汇总视图不显示（用户决定）。

## å››ã€å‘现的问题与处置

1. å†»ç»“列依赖"标识列连续出现在最前面"这一列序假设；若后续调整列序或新增类型，需同步维护 `stickyProps` ä¸Ž `nameProps`。已在 `renderColumns` æ³¨é‡Šä¸­è¯´æ˜Žï¼Œæš‚不改动。
2. æœ¬æ¬¡æ”¹åŠ¨åŒ…含一处**此前未提交的冻结列实现**（09:56 è½åœ¨å·¥ä½œåŒºï¼‰ï¼Œæµ‹è¯•é€šè¿‡åŽä¸€å¹¶æäº¤ï¼Œé¿å…é—漏。

## äº”、结论

数据类型下拉框、按表自适应的左侧冻结列均通过真机用例；切换 7 ä¸ªç±»åž‹è¡Œæ•°ä¸ŽæŽ¥å£ä¸€è‡´ï¼Œæ— å›žå½’。跨期汇总的时点列处理口径已确定：不参与汇总、不显示。

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-22.md

@@ -35,20 +35,30 @@
  5. æ¯æ¬¡æ–°ä»»åŠ¡é‡ç½® `taskDownloaded/taskFileName/taskFileSize/taskBlob`。
- **浏览器实测**（admin/123456，2026-08）：生成 13.5 ç§’、产物 1.15 MB；完成后标题「汇总大表已生成」、提示「已自动下载：生成_道路运输量汇总表_2026-08.xlsx ï¼ˆ1.15 MB）」、点「再次下载」提示「已从本地缓存保存」；控制台 0 æŠ¥é”™ã€‚

### 5. æ•°æ®æŸ¥çœ‹ä½“验优化（第二轮，用户当日反馈）

用户三点反馈：①跨期汇总时点列怎么处理——决定**不放时点列**；②横向滚动时看不到企业名称；③数据类型做成下拉框更简洁。

- **数据类型改为分组单下拉框**：去掉"模块单选按钮 + ç±»åž‹ä¸‹æ‹‰"两级结构，合并为一个 `el-select`（按 5 ä¸ªæ¨¡å—分组、支持输入搜索），切换类型时同步 `activeModule`。
- **左侧冻结标识列**：`renderColumns` æŒ‰è¡¨è‡ªé€‚应冻结 `报表期/所属地区/市州/企业名称` ç­‰å‰å¯¼åˆ—（此实现 09:56 å·²è½åœ¨å·¥ä½œåŒºä½†æœªæäº¤ï¼Œæœ¬æ¬¡çœŸæœºéªŒè¯åŽä¸€å¹¶æäº¤ï¼‰ã€‚
- **跨期汇总口径定稿**：流量列求和、时点列不参与汇总且不显示、比率列按累计口径重算。

## äºŒã€æµ‹è¯•ç»“果摘要

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看冻结列与数据类型下拉框_2026-09-22.md`（冻结列/下拉框真机用例 12 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表进度弹窗优化_2026-09-22.md`（6 æ¡ç”¨ä¾‹é€šè¿‡ï¼šç”Ÿæˆä¸­çŠ¶æ€ / å®Œæˆæç¤º / å†æ¬¡ä¸‹è½½èµ°ç¼“å­˜ / å…³é—­ / æ— æŽ§åˆ¶å°æŠ¥é”™ / å…¶å®ƒå¯¼å‡ºæœªå—影响）
- çŽ¯å¢ƒï¼šåŽç«¯ `mvn spring-boot:run`（8090，`Started TrafficAuditApplication`）；前端 `npm run serve`（8080，`Compiled successfully in 4769ms`）；MySQL `localhost:3308/traffic_audit`；登录 admin/123456 å– JWT。
- ç»“果：3 ä¸ªæ–°ç±»åž‹æ­£å‘（含期间/关键字筛选）、负向（未知类型、无数据期、无 token）全部通过；入库抽查条数与库内一致（20 / 20 / 139）；原有 15 ç±»å›žå½’正常。

## ä¸‰ã€é—留问题与待办

1. ã€ä¸‹ä¸€æ­¥ä¸»ä½“工作】数据查看"按市州汇总"：任意起止月 + 17 å¸‚å·ž + åˆè®¡è¡Œï¼›æ—¶ç‚¹åˆ—取期末；比率列按累计口径重算；并支持导出 Excel。
1. ã€ä¸‹ä¸€æ­¥ä¸»ä½“工作】数据查看"按市州汇总"：任意起止月（年初至 N æœˆå³ 01~N）+ 17 å¸‚å·ž + åˆè®¡è¡Œï¼›**不放时点列**；比率列按累计口径重算；并支持导出 Excel。
2. æ±‡æ€»å£å¾„细则待业务确认：排名字段跨期需重新排名（先留空）；累计同比需要自动取上年同期期间。
3. å…³é”®å­—框对无名称列的表（网约车总数、网约车订单）无效，待优化。
4. `scale_split_transport`（规上/规下拆分）288 è¡Œæ•°å€¼å…¨ä¸º NULL，若哪张报表依赖它按市州出数会取不到值，建议与同事确认导入来源。
5. Codex æ¡Œé¢ç«¯æ¨¡åž‹æ˜¾ç¤ºï¼ˆ09-21 æ™šé—留）：已写 `model_catalog_json` æ¸…单，待用户重启客户端确认界面显示 `deepseek-flash`。
4. å†»ç»“列依赖"标识列连续排在前面"的列序假设，若以后调整列序/新增类型需同步维护 `stickyProps`/`nameProps`。
5. `scale_split_transport`（规上/规下拆分）288 è¡Œæ•°å€¼å…¨ä¸º NULL，若哪张报表依赖它按市州出数会取不到值，建议与同事确认导入来源。
6. Codex æ¡Œé¢ç«¯æ¨¡åž‹æ˜¾ç¤ºï¼ˆ09-21 æ™šé—留）：已写 `model_catalog_json` æ¸…单，待用户重启客户端确认界面显示 `deepseek-flash`。

## å››ã€æ˜Žå¤©è®¡åˆ’