CLI 使用

本仓库包含多个命令行工具：

账号服务主程序

二进制名称由 Makefile 设置为 xcontrol-account，主入口在 cmd/accountsvc。

xcontrol-account --config config/account.yaml --log-level info

参数：

• --config：配置文件路径
• --log-level：debug|info|warn|error

createadmin（超级管理员）

go run ./cmd/createadmin/main.go \
  --driver postgres \
  --dsn "$DB_URL" \
  --username Admin \
  --password ChangeMe \
  --email admin@svc.plus

常用参数：

• --driver：postgres 或 memory
• --dsn：PostgreSQL DSN
• --groups / --permissions
• --current-password：更新已有管理员时必需
• --mfa：管理员启用 MFA 时必需

migratectl（迁移 / 导出 / 导入）

# 迁移
migratectl migrate --dsn "$DB_URL"

# schema 校验
migratectl verify --dsn "$DB_URL" --schema sql/schema.sql

# 导出/导入
migratectl export --dsn "$DB_URL" --output account-export.yaml
migratectl import --dsn "$DB_URL" --file account-export.yaml

syncctl（跨环境同步）

syncctl --config config/sync.yaml push
syncctl --config config/sync.yaml pull
syncctl --config config/sync.yaml mirror

Makefile 快捷命令

make build
make start
make create-super-admin
make account-export
make account-import

相关脚本位于 scripts/。