驾驶舱接口添加注释

src/open-data/open-data.mapper.ts

@@ -298,7 +298,7 @@ class OpenDataMapper {
           'SELECT a.stat_time AS time,a.`value`,c.address_code as addressCode from szja_live_stat_month a LEFT JOIN szja_user_home b ON b.user_id=a.user_id LEFT JOIN szja_hcc_info c ON c.id=b.hcc_id WHERE TIMESTAMPDIFF(MONTH,a.create_time,now()) <= ?';
         break;
       default:
-        return false;
+        throw BusinessException.throwValidateError()
     }
     if (areaCode) {
       sql += ' AND c.address_code = ?';

src/open-data/open-data.service.ts

@@ -245,6 +245,7 @@ export class OpenDataService {
       totalPage: 0,
       homeList: [],
     };
+    //填充总数与页数相关的数据
     data.totalPage = Math.ceil(data.totalNum / Number(pageSize));
     if (Number(pageNo) * Number(pageSize) < data.totalNum) {
       data.hasNext = true;
@@ -303,7 +304,7 @@ export class OpenDataService {
     if (serviceNumber?.length) {
       data.totalNum = serviceNumber[0].sum;
     }
-
+    // 以appid为主键将appid相同的数据合并到map中
     serviceData.forEach((val) => {
       if (serviceDataMap.has(val.app_id)) {
         serviceDataMap.get(val.app_id).push(val);
@@ -311,7 +312,7 @@ export class OpenDataService {
         serviceDataMap.set(val.app_id, [val]);
       }
     });
-
+    // 遍历map填充每个服务的日活列表，名称，id，icon和总活跃数
     serviceDataMap.forEach((val) => {
       const dayNumList = [];
       val.forEach((item) => {