feat(数据查看): 补齐网约车总数/网约车订单/个体客运三类查看（含市州派生）+ 测试报告与日结

zhizhijie

9 天以前 2d74b99f1cb1ba745e32f5cfdfed82a8fb22f37f

feat(数据查看): 补齐网约车总数/网约车订单/个体客运三类查看（含市州派生）+ 测试报告与日结

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Êý¾Ý²é¿´²¹ÆëÍøÔ¼³µÓë¸öÌå¿ÍÔËÀàÐÍ_2026-09-22.md

New file
@@ -0,0 +1,76 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šï¼šæ•°æ®æŸ¥çœ‹è¡¥é½ç½‘约车与个体客运类型（2026-09-22）

> æ—¥æœŸï¼š2026-09-22　模块：数据查看（前端 DataView + åŽç«¯ DataViewController）　测试人：Codex
> è¯‰æ±‚来源：数据查看的数据类型应做到"能导入什么数据就能看到什么数据"，用于核对导入是否完整。

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

数据查看页原先只有 15 ä¸ªæ•°æ®ç±»åž‹ï¼Œç½‘约车与个体客运虽然已有导入接口和模板，但**没有查看入口**，导入后只能查数据库。本次补齐 3 ä¸ªç±»åž‹ï¼š

| æ–°å¢žç±»åž‹ | é¡µé¢åç§° | æ•°æ®è¡¨ | åˆ—æ•° |
| --- | --- | --- | --- |
| `wycTotal` | ç½‘约车总数 | `wyc_total_monthly` | 5 |
| `wycOrder` | ç½‘约车订单及全省总量 | `wyc_order_monthly` | 23（含 17 å¸‚州订单列） |
| `passengerIndividual` | ä¸ªä½“客运量/周转量 | `passenger_individual_monthly` | 7（含由区划代码派生的"市州"列） |

改动点：
- åŽç«¯ `traffic-audit-server/src/main/java/com/trafficaudit/dataimport/controller/DataViewController.java`：新增 3 ä¸ª `switch` åˆ†æ”¯ã€3 ç»„列定义、3 ä¸ª Mapper æ³¨å…¥ï¼›`passengerIndividual` ç”¨ `RegionUtil.cityByCode` æŠŠ 6 ä½åŒºåˆ’代码派生为市州名。
- å‰ç«¯ `traffic-audit-web/src/views/DataView.vue`：公路旅客模块加"个体客运量/周转量"，城市客运模块加"网约车总数""网约车订单及全省总量"。

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

- åŽç«¯ï¼š`mvn spring-boot:run -f traffic-audit-server/pom.xml`，8090，日志出现 `Started TrafficAuditApplication`、`Tomcat started on port(s): 8090`
- å‰ç«¯ï¼š`npm run serve`（traffic-audit-web），8080，`Compiled successfully in 4769ms`
- æ•°æ®åº“：本机 MySQL `localhost:3308/traffic_audit`（mysql CLI ç›´æŸ¥æ ¸å¯¹ï¼‰
- ç™»å½•ï¼š`POST /api/auth/login`（admin/123456）取 JWT，后续接口带 `Authorization: Bearer <token>`

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

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

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-1 | `GET /api/data/list?type=wycTotal` | 20 è¡Œã€5 åˆ—，列名与模板一致 | total=20，列：报表期/全省网约车客运量/其中城市内客运量/全省网约车周转量/其中城市内周转量；首行 2025-01：2467.79 / 2325.25 / 14910.54 / 12202.49 | é€šè¿‡ |
| TC-2 | `type=wycOrder` | 20 è¡Œã€23 åˆ—（含 17 å¸‚州） | total=20，23 åˆ—；首行 2025-09：orderSum=17652159，武汉 8076610、黄石 676644…神农架 1424 | é€šè¿‡ |
| TC-3 | `type=passengerIndividual` | 139 è¡Œã€7 åˆ—，含派生市州 | total=139；首行 2025-01：regionCode=420900 â†’ å¸‚å·ž=孝感市，个体客运量 6442、周转量 117502.08 | é€šè¿‡ |
| TC-4 | `type=wycOrder&period=2026-08` | ä»… 2026-08 ä¸€è¡Œ | total=1，rows=1，cols=23 | é€šè¿‡ |
| TC-5 | `type=passengerIndividual&period=2026-08` | ä»… 2026-08 | total=6 | é€šè¿‡ |
| TC-6 | `type=passengerIndividual&keyword=孝感` | ä»…孝感相关行 | total=40 | é€šè¿‡ |
| TC-7 | å‰ç«¯ä¸‹æ‹‰ | å…¬è·¯æ—…客 3 é¡¹ã€åŸŽå¸‚客运 5 é¡¹ | ä¸‹æ‹‰æ–°å¢ž 3 é¡¹ï¼Œ`npm run serve` ç¼–译成功 | é€šè¿‡ |

### 3.2 è´Ÿå‘用例

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-8 | `type=notExist` | ç©ºç»“果、不报错 | total=0、records=0、columns=0 | é€šè¿‡ |
| TC-9 | `type=wycOrder&period=1999-01`（无数据的期） | ç©ºç»“æžœ | total=0、records=0、列定义正常返回 | é€šè¿‡ |
| TC-10 | ä¸å¸¦ token è®¿é—® `/api/data/list` | 401（既有安全策略） | 401 | é€šè¿‡ï¼ˆéžç¼ºé™·ï¼‰ |
| TC-11 | `type=wycTotal&keyword=xx` | è¯¥è¡¨æ— åç§°åˆ—，关键字不生效 | ä»è¿”回 20 è¡Œ | é€šè¿‡ï¼ˆè§é—ç•™ 1） |

### 3.3 å…¥åº“抽查（接口条数 vs åº“内行数）

| è¡¨ | åº“内行数 | æŽ¥å£ total | ç»“论 |
| --- | --- | --- | --- |
| `wyc_total_monthly` | 20 | 20 | ä¸€è‡´ |
| `wyc_order_monthly` | 20 | 20 | ä¸€è‡´ |
| `passenger_individual_monthly` | 139 | 139 | ä¸€è‡´ |

### 3.4 å›žå½’（原有 15 ç±»ä¸å—影响）

`h2032` 13056 / `transportAuth` 1270 / `trackMileage` 628 / `scaleSplit` 288 / `freightTurnover` 234 / `h2031` 15811 / `passengerAuth` 0 / `cityBus` 2860 / `cityTaxi` 340 / `cityTaxiAuth` 85272 / `investmentProject` 152 / `investmentMonthly` 284 / `investmentSystem` 277 / `energyVehicle` 2568 / `energyAuth` 1203 â€”— å‡æ­£å¸¸è¿”回，列数不变。

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

1. `wycTotal` / `wycOrder` æ²¡æœ‰åç§°ç±»å­—段，页面上"企业/市州名称"关键字框对它无效（返回全量）。属既有交互的一致性问题，未在本次改动，列入待优化。
2. ç½‘约车订单表为宽表（17 å¸‚州各一列），明细页横向 23 åˆ—，需要横向滚动查看；未做转置，保持与导入文件列序一致，便于核对。

## äº”、结论

3 ä¸ªæ–°å¢žç±»åž‹å…¨éƒ¨é€šè¿‡æ­£å‘、负向与入库抽查用例，原有 15 ç±»æ— å›žå½’。数据查看现已覆盖**全部可导入的数据类型**，可用于核对导入完整性。

## å…­ã€é™„：跨期汇总口径（下一步待做功能的口径依据）

月报各表的月值均为**当月值**。按市州做"任意起止月"汇总时，列按性质分三类处理：
- æµé‡ç±»ï¼ˆå®¢è¿é‡ã€å‘¨è½¬é‡ã€è´§è¿é‡ã€è®¢å•æ•°ï¼‰â†’ é€æœˆæ±‚和；
- æ—¶ç‚¹ç±»ï¼ˆè¿è¥è½¦è¾†æ•°ã€è¥è¿è½¦è¾†æ•°ã€ä¼ä¸šæ•°ï¼‰â†’ ä¸æ±‚和，取期末值（如武汉公交运营车辆 2026 å„月 8476→7861，逐月相加会得到 64879 è¾†ï¼Œå®žé™… 8 æœˆæœ«åªæœ‰ 7861 è¾†ï¼‰ï¼›
- æ¯”率类（环比、同比、平均运距、占比）→ ä¸æ±‚和，按累计口径重算。

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

New file
@@ -0,0 +1,44 @@
# å·¥ä½œæ—¥ç»“_2026-09-22

## ä¸€ã€ä»Šå¤©åšäº†ä»€ä¹ˆ

### 1. æ•°æ®æŸ¥çœ‹é¡µè¡¥é½ç½‘约车与个体客运类型（"能导入就能看"）

用户诉求：数据查看的数据类型应做到"能导入什么数据就能看到什么数据"，用于核对导入是否完整。
原先网约车总数、网约车订单、个体客运三张表**有导入接口和模板但没有查看入口**，导入后只能查数据库。

- åŽç«¯ `DataViewController`：新增 `wycTotal` / `wycOrder` / `passengerIndividual` ä¸‰ä¸ªåˆ†æ”¯ + ä¸‰ç»„列定义 + ä¸‰ä¸ª Mapper æ³¨å…¥ï¼›
  `passengerIndividual` ç”¨ `RegionUtil.cityByCode` æŠŠ 6 ä½åŒºåˆ’代码派生为"市州"列（如 420900 â†’ å­æ„Ÿå¸‚）。
- å‰ç«¯ `DataView.vue`：公路旅客模块加"个体客运量/周转量"，城市客运模块加"网约车总数""网约车订单及全省总量"（订单表 23 åˆ—，17 å¸‚州各一列，保持与导入文件列序一致）。

### 2. è·¨æœŸ"按市州汇总"的口径调研 + æ ·ä¾‹

- ç”Ÿæˆæ ·ä¾‹ `D:\桌面\按市州汇总_2026å¹´1-8月累计_样例.xlsx`：公交、巡游出租、货运规上企业三张表，17 å¸‚å·ž + å…¨çœåˆè®¡è¡Œ + "口径说明"页。
- æ ¸å®žå„表月值口径为**当月值**（公交 2025 å„月全省 1.2~1.5 äº¿äººæ¬¡é‡çº§ï¼‰ï¼Œæ•…跨期汇总按列性质分三类：
  - æµé‡ç±»ï¼ˆå®¢è¿é‡/周转量/货运量/订单数）→ æ±‚和；
  - æ—¶ç‚¹ç±»ï¼ˆè¿è¥è½¦è¾†æ•°/营运车辆数/企业数）→ å–期末（武汉公交 2026 å„月 8476→7861，逐月相加得 64879 è¾†ï¼Œå®žé™… 8 æœˆæœ«ä»… 7861 è¾†ï¼‰ï¼›
  - æ¯”率类（环比/同比/平均运距/占比）→ æŒ‰ç´¯è®¡å£å¾„重算。
- è´§è¿ä¼ä¸šè¡¨çš„市州由 6 ä½åŒºåˆ’代码前 4 ä½å½’并（4290xx ç›´ç®¡å¸‚按 6 ä½ä¼˜å…ˆï¼‰ï¼Œ17 å¸‚州全部识别，无"未识别"。

### 3. æ ¸æŸ¥"数据查看已加汇总功能"的现状

用户在别处看到"汇总"按钮，实际核查：前端 `DataView.vue` å…¨æ–‡æ— "汇总/导出"（`ReportExport.vue` æ‰æœ‰ï¼‰ï¼ŒåŽç«¯åªæœ‰ `/api/data/list`，全仓 + `traffic-audit-web/dist` + éƒ¨ç½² jar + gitea è¿œç«¯ `main` å‡æ— ç›¸å…³ä»£ç ã€‚已向用户说明，按"尚未实现、由本仓实现"推进。

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

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
- çŽ¯å¢ƒï¼šåŽç«¯ `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。
2. æ±‡æ€»å£å¾„细则待业务确认：排名字段跨期需重新排名（先留空）；累计同比需要自动取上年同期期间。
3. å…³é”®å­—框对无名称列的表（网约车总数、网约车订单）无效，待优化。
4. `scale_split_transport`（规上/规下拆分）288 è¡Œæ•°å€¼å…¨ä¸º NULL，若哪张报表依赖它按市州出数会取不到值，建议与同事确认导入来源。
5. Codex æ¡Œé¢ç«¯æ¨¡åž‹æ˜¾ç¤ºï¼ˆ09-21 æ™šé—留）：已写 `model_catalog_json` æ¸…单，待用户重启客户端确认界面显示 `deepseek-flash`。

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

1. å¼€å·¥"按市州汇总 + å¯¼å‡º Excel"：后端加 `/api/data/summary` ä¸Ž `/api/data/export`，前端加"明细/汇总"切换与导出按钮。
2. æ±‡æ€»ç»“果与报表/手工作业抽样核对（1-8 æœˆå…¬äº¤ã€å·¡æ¸¸å‡ºç§Ÿã€è´§è¿è§„上企业）。

 traffic-audit-server/src/main/java/com/trafficaudit/dataimport/controller/DataViewController.java

@@ -19,6 +19,10 @@
import com.trafficaudit.dataimport.entity.InvestmentSystem;
import com.trafficaudit.dataimport.entity.EnergyVehicleQuarterly;
import com.trafficaudit.dataimport.entity.EnergyAuthVehicle;
import com.trafficaudit.dataimport.entity.PassengerIndividualMonthly;
import com.trafficaudit.dataimport.entity.WycOrderMonthly;
import com.trafficaudit.dataimport.entity.WycTotalMonthly;
import com.trafficaudit.common.util.RegionUtil;
import com.trafficaudit.dataimport.mapper.FreightTurnoverImportMapper;
import com.trafficaudit.dataimport.mapper.H2032EnterpriseMonthlyMapper;
import com.trafficaudit.dataimport.mapper.PassengerAuthVehicleMapper;
@@ -34,6 +38,9 @@
import com.trafficaudit.dataimport.mapper.InvestmentSystemMapper;
import com.trafficaudit.dataimport.mapper.EnergyVehicleQuarterlyMapper;
import com.trafficaudit.dataimport.mapper.EnergyAuthVehicleMapper;
import com.trafficaudit.dataimport.mapper.PassengerIndividualMonthlyMapper;
import com.trafficaudit.dataimport.mapper.WycOrderMonthlyMapper;
import com.trafficaudit.dataimport.mapper.WycTotalMonthlyMapper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
@@ -84,6 +91,12 @@
    private EnergyVehicleQuarterlyMapper energyVehicleMapper;
    @Resource
    private EnergyAuthVehicleMapper energyAuthMapper;
    @Resource
    private PassengerIndividualMonthlyMapper passengerIndividualMapper;
    @Resource
    private WycOrderMonthlyMapper wycOrderMapper;
    @Resource
    private WycTotalMonthlyMapper wycTotalMapper;

    @GetMapping("/list")
    public Result<Map<String, Object>> list(@RequestParam("type") String type,
@@ -289,6 +302,43 @@
                fillPage(result, r);
                break;
            }
            case "passengerIndividual": {
                LambdaQueryWrapper<PassengerIndividualMonthly> w = new LambdaQueryWrapper<PassengerIndividualMonthly>()
                        .eq(notEmpty(period), PassengerIndividualMonthly::getReportPeriod, period)
                        .like(!kw.isEmpty(), PassengerIndividualMonthly::getEnterpriseName, kw)
                        .orderByDesc(PassengerIndividualMonthly::getId);
                Page<PassengerIndividualMonthly> p = new Page<>(safePage, safeSize);
                Page<PassengerIndividualMonthly> r = passengerIndividualMapper.selectPage(p, w);
                List<Map<String, Object>> rows = toMaps(r.getRecords(), propsOf(PAX_INDIVIDUAL_COLUMNS));
                for (Map<String, Object> row : rows) {
                    Object rc = row.get("regionCode");
                    String cityName = rc == null ? null : RegionUtil.cityByCode(String.valueOf(rc));
                    row.put("city", cityName == null ? "" : cityName);
                }
                result.put("records", rows);
                fillPage(result, r);
                break;
            }
            case "wycTotal": {
                LambdaQueryWrapper<WycTotalMonthly> w = new LambdaQueryWrapper<WycTotalMonthly>()
                        .eq(notEmpty(period), WycTotalMonthly::getReportPeriod, period)
                        .orderByDesc(WycTotalMonthly::getId);
                Page<WycTotalMonthly> p = new Page<>(safePage, safeSize);
                Page<WycTotalMonthly> r = wycTotalMapper.selectPage(p, w);
                result.put("records", toMaps(r.getRecords(), propsOf(WYC_TOTAL_COLUMNS)));
                fillPage(result, r);
                break;
            }
            case "wycOrder": {
                LambdaQueryWrapper<WycOrderMonthly> w = new LambdaQueryWrapper<WycOrderMonthly>()
                        .eq(notEmpty(period), WycOrderMonthly::getReportPeriod, period)
                        .orderByDesc(WycOrderMonthly::getId);
                Page<WycOrderMonthly> p = new Page<>(safePage, safeSize);
                Page<WycOrderMonthly> r = wycOrderMapper.selectPage(p, w);
                result.put("records", toMaps(r.getRecords(), propsOf(WYC_ORDER_COLUMNS)));
                fillPage(result, r);
                break;
            }
            default:
                result.put("records", new ArrayList<>());
                result.put("total", 0L);
@@ -346,6 +396,9 @@
            case "investmentSystem": return INVEST_SYSTEM_COLUMNS;
            case "energyVehicle": return ENERGY_VEHICLE_COLUMNS;
            case "energyAuth": return ENERGY_AUTH_COLUMNS;
            case "passengerIndividual": return PAX_INDIVIDUAL_COLUMNS;
            case "wycTotal": return WYC_TOTAL_COLUMNS;
            case "wycOrder": return WYC_ORDER_COLUMNS;
            default: return new ArrayList<>();
        }
    }
@@ -374,6 +427,9 @@
    private static final List<Map<String, Object>> INVEST_SYSTEM_COLUMNS = new ArrayList<>();
    private static final List<Map<String, Object>> ENERGY_VEHICLE_COLUMNS = new ArrayList<>();
    private static final List<Map<String, Object>> ENERGY_AUTH_COLUMNS = new ArrayList<>();
    private static final List<Map<String, Object>> PAX_INDIVIDUAL_COLUMNS = new ArrayList<>();
    private static final List<Map<String, Object>> WYC_TOTAL_COLUMNS = new ArrayList<>();
    private static final List<Map<String, Object>> WYC_ORDER_COLUMNS = new ArrayList<>();

    static {
        H2032_COLUMNS.add(col("reportPeriod", "报表期", 100));
@@ -604,5 +660,34 @@
        ENERGY_AUTH_COLUMNS.add(col("markedTonnage", "标记吨位", 100));
        ENERGY_AUTH_COLUMNS.add(col("tractionQuality", "牵引质量", 110));

        PAX_INDIVIDUAL_COLUMNS.add(col("reportPeriod", "报表期", 100));
        PAX_INDIVIDUAL_COLUMNS.add(col("regionCode", "所属地区", 110));
        PAX_INDIVIDUAL_COLUMNS.add(col("city", "市州", 110));
        PAX_INDIVIDUAL_COLUMNS.add(col("enterpriseCode", "企业代码", 130));
        PAX_INDIVIDUAL_COLUMNS.add(col("enterpriseName", "企业名称", 220));
        PAX_INDIVIDUAL_COLUMNS.add(col("passengerCount", "个体客运量", 130));
        PAX_INDIVIDUAL_COLUMNS.add(col("turnover", "个体旅客周转量", 150));

        WYC_TOTAL_COLUMNS.add(col("reportPeriod", "报表期", 100));
        WYC_TOTAL_COLUMNS.add(col("pinK", "全省网约车客运量(万人次)", 210));
        WYC_TOTAL_COLUMNS.add(col("pinCK", "其中城市内客运量(万人次)", 210));
        WYC_TOTAL_COLUMNS.add(col("pinZ", "全省网约车周转量(万人公里)", 220));
        WYC_TOTAL_COLUMNS.add(col("pinCZ", "其中城市内周转量(万人公里)", 220));

        WYC_ORDER_COLUMNS.add(col("reportPeriod", "报表期", 100));
        WYC_ORDER_COLUMNS.add(col("pinK", "全省客运量(万人次)", 170));
        WYC_ORDER_COLUMNS.add(col("pinCK", "其中城市内客运量", 170));
        WYC_ORDER_COLUMNS.add(col("pinZ", "全省周转量(万人公里)", 180));
        WYC_ORDER_COLUMNS.add(col("pinCZ", "其中城市内周转量", 170));
        WYC_ORDER_COLUMNS.add(col("orderSum", "订单合计(单)", 130));
        String[] wycOrderCityProps = { "orderWuhan", "orderHuangshi", "orderShiyan", "orderYichang", "orderXiangyang",
                "orderEzhou", "orderJingmen", "orderXiaogan", "orderJingzhou", "orderHuanggang", "orderXianning",
                "orderSuizhou", "orderEnshi", "orderXiantao", "orderQianjiang", "orderTianmen", "orderShennong" };
        String[] wycOrderCityNames = { "武汉", "黄石", "十堰", "宜昌", "襄阳", "鄂州", "荆门", "孝感", "荆州", "黄冈",
                "咸宁", "随州", "恩施", "仙桃", "潜江", "天门", "神农架" };
        for (int i = 0; i < wycOrderCityProps.length; i++) {
            WYC_ORDER_COLUMNS.add(col(wycOrderCityProps[i], wycOrderCityNames[i] + "订单(单)", 120));
        }

    }
}

 traffic-audit-web/src/views/DataView.vue

@@ -71,14 +71,17 @@
        {
          key: 'passenger', name: '公路旅客', types: [
            { value: 'h2031', label: '公路旅客运输月度生产情况' },
            { value: 'passengerAuth', label: '运政车辆数' }
            { value: 'passengerAuth', label: '运政车辆数' },
            { value: 'passengerIndividual', label: '个体客运量/周转量' }
          ]
        },
        {
          key: 'city', name: '城市客运', types: [
            { value: 'cityBus', label: '城市公共交通月度运营情况' },
            { value: 'cityTaxi', label: '巡游出租汽车运营服务情况月报' },
            { value: 'cityTaxiAuth', label: '出租车运政车辆' }
            { value: 'cityTaxiAuth', label: '出租车运政车辆' },
            { value: 'wycTotal', label: '网约车总数' },
            { value: 'wycOrder', label: '网约车订单及全省总量' }
          ]
        },
        {