services

type Config struct {
	OptionDefs             []*meta.Option
	FormatErrorFieldNameFn func(name string) string
	MetaTagName            string // デフォルト: meta.DefaultTagName
}

type Info struct {
	// サービスの名前(ケバブケース)
	Name string

	// サービスの説明
	Description string

	// 親サービスの名称リスト
	//
	// 例えばservice1サービスがservice1/service2/service3という階層構造の場合、
	// ["service1", "service2"]となる。
	// この場合、service3サービスの各操作ではService1IdとService2Idというフィールドが存在し、必須パラメータであることが期待される。
	// (ここで指定した名前をアッパーキャメルケースにしたものがフィールド名になる)
	ParentServices []string

	// カテゴリー名(ケバブケース)
	CategoryName string
}

type OperationType int

type Operations []SupportedOperation

type ParameterExampleValuer interface {
	Examples() interface{}
}

type ParameterInitializer interface {
	// Initialize パラメータの初期カスタマイズ
	Initialize()
}

type ParameterValidator interface {
	Validate() error
}

type Service interface {
	// Info サービスについての情報を返す
	Info() *Info

	// Operations サポートしている操作のメタデータ一覧
	// この要素それぞれに対しxxxWithContext()が存在することが期待される
	Operations() Operations

	// Config コンフィグ
	Config() *Config
}

type Services []Service

type SupportedOperation struct {
	// 操作(メソッド)の名前(ケバブケース)
	Name string

	// 操作についての説明
	Description string

	// 操作種別、種別によりIdが必要/不要が決定される
	OperationType OperationType

	// この操作が属するカテゴリーの名称(省略可、指定する場合はケバブケース)
	CategoryName string
}