How alvidofaisal/internal-transfers-api works
Project type and purpose
• This is a standalone Go microservice (“Internal Transfers API”) for handling account management and money transfers with PostgreSQL, designed to run in Docker.
• It exposes a REST HTTP API (health checks, account CRUD, single & bulk transactions) and guarantees ACID semantics at SERIALIZABLE isolation.
File structure
Top-level artifacts:
• cmd/server/main.go – the entrypoint HTTP server
• internal/… – hexagonal architecture layers:
– config/config.go
– handler/*.go (HTTP adapters)
– service/*.go (business logic)
– repository/*.go (DB adapters)
– model/*.go (domain/data structures)
• migrations/ – SQL schema definitions
• Dockerfile, docker-compose.yml, Makefile – container build & orchestration
• .github/workflows/ci.yml – CI pipeline
README for additional insights
• Confirms hexagonal pattern: Handler → Service → Repository → PostgreSQL
• Highlights key features: ACID, row-level locking, SERIALIZABLE, NUMERIC precision
• Shows runtime stack: Go 1.21, Postgres, Docker
• Provides environment variables, API endpoints, testing commands