{"id":50715232,"url":"https://github.com/nhassl3/servicehub-backend","last_synced_at":"2026-06-09T18:32:15.380Z","repository":{"id":343567955,"uuid":"1166559612","full_name":"nhassl3/servicehub-backend","owner":"nhassl3","description":"Production-ready marketplace backend — Go · gRPC · PostgreSQL 18 · PASETO · Clean Architecture · Docker","archived":false,"fork":false,"pushed_at":"2026-04-11T18:11:12.000Z","size":813,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T19:15:19.190Z","etag":null,"topics":["backend","business-logic","golang","grpc","marketplace","rpc","server"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nhassl3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T10:59:11.000Z","updated_at":"2026-04-11T18:26:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nhassl3/servicehub-backend","commit_stats":null,"previous_names":["nhassl3/servicehub-backend"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nhassl3/servicehub-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhassl3%2Fservicehub-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhassl3%2Fservicehub-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhassl3%2Fservicehub-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhassl3%2Fservicehub-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nhassl3","download_url":"https://codeload.github.com/nhassl3/servicehub-backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhassl3%2Fservicehub-backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34121021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","business-logic","golang","grpc","marketplace","rpc","server"],"created_at":"2026-06-09T18:32:15.306Z","updated_at":"2026-06-09T18:32:15.366Z","avatar_url":"https://github.com/nhassl3.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ServiceHub Backend\n\n\u003e Production-ready marketplace backend built with Go, gRPC, and PostgreSQL.\n\nServiceHub is a modern service marketplace platform inspired by the architecture of large-scale e-commerce systems. This repository contains the backend service, written in Go following Clean Architecture principles.\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| Language | Go 1.25 |\n| Transport | gRPC + REST gateway (grpc-gateway) |\n| Database | PostgreSQL 18 (alpine) |\n| Auth | PASETO v4 / JWT |\n| Password hashing | argon2id |\n| Query generation | sqlc |\n| Migrations | golang-migrate |\n| Logging | Uber Zap |\n| Config | Viper (YAML + .env) |\n| Testing | testify + gomock |\n| Container | Docker (multi-stage, alpine) |\n\n---\n\n## Project Structure\n\n```\nservicehub-backend/\n├── cmd/servicehub/         # Entry point\n├── config/                 # YAML configs (local, prod)\n├── internal/\n│   ├── app/                # Application bootstrap \u0026 graceful shutdown\n│   ├── config/             # Config loader\n│   ├── db/                 # sqlc-generated database layer\n│   ├── domain/             # Domain models \u0026 interfaces\n│   ├── repository/\n│   │   ├── postgres/       # PostgreSQL implementations\n│   │   └── mock/           # gomock mocks\n│   ├── service/            # Business logic + unit tests\n│   └── transport/grpc/\n│       ├── interceptors/   # Auth, logging, recovery, validation\n│       └── *_handler.go    # gRPC handlers\n├── migrations/             # SQL migration files (up/down)\n├── pkg/\n│   ├── auth/               # PASETO / JWT token manager\n│   ├── hash/               # argon2id password hasher\n│   ├── logger/             # Zap logger factory\n│   ├── postgres/           # Connection pool\n│   └── validator/          # protovalidate integration\n├── Dockerfile              # Multi-stage Docker build\n├── Makefile                # Developer shortcuts\n└── start.sh                # Container entrypoint (migrate → run)\n```\n\n---\n\n## Domain\n\nThe platform covers a full marketplace workflow:\n\n- **Users** — registration, authentication (PASETO), profile\n- **Sellers** — seller accounts linked to users\n- **Products** — catalogue with categories\n- **Categories** — product taxonomy\n- **Orders / Order Items** — order lifecycle management\n- **Cart / Cart Items** — shopping cart\n- **Reviews** — product reviews\n- **Wishlists** — saved products\n- **Balances / Transactions** — internal wallet system\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- Docker \u0026 Docker Compose\n- Go 1.25+\n- `make`\n- [`migrate`](https://github.com/golang-migrate/migrate) CLI (for local development)\n\n### Environment\n\nCopy the example and fill in secrets:\n\n```bash\ncp .env.example .env\n```\n\nRequired variables:\n\n```env\nDB_USER=servicehub\nDB_PASSWORD=\u003cstrong-password\u003e\nDB_NAME=servicehub\nPASETO_KEY=\u003c32-byte-hex-key\u003e\n```\n\n### Run with Docker Compose\n\nFrom the repository root (one level up):\n\n```bash\ndocker compose up --build\n```\n\nServices exposed:\n\n| Service | Port |\n|---|---|\n| gRPC | 9090 |\n| HTTP gateway | 8080 |\n| PostgreSQL | 5432 |\n\nMigrations run automatically on container startup.\n\n### Run locally\n\n```bash\n# Start a local Postgres instance\nmake postgres\n\n# Apply migrations\nmake migrate-up\n\n# Run the server\nmake run\n```\n\n---\n\n## Makefile Reference\n\n```bash\nmake build          # Compile binary for current OS/ARCH\nmake run            # go run ./cmd/servicehub\nmake test           # Run all tests with race detector + coverage\nmake test-verbose   # Verbose test output\nmake cover          # Open coverage report in browser\nmake lint           # golangci-lint\nmake mock           # Regenerate gomock mocks\nmake sqlc           # Regenerate sqlc database layer\nmake migrate-up     # Apply all pending migrations\nmake migrate-down   # Roll back one migration\nmake clean          # Remove build artifacts\n```\n\n---\n\n## Architecture\n\nClean Architecture with strict layer separation:\n\n```\nTransport (gRPC) → Service (business logic) → Repository (data access) → DB\n```\n\n- **Domain** layer defines interfaces — no framework dependencies\n- **Repository** layer is swappable; mocks are generated automatically\n- **Service** layer contains all business rules and is fully unit-tested\n- **Transport** layer handles serialization, auth, and validation via interceptors\n\n### gRPC Interceptors\n\n| Interceptor | Purpose |\n|---|---|\n| `auth` | Validates PASETO token, injects claims into context |\n| `logging` | Structured request/response logging with Zap |\n| `recovery` | Panic recovery with stack trace logging |\n| `validation` | Proto field validation via `protovalidate` |\n\n---\n\n## Testing\n\n```bash\nmake test\n```\n\n- Unit tests for all services with gomock\n- Token manager tests (PASETO + JWT)\n- Password hashing tests\n- Race detector enabled by default\n\n---\n\n## Related Repositories\n\n| Repository | Description |\n|---|---|\n| `servicehub-contracts` | Protobuf definitions shared between backend and frontend |\n| `servicehub-frontend` | React + Vite + TypeScript frontend |\n\n---\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhassl3%2Fservicehub-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhassl3%2Fservicehub-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhassl3%2Fservicehub-backend/lists"}