誰にいくら払ったかを記録・共有するサービス
apps/backend: Go 製 API サー��ー本体。Taskfile やスキーマ、OpenAPI 生成物を含むdocs: TypeSpec から生成された OpenAPI などドキュメント類infra: Terraform などインフラ構成管理.devcontainer: VS Code Dev Container 用設定と Dockerfile
| ツール | 推奨バージョン | インストール例 |
|---|---|---|
| Docker / Docker Compose | 24.x / v2 系 | brew install --cask docker |
| Go | 1.24.x | brew install go |
| Task | 最新 | brew install go-task/tap/go-task |
| godotenv | 最新 | go install github.com/joho/godotenv/cmd/godotenv@latest |
| sqlc | 最新 | go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest |
| air | 最新 | go install github.com/air-verse/air@latest |
| psql | 15 以上 | brew install postgresql |
| Atlas | 最新 | brew install ariga/tap/atlas |
| oapi-codegen | 最新 | go install github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest |
| mockgen | 最新 | go install go.uber.org/mock/mockgen@latest |
| dlv | 最新 | go install github.com/go-delve/delve/cmd/dlv@latest |
apps/backend/.env.example を複製して .env を作成し、必要に応じて値を変更してください。Task は .env を自動で読み込みます。
| 変数名 | 説明 |
|---|---|
PORT |
API サーバーが待ち受けるポート番号 |
DSN |
Postgres 接続文字列。例: postgres://postgres:password@localhost:5432/datti?sslmode=disable |
OTEL_SERVICE_NAME |
OpenTelemetry のサービス名。例: Datti API |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT |
Jaeger Collector 等へのエンドポイント。例: http://localhost:4318 |
OTEL_EXPORTER_OTLP_TRACES_INSECURE |
Collector への接続に TLS を使わない場合は true |
Jaeger にトレースを送信する場合は Collector を起動した上で上記エンドポイントを指定してください。
- コンテナ群の起動（リポジトリ直下の
compose.yamlを利用）docker compose up
- Postgres:
localhost:5432 - Jaeger UI:
http://localhost:16686
- Postgres:
- マイグレーション & 初期データ投入
cd apps/backend go mod download task db-migrate task db-seed
- API サーバーの起動
cd apps/backend air.air.tomlがgodotenvとdlvを介してバイナリを起動します（デバッグポート :2345）- ソース変更を監視し自動ビルド・再起動が行われます
| タスク | 内容 |
|---|---|
task db-migrate |
Atlas 経由で Postgres スキーマを適用 |
task db-seed |
サンプルデータを投入 |
task gen-sqlc |
sql/query.sql から internal/gateway/postgres のクエリコードを生成 |
task gen-types |
OpenAPI からリクエスト/レスポンス型を生成（出力: internal/presentation/api/types.gen.go） |
task gen-server |
OpenAPI からサーバースタブを生成（出力: internal/presentation/api/server.gen.go） |
task gen-mocks |
モックを生成（出力: internal/usecase/test など） |
task test |
テストの実行 |
OpenAPI の元定義は docs/openapi/tsp-output/@typespec/openapi3/openapi.yaml に配置されています。