浏览代码

删除多余注释

画安 6 天之前
父节点
当前提交
2be413afa8
共有 5 个文件被更改,包括 23 次插入85 次删除
  1. 0 4
      src/components/ui/SeamlessScroll.vue
  2. 10 39
      src/config/chartColors.js
  3. 7 21
      src/config/menus.js
  4. 3 18
      src/mock/_sample_phase_icons.js
  5. 3 3
      src/mock/data.js

+ 0 - 4
src/components/ui/SeamlessScroll.vue

@@ -51,7 +51,6 @@ export default {
     }
   },
   mounted() {
-    console.log('✅ SeamlessScroll: 组件已挂载,准备初始化滚动');
     this.initScroll();
     
     // 全屏切换后容器高度变化,需要重新初始化滚动
@@ -63,7 +62,6 @@ export default {
   watch: {
     data: {
       handler() {
-        console.log('🔄 SeamlessScroll: 监测到数据变化');
         this.initScroll();
       },
       deep: true,
@@ -95,7 +93,6 @@ export default {
 
       // 直接判断数据量,不依赖 computed 副作用的时序
       if (!this.data || this.data.length <= this.limit) {
-        console.log('🛑 SeamlessScroll: 数据量不足,无需滚动', this.data, this.limit);
         return;
       }
 
@@ -108,7 +105,6 @@ export default {
 
           // 如果 4 份数据加起来都没容器高,说明数据极其短,强制取消滚动避免报错
           if (wrapper.scrollHeight <= wrapper.clientHeight) {
-            console.warn('⚠️ SeamlessScroll: 数据总高度依然小于容器,取消滚动。');
             return;
           }
 

+ 10 - 39
src/config/chartColors.js

@@ -1,24 +1,8 @@
-/**
- * 图表配色注册表(控制模式 + 设备故障 + 通用基础色)
- *
- * 设计原则:
- *   - 暗色大屏背景, 全部色相亮度 50-65% (饱和、不刺眼)
- *   - 同业务族用同色系: 算法类蓝色, 协调网络绿色, 人工/中央紫色, 预警黄/橙, 紧急红, 关闭/异常灰
- *   - 后端只返 { name, value }, 前端按 name 查表注入 color
- *   - 未注册的 name 走 FALLBACK_PALETTE 按 hash 兜底
- *
- * 用法:
- *   import {
- *     applyControlModeColors,   // 给控制模式列表注入色
- *     applyDeviceFaultColors,   // 给设备故障列表注入色
- *     resolveControlModeColor,
- *     resolveDeviceFaultColor,
- *   } from '@/config/chartColors'
- */
-
-// ============================================================================
-// 1. 通用基础色
-// ============================================================================
+// 图表配色注册表(控制模式 + 设备故障 + 通用基础色)。
+// 暗色大屏背景下亮度统一 50-65%;同业务族同色系(算法蓝/协调绿/人工紫/预警黄橙/紧急红/异常灰)。
+// 后端只返 { name, value },前端按 name 查表注入 color;未注册的走 FALLBACK_PALETTE 按 hash 兜底。
+
+// 通用基础色
 export const COLORS = {
   normal: '#5EC8FF',  // 正常 (亮蓝)
   warn:   '#faad14',  // 警告 (琥珀黄)
@@ -27,11 +11,7 @@ export const COLORS = {
   muted:  '#6b7280',  // 静默 (中灰)
 }
 
-// ============================================================================
-// 2. 红色严重等级梯度 (按严重程度从轻到重)
-//    暗色背景下 4 档亮度梯度: 82% → 71% → 56% → 32%
-//    相邻差 ≥ 11%, 远大于"全 0° 色相 + 7-8% 亮度差"的肉眼极限
-// ============================================================================
+// 红色严重等级梯度(从轻到重):4 档亮度 82%/71%/56%/32%,相邻差 ≥11% 保证可分辨
 export const RED_GRADIENT = {
   L1_LIGHT:  '#FFA5A5',  // L=82% 樱粉 — 最轻级
   L2_MEDIUM: '#FF6B6B',  // L=71% 桃红
@@ -39,9 +19,7 @@ export const RED_GRADIENT = {
   L4_DEEP:   '#8B1A1A',  // L=32% 砖红 — 最严重
 }
 
-// ============================================================================
-// 3. 设备故障 → 颜色 (按 name 查表)
-// ============================================================================
+// 设备故障 → 颜色(按 name 查表)
 export const DEVICE_FAULT_COLORS = {
   // 通用
   '正常':       COLORS.normal,
@@ -61,10 +39,7 @@ export const DEVICE_FAULT_COLORS = {
   '红灯故障':   RED_GRADIENT.L4_DEEP,
 }
 
-// ============================================================================
-// 4. 控制模式 16 种 → 颜色 (按 name 查表)
-//    16 种业务模式, 排序按业务族, 不影响 API 返回顺序
-// ============================================================================
+// 控制模式 16 种 → 颜色(按 name 查表):按业务族排序,不影响 API 返回顺序
 export const CONTROL_MODE_COLORS = {
   // ── 算法类 (冷色蓝) ───────────────────────────────
   '定周期控制':   '#33a3ff',
@@ -110,9 +85,7 @@ function hashCode(s) {
   return Math.abs(h)
 }
 
-// ============================================================================
-// 5. 解析单条 name → 颜色
-// ============================================================================
+// 解析单条 name → 颜色
 
 /** 按 name 查控制模式色, 未注册走 hash 兜底 */
 export function resolveControlModeColor(name) {
@@ -131,9 +104,7 @@ export function resolveDeviceFaultColor(name) {
   return grad[hashCode(name) % grad.length]
 }
 
-// ============================================================================
-// 6. 批量注入色 (给整个 chartData 列表)
-// ============================================================================
+// 批量注入色(给整个 chartData 列表)
 
 /** 控制模式列表注入色 */
 export function applyControlModeColors(list) {

+ 7 - 21
src/config/menus.js

@@ -1,28 +1,14 @@
-// =============================================================================
-// 全应用顶层菜单的单一数据源.
-//
-// 字段约定:
-//   name        显示名 (径向上的"name", BottomDock 上对应 label)
-//   path        路由路径 (BottomDock 对应 route)
-//   side        径向布局位置: 'left' | 'right'. 仅前 6 项生效;
-//               第 7 项起一律落到 BottomDock 溢出.
-//   theme       BottomDock 主题色: 'blue' | 'gold' (默认 'blue')
-//   icon, hoverIcon            径向布局上的主图标 (Main.vue 用)
-//   halo, hoverHalo            径向布局的光圈底座 (Main.vue 用)
-//   dockIcon, dockHoverIcon    BottomDock 上的图标
-//
-// 添加新菜单:
-//   1) 列入下面的 allMenus 数组
-//   2) 第 1~6 项要带 side; 第 7 项起 side 可省略 (不参与径向)
-//   3) Main 页面径向只取前 6, 多出的自动落到 BottomDock; DashboardLayout
-//      所在的子页面看到的是全部 (含前 6).
-// =============================================================================
+// 全应用顶层菜单的单一数据源。
+// 字段:name 显示名(BottomDock 对应 label) / path 路由(对应 route) /
+//       side 径向位置 'left'|'right'(仅前 6 项生效) / theme BottomDock 主题色 'blue'|'gold' /
+//       icon,hoverIcon 径向主图标 / halo,hoverHalo 径向光圈底座 / dockIcon,dockHoverIcon BottomDock 图标。
+// 前 6 项进径向布局,第 7 项起 side 可省略、自动溢出到 BottomDock;子页面可见全部。
 
 const _halo = require('@/assets/main/main-menu-bg.png');
 const _haloHover = require('@/assets/main/main-menu-bg-hover.png');
 
 export const allMenus = [
-  // ========== 前 6 项: 径向布局 (3 left + 3 right) ==========
+  // 前 6 项:径向布局 (3 left + 3 right)
   {
     name: '首页', path: '/home', side: 'left', theme: 'blue',
     icon: require('@/assets/main/main-home.png'),
@@ -72,7 +58,7 @@ export const allMenus = [
     dockHoverIcon: require('@/assets/main/dock-setting-hover.png'),
   },
 
-  // ========== 第 7 项起: 径向放不下, 自动落到 BottomDock ==========
+  // 第 7 项起:径向放不下,自动落到 BottomDock
   {
     name: '通知中心', path: '/notify', theme: 'blue',
     dockIcon: require('@/assets/main/dock-watch.png'),

+ 3 - 18
src/mock/_sample_phase_icons.js

@@ -2,7 +2,7 @@
 // 覆盖 1-3 个 icon 的各种组合 + 边界情况,验证 PhaseDiagram / SignalTimingChart
 // 在不同 icon 数量下的渲染。
 //
-// === 12 个合法 token(按驶入方向分 4 组,每组 3 种动作)===
+// 12 个合法 token(按驶入方向分 4 组,每组 3 种动作)
 //
 //                       直行              左转                    左转带掉头
 //   上方驶入 (LT 锚)   STRAIGHT_DOWN     TURN_DOWN_LEFT          TURN_DOWN_LEFT_UTURN
@@ -13,10 +13,7 @@
 // 每个 token 锚定到 30×30 单位路口方块的某个角落;同组 3 个 token 共用同一角落,
 // 放在同一阶段会重叠(视觉只见最后那一个)。所以一阶段独立角落上限 = 4。
 
-// ============================================================
 // 一、stageList 示例 —— 喂给 PhaseDiagram(路口方块组件)
-// ============================================================
-//
 // 字段:
 //   value       阶段编号字符串("1"/"2"/...)
 //   phaseName   显示名("P1"/"P2"/...)
@@ -34,7 +31,7 @@
 // 每阶段 25 秒,总周期 300 秒
 // 排序规则:corner 内 icon 渲染顺序固定为 右转 → 直行 → 左转(数据数组顺序不影响)
 export const SAMPLE_STAGE_LIST = [
-  // ============= 南北双向(6 阶段)=============
+  // 南北双向(6 阶段)
   // P1-P3:每方向 1 icon,单动作双向
   {
     value: '1', phaseName: 'P1', time: 25, direction: 'ns',
@@ -73,7 +70,7 @@ export const SAMPLE_STAGE_LIST = [
     _note: '【非对称】北直左右 + 南直'
   },
 
-  // ============= 东西双向(6 阶段)=============
+  // 东西双向(6 阶段)
   {
     value: '7', phaseName: 'P7', time: 25, direction: 'ew',
     icons: ['STRAIGHT_LEFT', 'STRAIGHT_RIGHT'],
@@ -110,10 +107,7 @@ export const SAMPLE_STAGE_LIST = [
   },
 ];
 
-// ============================================================
 // 二、phaseData 示例 —— 喂给 SignalTimingChart(时间条带)
-// ============================================================
-//
 // 9 元组结构(一行 = 一段连续色块):
 //   [trackIdx, startTime, endTime, phaseName, duration, colorType, iconStr, direction, stageTotal]
 //          0          1        2         3         4          5        6          7           8
@@ -153,10 +147,7 @@ export const SAMPLE_PHASE_DATA = [
   [0, 98, 100, '',   2, 'red',    null,                                     'ew'],
 ];
 
-// ============================================================
 // 三、SignalTimingChart 的 hasL/hasR 提示
-// ============================================================
-//
 // 相位图深绿色背景的宽度按 icon 角落分布动态变化(见 SignalTimingChart:528-531):
 //   - icons 同时含 L 锚 (LT/LB) 和 R 锚 (RT/RB) → darkWidth ≈ 46px
 //   - icons 只含 L 或只含 R 一侧                → darkWidth ≈ 28px
@@ -169,10 +160,7 @@ export const SAMPLE_PHASE_DATA = [
 //   P3 icon×3 (RT+LB+RB)  → L+R → 46px
 //   P4 icon×2 (RT+LT)     → L+R → 46px
 
-// ============================================================
 // 四、Random 组合生成器(后续接入 mock 时可直接 reuse)
-// ============================================================
-//
 // 按"4 个角落各最多 1 个 token"的规则随机抽 1-3 个 icon。
 // 同角落 3 个 token 等价,随机选一个动作。
 
@@ -198,10 +186,7 @@ export function randomIconCombo(n) {
 // 示例:randomIconCombo(2) → ['STRAIGHT_DOWN', 'TURN_LEFT_DOWN'] (LT+RT)
 //      randomIconCombo()   → ['STRAIGHT_UP']                    (n 随机 = 1)
 
-// ============================================================
 // 五、Demo 路口完整数据构造(用于 apiGetCrossingDetailData 注入)
-// ============================================================
-//
 // 把 SAMPLE_STAGE_LIST 转成 CrossingDetailPanel 直接可用的 stageList +
 // 配套 phaseData + cycleLength。每个阶段:
 //   绿灯 = stageList[i].time - 8 秒

+ 3 - 3
src/mock/data.js

@@ -44,7 +44,7 @@ export function makePoints(n = 200) {
   return pts;
 }
 
-// ====== 干路监控 mock 数据 ======
+// 干路监控 mock 数据
 
 // 模拟 API 请求获取树形数据
 export function menuData(tabId) {
@@ -131,7 +131,7 @@ export function menuData(tabId) {
   });
 }
 
-// ====== 交通时序图 mock 数据 ======
+// 交通时序图 mock 数据
 
 const trafficIntersections = [
   '段祺瑞执政府', '剪子巷', '宽街', '北河沿',
@@ -264,7 +264,7 @@ export function getIntersectionData(id) {
   });
 }
 
-// ====== 首页 mock 数据 ======
+// 首页 mock 数据
 
 export function makeHomeData() {
   // 这里做“看起来真”的波动