refactor platform logic and add gasorder domain

backend/api/cmd/cli/main.go

@@ -1,4 +1,4 @@
-// 平台 API 的版本命令行工具。
+// 平台 API 命令行工具。
 package main
 
 import (
@@ -8,12 +8,24 @@ import (
 
 func main() {
 	if len(os.Args) < 2 {
-		fmt.Println("usage: platform-cli <version>")
-		return
-	}
-	if os.Args[1] != "version" {
-		fmt.Fprintf(os.Stderr, "unknown command: %s\n", os.Args[1])
+		printUsage()
+		os.Exit(1)
+	}
+	switch os.Args[1] {
+	case "version":
+		fmt.Println("platform-cli 0.1.0")
+	case "resource-contract":
+		if err := writeResourceContract(os.Stdout); err != nil {
+			fmt.Fprintln(os.Stderr, err)
+			os.Exit(1)
+		}
+	default:
+		fmt.Fprintf(os.Stderr, "unknown command: %s\n", os.Args[1])
+		printUsage()
 		os.Exit(1)
 	}
-	fmt.Println("platform-cli 0.1.0")
+}
+
+func printUsage() {
+	fmt.Fprintln(os.Stderr, "usage: platform-cli <version|resource-contract>")
 }

backend/api/cmd/cli/resource_contract.go

@@ -0,0 +1,48 @@
+package main
+
+import (
+	"encoding/json"
+	"io"
+	"strings"
+
+	"git.apinb.com/heqiapp/platforms/backend/api/internal/logic/platform"
+	"git.apinb.com/heqiapp/platforms/backend/api/internal/routers"
+	"github.com/gin-gonic/gin"
+)
+
+type route struct {
+	Method string `json:"method"`
+	Path   string `json:"path"`
+}
+
+type contract struct {
+	Domain   string `json:"domain"`
+	Name     string `json:"name"`
+	Path     string `json:"path"`
+	PageKind string `json:"pageKind"`
+	Mode     string `json:"mode"`
+}
+
+type manifest struct {
+	Resources []contract `json:"resources"`
+	Routes    []route    `json:"routes"`
+}
+
+func writeResourceContract(output io.Writer) error {
+	gin.SetMode(gin.ReleaseMode)
+	engine := gin.New()
+	routers.RegisterPlatform("heqi", engine)
+	routes := make([]route, 0, len(engine.Routes()))
+	for _, item := range engine.Routes() {
+		routes = append(routes, route{Method: item.Method, Path: strings.TrimPrefix(item.Path, "/heqi/platform/v1")})
+	}
+	expected := platform.ExpectedResources()
+	contracts := make([]contract, 0, len(expected))
+	for _, item := range expected {
+		contracts = append(contracts, contract{
+			Domain: item.Domain, Name: item.Name, Path: item.Path,
+			PageKind: item.PageKind, Mode: string(item.Mode),
+		})
+	}
+	return json.NewEncoder(output).Encode(manifest{Resources: contracts, Routes: routes})
+}