init

sl-express-ms-track-api/.gitignore

@@ -0,0 +1,3 @@
+.idea
+target/
+*.iml

sl-express-ms-track-api/pom.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.sl-express</groupId>
+        <artifactId>sl-express-parent</artifactId>
+        <version>1.4</version>
+    </parent>
+
+    <groupId>com.sl-express.ms.track</groupId>
+    <artifactId>sl-express-ms-track-api</artifactId>
+    <version>1.1-SNAPSHOT</version>
+    <description>车辆轨迹微服务-Feign接口</description>
+
+    <properties>
+        <maven.compiler.source>11</maven.compiler.source>
+        <maven.compiler.target>11</maven.compiler.target>
+        <sl-express-ms-track-domain.version>1.1-SNAPSHOT</sl-express-ms-track-domain.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.sl-express.ms.track</groupId>
+            <artifactId>sl-express-ms-track-domain</artifactId>
+            <version>${sl-express-ms-track-domain.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-openfeign</artifactId>
+        </dependency>
+    </dependencies>
+
+</project>

sl-express-ms-track-api/src/main/java/com/sl/ms/track/api/TrackFeign.java

@@ -0,0 +1,66 @@
+package com.sl.ms.track.api;
+
+import com.sl.ms.track.domain.dto.TrackDTO;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * 终端管理
+ *
+ * @author zzj
+ * @version 1.0
+ */
+@FeignClient(value = "sl-express-ms-track", contextId = "Track", path = "track")
+public interface TrackFeign {
+
+    /**
+     * 创建轨迹，会完成路线规划
+     *
+     * @param transportOrderId 运单号
+     * @return 是否成功
+     */
+    @PostMapping
+    boolean create(@RequestParam("transportOrderId") String transportOrderId);
+
+    /**
+     * 完成轨迹，修改为完成状态
+     *
+     * @param transportOrderIds 运单号列表
+     * @return 是否成功
+     */
+    @PutMapping("complete")
+    boolean complete(@RequestParam("transportOrderIds") List<String> transportOrderIds);
+
+    /**
+     * 通过运单号查询轨迹
+     *
+     * @param transportOrderId 运单号
+     * @return 轨迹数据
+     */
+    @GetMapping("{transportOrderId}")
+    TrackDTO queryByTransportOrderId(@PathVariable("transportOrderId") String transportOrderId);
+
+    /**
+     * 车辆上报位置
+     *
+     * @param transportTaskId 运输任务id
+     * @param lng             经度
+     * @param lat             纬度
+     * @return 是否成功
+     */
+    @PutMapping("upload/truck")
+    boolean uploadFromTruck(@RequestParam("transportTaskId") Long transportTaskId, @RequestParam("lng") double lng, @RequestParam("lat") double lat);
+
+    /**
+     * 快递员上报位置
+     *
+     * @param transportOrderIds 运单号列表
+     * @param lng               经度
+     * @param lat               纬度
+     * @return 是否成功
+     */
+    @PutMapping("upload/courier")
+    boolean uploadFromCourier(@RequestParam("transportOrderIds") List<String> transportOrderIds, @RequestParam("lng") double lng, @RequestParam("lat") double lat);
+}