调度命令-接口注释完善

src/main/java/club/joylink/rtss/controller/simulation/SimulationV1Controller.java

@@ -42,10 +42,7 @@ import javax.validation.constraints.NotBlank;
 import javax.validation.constraints.NotNull;
 import java.time.LocalDateTime;
 import java.time.LocalTime;
-import java.util.List;
+import java.util.*;
-import java.util.Map;
-import java.util.Objects;
-import java.util.Set;
 
 /**
  * 新仿真接口
@@ -201,6 +198,9 @@ public class SimulationV1Controller {
     @PostMapping("/{group}/operate/{type}")
     public Object operate(@PathVariable @NotBlank String group, @PathVariable @NotNull String type,
                           @RequestBody(required = false) Map<String, Object> param, @RequestAttribute AccountVO user) {
+        if(null == param){
+            param = new HashMap<>();
+        }
         return this.groupSimulationService.operate(group, type, param, user);
     }
 

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/DisCmd.java

@@ -96,7 +96,7 @@ public class DisCmd {
         /**
          * 转发调度命令
          */
-        Trans,
+        Forward,
         /**
          * 请求调度命令
          */
@@ -104,11 +104,11 @@ public class DisCmd {
         /**
          * 长效调度命令
          */
-        Long,
+        LongTerm,
         /**
          * 班计划调度命令
          */
-        Plan,
+        ShiftScheduling,
         /**
          * 其他调度命令
          */

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/DisCmdRcvCompanyVo.java

@@ -20,7 +20,7 @@ public class DisCmdRcvCompanyVo {
      */
     private String        id;
     /**
-     * 受令单位类型
+     * 受令单位类型[Dispatcher(调度台)  Station(车站) Train(无线机车) Tsr(列控服务器)]
      * @see  DisCmdRcvCompany.Type
      */
     private String        type = "Undefined";
@@ -62,7 +62,7 @@ public class DisCmdRcvCompanyVo {
     private String        trainCode;
     /////////////////////运行时数据//////////////////
     /**
-     * 最终受令端对于调度命令的状态
+     * 最终受令端对于调度命令的状态[Received(接收) Signed(签收) Reject(拒签)]
      * @see DisCmdRcvCompany.Status
      */
     private String        state = "Undefined";
@@ -80,7 +80,7 @@ public class DisCmdRcvCompanyVo {
      */
     private String        signBy;
     /**
-     * 无线调度命令的中转站对调度命令的状态
+     * 无线调度命令的中转站对调度命令的状态[Received(接收) Sent(发送)]
      * @see DisCmdRcvCompany.TransStatus
      */
     private String        transStatus = "Undefined";

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/DisCmdRspVo.java

@@ -70,7 +70,7 @@ public class DisCmdRspVo {
      */
     private String                 designer;
     /**
-     * 调度命令类型
+     * 调度命令类型[Normal(普通调度命令) Construct(施工调度命令) Forward(转发调度命令) Request(请求调度命令) LongTerm(长效调度命令) ShiftScheduling(班计划调度命令) Other(其他调度命令)]
      * @see DisCmd.Type
      */
     private String                 type = "Undefined";

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/DisCmdSendCompanyVo.java

@@ -13,7 +13,7 @@ import java.time.LocalDateTime;
 public class DisCmdSendCompanyVo {
 
     /**
-     * 发令单位类型
+     * 发令单位类型[Dispatcher(调度台)  Station(车站)]
      * @see DisCmdSendCompany.Type
      */
     private String        type = "Undefined";
@@ -31,7 +31,7 @@ public class DisCmdSendCompanyVo {
     private String        disCmdCode;
     //////////////////运行时数据////////////////
     /**
-     * 调度命令对应发令单的状态
+     * 调度命令对应发令单的状态[Cache(缓存) Send(发送) Signed(签收完成)]
      * @see DisCmdSendCompany.Status
      */
     private String        state = "Undefined";

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/DisCmdSrcVo.java

@@ -51,7 +51,7 @@ public class DisCmdSrcVo {
      */
     private String                 designer;
     /**
-     * 调度命令类型
+     * 调度命令类型[Normal(普通调度命令) Construct(施工调度命令) Forward(转发调度命令) Request(请求调度命令) LongTerm(长效调度命令) ShiftScheduling(班计划调度命令) Other(其他调度命令)]
      * @see DisCmd.Type
      */
     private  String                type = "Undefined";

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/FindAllDisCmdForHolderRspVo.java

@@ -13,7 +13,7 @@ import java.util.Map;
 public class FindAllDisCmdForHolderRspVo {
     ///////////////////////调度命令持有者相关信息/////////////////////////
     /**
-     * 持有者类型
+     * 持有者类型[Dispatcher(调度台) Station(车站) Train(无线机车) Tsr(列控服务器)]
      */
     private DisCmdHolderEnum          holderType;
     /**

src/main/java/club/joylink/rtss/simulation/cbtc/CTC/rail/cmd/vo/ReceiptVo.java

@@ -14,7 +14,7 @@ public class ReceiptVo {
      */
     private String disCmdCode;
     /**
-     * 回执状态
+     * 回执状态[Sent(已发送) AllSigned(已全部签收) Received(已接收) Signed(已签收) ProxySigned(已代签) Read(已阅读) Rejected(已拒签)]
      * @see ReceiptVo.Status
      */
     private String state;