From febd66aaed915cb58c4fbc732fed40fc2955df24 Mon Sep 17 00:00:00 2001
From: yinzijian <yinzijian@haomozhixing.onaliyun.com>
Date: Sun, 26 Oct 2025 12:25:17 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: yinzijian <yinzijian@haomozhixing.onaliyun.com>
---
 proto/phase_server.proto | 57 ++++++++++++++++++++--------------------
 1 file changed, 29 insertions(+), 28 deletions(-)

diff --git a/proto/phase_server.proto b/proto/phase_server.proto
index 93cc7ae..775bb95 100644
--- a/proto/phase_server.proto
+++ b/proto/phase_server.proto
@@ -243,41 +243,42 @@ message CrossRunningPhaseRequest {
   repeated string crossids = 2;
 }
 
+//路口运行中方案
 message CrossRunningPhaseResponse {
   int32 code = 1;
   string msg = 2;
-  repeated List data = 3;
+  repeated List data = 3; //数据列表
   message List {
-    int32 citycode = 1;
-    string crossid = 2;
-    string jj_crossid = 3;
-    int32 scheduleid = 4;
-    string schedule_week = 5;
-    string schedule_name = 6;
-    repeated tps_list tps = 7;
+    int32 citycode = 1;   //城市ID
+    string crossid = 2;   //路口ID
+    string jj_crossid = 3;  //交警路口ID
+    int32 scheduleid = 4;     //日计划号
+    string schedule_week = 5;   //日计划执行周，'1,2,3,4,5'
+    string schedule_name = 6;   //日计划执行名称，'工作日'或者'周末'
+    repeated tps_list tps = 7;  //时段列表
   }
-  message tps_list {
-    string tp_start = 1;
-    string tp_end = 2;
-    int32 planid = 3;
-    string plan_name = 4;
-    string control_mode = 5;
-    int32 cycle = 6;
-    int32 coord_phaseid = 7;
-    int32 offset = 8;
-    repeated stages stage_list = 9;
+  message tps_list {      
+    string tp_start = 1;    //时段开始时间,'05:00'
+    string tp_end = 2;      //时段结束时间,'17:00'
+    int32 planid = 3;       //方案号
+    string plan_name = 4;   //方案名称
+    string control_mode = 5;  //控制模式，'固定模式'
+    int32 cycle = 6;          //周期，180
+    int32 coord_phaseid = 7;    //协调相位ID
+    int32 offset = 8;           //相位差
+    repeated stages stage_list = 9;   //一个方案中的多个阶段
   }
   message stages {
-    int32 stageid = 1;
-    int32 stage_duration = 2;
-    string stage_name = 3;
-    int32 green = 4;
-    int32 yellow = 5;
-    int32 allred = 6;
-    string phases = 7;
-    string phases_name = 8;
-    int32 min_green = 9;
-    int32 max_green = 10;
+    int32 stageid = 1;      //阶段ID
+    int32 stage_duration = 2; //阶段时长
+    string stage_name = 3;    //阶段名称
+    int32 green = 4;          //绿灯时长
+    int32 yellow = 5;         //黄灯时长
+    int32 allred = 6;         //全红时长
+    string phases = 7;        //相位ID列表，'1,2,3'
+    string phases_name = 8;   //相位名称列表，'北左转,北直行,南左转,南直行,东北直行,南行人'
+    int32 min_green = 9;      //最小绿灯时长
+    int32 max_green = 10;     //最大绿灯时长
   }
 }