{"id":49783549,"url":"https://github.com/linzhengen/hub","last_synced_at":"2026-05-11T23:13:34.572Z","repository":{"id":346784859,"uuid":"1175269030","full_name":"linzhengen/hub","owner":"linzhengen","description":"Full-stack microservices blueprint: Go (Backend), React (Frontend), kubernetes, and Terraform-managed Infrastructure.","archived":false,"fork":false,"pushed_at":"2026-04-21T03:29:06.000Z","size":8629,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-21T05:30:25.727Z","etag":null,"topics":["clean-architecture","golang","grpc","grpc-gateway","k8s","keycloak","postgresql","reactjs","sqlc","terraform","vibe-coding","vite"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linzhengen.png","metadata":{"files":{"readme":"README.ja.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-07T13:29:58.000Z","updated_at":"2026-04-21T03:29:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/linzhengen/hub","commit_stats":null,"previous_names":["linzhengen/hub"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/linzhengen/hub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linzhengen%2Fhub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linzhengen%2Fhub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linzhengen%2Fhub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linzhengen%2Fhub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linzhengen","download_url":"https://codeload.github.com/linzhengen/hub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linzhengen%2Fhub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32916500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"ssl_error","status_checked_at":"2026-05-11T17:08:45.420Z","response_time":120,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["clean-architecture","golang","grpc","grpc-gateway","k8s","keycloak","postgresql","reactjs","sqlc","terraform","vibe-coding","vite"],"created_at":"2026-05-11T23:13:33.868Z","updated_at":"2026-05-11T23:13:34.568Z","avatar_url":"https://github.com/linzhengen.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hub\n\n[English version](README.md) | [简体中文 (Chinese)](README.zh.md)\n\nhub は、Go バックエンド、Vite フロントエンド、Keycloak テーマ、および Terraform と Kubernetes によるインフラ管理を統合したプロジェクトです。\n\n## プロジェクト概要\n\nこのプロジェクトは、クリーンアーキテクチャに基づいた堅牢なバックエンドと、モダンな技術スタックを用いたフロントエンド、そしてそれらを支える Infrastructure as Code (IaC) で構成されています。\n\n### 主な機能\n- **認証・認可**: Keycloak を利用したセキュアな認証基盤。\n- **API 基盤**: gRPC および gRPC-Gateway を用いた RESTful API。\n- **UI**: React 19 と Tailwind CSS 4 を使用したレスポンシブな管理画面。\n- **インフラ**: Terraform によるリソース管理と Kubernetes へのデプロイ。\n\n---\n\n## アーキテクチャ\n\nプロジェクトは以下の4つの主要コンポーネントで構成されています。\n\n```mermaid\ngraph TD\n    Client[Web Browser] --\u003e|HTTPS| Gateway[gRPC-Gateway / REST API]\n    Gateway --\u003e|gRPC| Server[Go Backend API]\n    Server --\u003e|SQL| DB[(PostgreSQL)]\n    Server --\u003e|OIDC/SAML| Auth[Keycloak]\n    Client --\u003e|OIDC| Auth\n    Infra[Terraform / K8s] -.-\u003e|Manages| Server\n    Infra -.-\u003e|Manages| Auth\n    Infra -.-\u003e|Manages| DB\n```\n\n### レイヤー構造\n- **Backend API (`/server`)**: Go による DDD (Domain-Driven Design) とクリーンアーキテクチャの実装。\n- **Frontend Web (`/ui/web`)**: Vite, React 19, Tailwind CSS 4, TanStack Query を用いた SPA。\n- **Keycloak Theme (`/ui/keycloak-theme`)**: Keycloak 用のカスタムログインテーマ。\n- **Infrastructure (`/infra`)**:\n    - `tf/`: Terraform によるクラウド・ミドルウェア設定。\n    - `k8s/`: Kubernetes マニフェストと Kustomize オーバーレイ。\n\n---\n\n## 技術スタック\n\n| レイヤー | 技術 / ツール |\n| :--- | :--- |\n| **Backend** | Go 1.25, gRPC, gRPC-Gateway, Protocol Buffers, sqlc, golangci-lint |\n| **Frontend** | React 19, Vite, TypeScript, Tailwind CSS 4, Shadcn UI, TanStack Query v5, Keycloak JS |\n| **Auth** | Keycloak, FreeMarker Templates (Theme) |\n| **Infra** | Terraform, Kubernetes, Kustomize |\n| **Database** | PostgreSQL |\n\n---\n\n## ディレクトリ構造\n\n```text\n.\n├── server/             # Go バックエンドアプリケーション\n│   ├── cmd/            # エントリポイント\n│   ├── internal/       # ビジネスロジック (Clean Architecture)\n│   └── proto/          # API 定義 (Protobuf)\n├── ui/\n│   ├── web/            # Vite + React フロントエンド (Keycloak 連携)\n│   └── keycloak-theme/ # Keycloak カスタムテーマ\n├── infra/\n│   ├── tf/             # Terraform (IaC)\n│   └── k8s/            # Kubernetes マニフェスト\n├── go.mod              # Go モジュール定義\n└── Makefile            # プロジェクト共通のタスク実行\n```\n\n各ディレクトリには詳細な開発ガイド（`AGENTS.md`）が用意されています。\n\n---\n\n## 開発の始め方\n\n### Kubernetes (MiniKube) へのデプロイ\n\n`infra/k8s` に MiniKube 用のマニフェストが用意されています。\n\n```bash\n# マニフェストの生成\nkubectl kustomize infra/k8s/overlays/minikube\n\n# デプロイ\nkubectl apply -k infra/k8s/overlays/minikube\n```\n\nNote: `hub` 本体のイメージは事前にビルドされている必要があります。\n`minikube docker-env` を使用して MiniKube 内の Docker デーモンでビルドするか、イメージをロードしてください。\n\n### 1. 依存関係のインストール\n\n```bash\n# Backend 開発ツール\nmake init\n\n# Frontend 依存パッケージ\ncd ui/web \u0026\u0026 pnpm install\n```\n\n### 2. ローカル開発環境の起動\n\n```bash\n# Docker Compose と Terraform を使用した環境構築\nmake dev\n```\n\n### 3. コード生成 (Protobuf / SQL)\n\n```bash\nmake gen\n```\n\n---\n\n## 開発ガイドライン\n\n各コンポーネントの詳細なガイドラインは、それぞれのディレクトリにある `AGENTS.md` を参照してください。\n\n- [Backend 開発ガイド](server/AGENTS.md)\n- [Frontend 開発ガイド](ui/web/AGENTS.md)\n- [Keycloak Theme 開発ガイド](ui/keycloak-theme/AGENTS.md)\n- [Infrastructure 開発ガイド (Terraform)](infra/tf/AGENTS.md)\n- [Infrastructure 開発ガイド (Kubernetes)](infra/k8s/AGENTS.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinzhengen%2Fhub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinzhengen%2Fhub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinzhengen%2Fhub/lists"}