system: マスタ管理サブコマンド (list/show/data/import/upload) を追加 (#33)

管理者向けの system master API 一式を呼び出す `xpoint system master`
サブコマンド群を追加。

- `system master list` — GET /api/v1/system/master でマスタ一覧取得
- `system master show <master_table_name>` — GET /api/v1/system/master/
  {master_table_name} でユーザ固有マスタのプロパティ (フィールド定義)
  を取得する
- `system master data <master_code>` — GET /api/v1/system/master/
  {master_code}/data[.json|.csv] でマスタデータを取得する。
  --type (0: 簡易 / 1: ユーザ固有)・--format (json|csv)・
  --rows/--offset/--file-name/--delimiter/--title/--no-title/--fields
  など CSV エクスポート用のクエリも公開
- `system master import <master_code>` — PUT /api/v1/system/master/
  {master_code}/data で簡易マスタへ JSON 形式のデータを投入する。
  --data にインラインJSON、ファイル、-(stdin) を指定できる。
  --overwrite で既存データを置き換える
- `system master upload <master_table_name>` — POST /multiapi/v1/
  system/master/{master_table_name}/data でユーザ固有マスタの
  インポート用 CSV をアップロードする (インポートは実行しない)。
  --file に CSV パスまたは -(stdin)、--overwrite で上書き可能

ついでに downloadBytes を拡張した downloadBytesWithContentType を
追加し、レスポンスの Content-Type も返せるようにした。

refs #25

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: buty4649

cmd/system_master.go

@@ -0,0 +1,371 @@
+package cmd
+
+import (
+	"encoding/json"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+	"text/tabwriter"
+
+	"github.com/pepabo/xpoint-cli/internal/xpoint"
+	"github.com/spf13/cobra"
+)
+
+var (
+	systemMasterListOutput string
+	systemMasterListJQ     string
+	systemMasterShowOutput string
+	systemMasterShowJQ     string
+
+	systemMasterDataType      int
+	systemMasterDataRows      int
+	systemMasterDataOffset    int
+	systemMasterDataFormat    string
+	systemMasterDataFileName  string
+	systemMasterDataDelimiter string
+	systemMasterDataTitle     bool
+	systemMasterDataNoTitle   bool
+	systemMasterDataFields    string
+	systemMasterDataOutput    string
+	systemMasterDataJQ        string
+
+	systemMasterImportOverwrite bool
+	systemMasterImportData      string
+	systemMasterImportJQ        string
+
+	systemMasterUploadFile      string
+	systemMasterUploadOverwrite bool
+)
+
+var systemMasterCmd = &cobra.Command{
+	Use:   "master",
+	Short: "Manage X-point masters via admin APIs",
+}
+
+var systemMasterListCmd = &cobra.Command{
+	Use:   "list",
+	Short: "List masters (admin)",
+	Long:  "List all masters via GET /api/v1/system/master. Requires an administrator account.",
+	RunE:  runSystemMasterList,
+}
+
+var systemMasterShowCmd = &cobra.Command{
+	Use:   "show <master_table_name>",
+	Short: "Show a user-specific master's property definition",
+	Long: `Fetch user-specific master property info via
+GET /api/v1/system/master/{master_table_name}. Requires an administrator
+account.`,
+	Args: cobra.ExactArgs(1),
+	RunE: runSystemMasterShow,
+}
+
+var systemMasterDataCmd = &cobra.Command{
+	Use:   "data <master_code>",
+	Short: "Export master data (JSON or CSV)",
+	Long: `Export master rows via GET /api/v1/system/master/{master_code}/data.
+
+--type (required) selects the master kind:
+  0  simple master
+  1  user-specific master (pass the table_name as <master_code>)
+
+--format defaults to json. Use --format csv for CSV output; the CSV
+payload is written to stdout (or --output FILE / DIR/).`,
+	Args: cobra.ExactArgs(1),
+	RunE: runSystemMasterData,
+}
+
+var systemMasterImportCmd = &cobra.Command{
+	Use:   "import <master_code>",
+	Short: "Import rows into a simple master",
+	Long: `Import data rows into a simple master via
+PUT /api/v1/system/master/{master_code}/data.
+
+--data takes a JSON array of {"code","value"} objects, either inline,
+as a file path, or - for stdin.
+Pass --overwrite to replace existing data instead of appending.`,
+	Args: cobra.ExactArgs(1),
+	RunE: runSystemMasterImport,
+}
+
+var systemMasterUploadCmd = &cobra.Command{
+	Use:   "upload <master_table_name>",
+	Short: "Upload a CSV for a user-specific master's import staging",
+	Long: `Upload a CSV via POST /multiapi/v1/system/master/{master_table_name}/data.
+
+The upload only stages the file; the import itself is run later from
+the admin site's task management (manually or by schedule).`,
+	Args: cobra.ExactArgs(1),
+	RunE: runSystemMasterUpload,
+}
+
+func init() {
+	systemCmd.AddCommand(systemMasterCmd)
+	systemMasterCmd.AddCommand(systemMasterListCmd)
+	systemMasterCmd.AddCommand(systemMasterShowCmd)
+	systemMasterCmd.AddCommand(systemMasterDataCmd)
+	systemMasterCmd.AddCommand(systemMasterImportCmd)
+	systemMasterCmd.AddCommand(systemMasterUploadCmd)
+
+	lf := systemMasterListCmd.Flags()
+	lf.StringVarP(&systemMasterListOutput, "output", "o", "", "output format: table|json (default: table on TTY, json otherwise)")
+	lf.StringVar(&systemMasterListJQ, "jq", "", "apply a gojq filter to the JSON response (forces JSON output)")
+
+	sf := systemMasterShowCmd.Flags()
+	sf.StringVarP(&systemMasterShowOutput, "output", "o", "", "output format: table|json (default: table on TTY, json otherwise)")
+	sf.StringVar(&systemMasterShowJQ, "jq", "", "apply a gojq filter to the JSON response (forces JSON output)")
+
+	df := systemMasterDataCmd.Flags()
+	df.IntVar(&systemMasterDataType, "type", -1, "master_type: 0=simple master, 1=user-specific master (required)")
+	df.IntVar(&systemMasterDataRows, "rows", 0, "number of rows to fetch (0 = omit; server default 100; max 1000)")
+	df.IntVar(&systemMasterDataOffset, "offset", 0, "offset (0 = omit; server default 0)")
+	df.StringVar(&systemMasterDataFormat, "format", "json", "output format: json | csv")
+	df.StringVar(&systemMasterDataFileName, "file-name", "", "CSV file name hint (CSV only; default: {master_code}.csv)")
+	df.StringVar(&systemMasterDataDelimiter, "delimiter", "", "CSV delimiter: comma | tab (CSV only; default comma)")
+	df.BoolVar(&systemMasterDataTitle, "title", false, "CSV only (user-specific master): include field names on the first row (default: true)")
+	df.BoolVar(&systemMasterDataNoTitle, "no-title", false, "CSV only (user-specific master): omit field names from the first row")
+	df.StringVar(&systemMasterDataFields, "fields", "", "CSV only (simple master): comma-separated list of field names to include")
+	df.StringVarP(&systemMasterDataOutput, "output", "o", "", "output path: FILE, DIR/, - for stdout (default: stdout for JSON, server-provided filename for CSV)")
+	df.StringVar(&systemMasterDataJQ, "jq", "", "apply a gojq filter to the JSON response (JSON format only)")
+	_ = systemMasterDataCmd.MarkFlagRequired("type")
+
+	imf := systemMasterImportCmd.Flags()
+	imf.BoolVar(&systemMasterImportOverwrite, "overwrite", false, "replace existing simple master data instead of appending")
+	imf.StringVar(&systemMasterImportData, "data", "", "JSON array of {\"code\",\"value\"} rows: inline, file path, or - for stdin (required)")
+	imf.StringVar(&systemMasterImportJQ, "jq", "", "apply a gojq filter to the JSON response")
+	_ = systemMasterImportCmd.MarkFlagRequired("data")
+
+	uf := systemMasterUploadCmd.Flags()
+	uf.StringVar(&systemMasterUploadFile, "file", "", "path to the CSV file to upload, or - for stdin (required)")
+	uf.BoolVar(&systemMasterUploadOverwrite, "overwrite", false, "overwrite the existing staged CSV for this master")
+	_ = systemMasterUploadCmd.MarkFlagRequired("file")
+}
+
+func runSystemMasterList(cmd *cobra.Command, args []string) error {
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	res, err := client.ListMasters(cmd.Context())
+	if err != nil {
+		return err
+	}
+
+	return render(res, resolveOutputFormat(systemMasterListOutput), systemMasterListJQ, func() error {
+		w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)
+		defer w.Flush()
+		fmt.Fprintln(w, "TYPE\tTYPE_NAME\tCODE\tTABLE_NAME\tITEMS\tNAME\tREMARKS")
+		for _, m := range res.Master {
+			code := m.Code
+			if code == "" {
+				code = "-"
+			}
+			tbl := m.TableName
+			if tbl == "" {
+				tbl = "-"
+			}
+			fmt.Fprintf(w, "%d\t%s\t%s\t%s\t%d\t%s\t%s\n",
+				m.Type, m.TypeName, code, tbl, m.ItemCount, m.Name, m.Remarks,
+			)
+		}
+		return nil
+	})
+}
+
+func runSystemMasterShow(cmd *cobra.Command, args []string) error {
+	tableName := strings.TrimSpace(args[0])
+	if tableName == "" {
+		return fmt.Errorf("master_table_name is required")
+	}
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	res, err := client.GetUserMasterInfo(cmd.Context(), tableName)
+	if err != nil {
+		return err
+	}
+	return render(res, resolveOutputFormat(systemMasterShowOutput), systemMasterShowJQ, func() error {
+		fmt.Fprintf(os.Stdout, "TABLE: %s\n", res.TableName)
+		w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)
+		defer w.Flush()
+		fmt.Fprintln(w, "ID\tTYPE\tLENGTH\tPK\tINDEX")
+		for _, f := range res.Fields {
+			fmt.Fprintf(w, "%s\t%s\t%v\t%t\t%t\n", f.ID, f.Type, f.Length, f.PrimaryKey, f.Index)
+		}
+		return nil
+	})
+}
+
+func runSystemMasterData(cmd *cobra.Command, args []string) error {
+	masterCode := strings.TrimSpace(args[0])
+	if masterCode == "" {
+		return fmt.Errorf("master_code is required")
+	}
+	if systemMasterDataType != 0 && systemMasterDataType != 1 {
+		return fmt.Errorf("--type must be 0 (simple) or 1 (user-specific), got %d", systemMasterDataType)
+	}
+	format := strings.ToLower(strings.TrimSpace(systemMasterDataFormat))
+	switch format {
+	case "", "json":
+		format = "json"
+	case "csv":
+	default:
+		return fmt.Errorf("unknown --format %q (must be json or csv)", systemMasterDataFormat)
+	}
+	if systemMasterDataTitle && systemMasterDataNoTitle {
+		return fmt.Errorf("--title and --no-title are mutually exclusive")
+	}
+
+	p := xpoint.MasterDataParams{MasterType: systemMasterDataType}
+	if cmd.Flags().Changed("rows") {
+		v := systemMasterDataRows
+		p.Rows = &v
+	}
+	if cmd.Flags().Changed("offset") {
+		v := systemMasterDataOffset
+		p.Offset = &v
+	}
+	if format == "csv" {
+		p.FileName = systemMasterDataFileName
+		p.Delimiter = systemMasterDataDelimiter
+		p.Fields = systemMasterDataFields
+		if systemMasterDataNoTitle {
+			b := false
+			p.Title = &b
+		} else if cmd.Flags().Changed("title") {
+			v := systemMasterDataTitle
+			p.Title = &v
+		}
+	}
+
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	filename, body, _, err := client.GetMasterData(cmd.Context(), masterCode, format, p)
+	if err != nil {
+		return err
+	}
+
+	if format == "json" {
+		if systemMasterDataJQ != "" {
+			return runJQ(json.RawMessage(body), systemMasterDataJQ)
+		}
+		switch systemMasterDataOutput {
+		case "", "-":
+			_, werr := os.Stdout.Write(body)
+			return werr
+		}
+		dst := resolveDownloadPath(systemMasterDataOutput, fallbackName(filename, masterCode+".json"), 0)
+		if err := os.WriteFile(dst, body, 0o600); err != nil {
+			return fmt.Errorf("write master data: %w", err)
+		}
+		fmt.Fprintf(os.Stderr, "saved: %s (%d bytes)\n", dst, len(body))
+		return nil
+	}
+
+	// CSV
+	if systemMasterDataOutput == "-" {
+		_, werr := os.Stdout.Write(body)
+		return werr
+	}
+	if systemMasterDataOutput == "" && !isTerminal(os.Stdout) {
+		_, werr := os.Stdout.Write(body)
+		return werr
+	}
+	dst := resolveDownloadPath(systemMasterDataOutput, fallbackName(filename, masterCode+".csv"), 0)
+	if err := os.WriteFile(dst, body, 0o600); err != nil {
+		return fmt.Errorf("write csv: %w", err)
+	}
+	fmt.Fprintf(os.Stderr, "saved: %s (%d bytes)\n", dst, len(body))
+	return nil
+}
+
+func runSystemMasterImport(cmd *cobra.Command, args []string) error {
+	masterCode := strings.TrimSpace(args[0])
+	if masterCode == "" {
+		return fmt.Errorf("master_code is required")
+	}
+	raw, err := loadStringInput(systemMasterImportData)
+	if err != nil {
+		return fmt.Errorf("load --data: %w", err)
+	}
+	var items []xpoint.SimpleMasterDataItem
+	if err := json.Unmarshal([]byte(raw), &items); err != nil {
+		return fmt.Errorf("--data must be a JSON array of {\"code\",\"value\"}: %w", err)
+	}
+
+	req := xpoint.ImportSimpleMasterRequest{Data: items}
+	if cmd.Flags().Changed("overwrite") {
+		v := systemMasterImportOverwrite
+		req.Overwrite = &v
+	}
+
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	out, err := client.ImportSimpleMasterData(cmd.Context(), masterCode, req)
+	if err != nil {
+		return err
+	}
+	if systemMasterImportJQ != "" {
+		return runJQ(out, systemMasterImportJQ)
+	}
+	return writeJSON(os.Stdout, out)
+}
+
+func runSystemMasterUpload(cmd *cobra.Command, args []string) error {
+	tableName := strings.TrimSpace(args[0])
+	if tableName == "" {
+		return fmt.Errorf("master_table_name is required")
+	}
+	content, fileName, err := readUploadFile(systemMasterUploadFile)
+	if err != nil {
+		return fmt.Errorf("read --file: %w", err)
+	}
+
+	var overwrite *bool
+	if cmd.Flags().Changed("overwrite") {
+		v := systemMasterUploadOverwrite
+		overwrite = &v
+	}
+
+	client, err := newClientFromFlags(cmd.Context())
+	if err != nil {
+		return err
+	}
+	res, err := client.UploadUserMasterCSV(cmd.Context(), tableName, fileName, content, overwrite)
+	if err != nil {
+		return err
+	}
+	return writeJSON(os.Stdout, res)
+}
+
+// fallbackName returns name when non-empty, else alt.
+func fallbackName(name, alt string) string {
+	if name != "" {
+		return name
+	}
+	return alt
+}
+
+// readUploadFile reads the CSV file contents and returns the bytes plus a
+// suggested filename for the multipart form-data part. "-" reads from stdin
+// and yields a synthetic "upload.csv" filename.
+func readUploadFile(path string) ([]byte, string, error) {
+	if path == "-" {
+		b, err := io.ReadAll(os.Stdin)
+		if err != nil {
+			return nil, "", fmt.Errorf("read stdin: %w", err)
+		}
+		return b, "upload.csv", nil
+	}
+	b, err := os.ReadFile(path)
+	if err != nil {
+		return nil, "", err
+	}
+	return b, filepath.Base(path), nil
+}

internal/schema/schema_test.go

@@ -38,6 +38,11 @@ func TestAliases_Sorted(t *testing.T) {
 		"query.list",
 		"system.form.list",
 		"system.form.show",
+		"system.master.data",
+		"system.master.import",
+		"system.master.list",
+		"system.master.show",
+		"system.master.upload",
 	}
 	if len(got) != len(want) {
 		t.Fatalf("aliases = %v", got)