golid
golid-ai · golid-ai/golid
Một nhà máy phần mềm AI-native cho các ứng dụng Go + SolidJS, cung cấp một bộ công cụ sản xuất với các kế hoạch, thông số kỹ thuật module, 45 quy tắc Cursor, CI kiểm tra độ lệch, và một ứng dụng khởi đầu với triển khai GCP.
Factory ưu tiên AI cho các ứng dụng Go + SolidJS — Các Cursor rule, CI phát hiện sai lệch spec, các kế hoạch và một bộ khởi động sản xuất với xác thực, SSR, SSE, triển khai Cloud Run.
Xem trước
Bạn có thể làm gì với nó
- Nhanh chóng xây dựng và triển khai các ứng dụng web Go + SolidJS full-stack với sự hỗ trợ của AI.
- Duy trì chất lượng code và tính nhất quán kiến trúc bằng cách sử dụng 45 quy tắc Cursor được xác định trước.
- Tự động hóa quy trình phát triển bao gồm xác thực thông số kỹ thuật và kiểm thử tích hợp.
Kiểm tra an toàn
Không thấy dấu hiệu rủi ro trong các file đã quét.
Quét tự động các file trong repo. Luôn xem lại code trước khi chạy.
Trích từ README
Golid
An AI-native software factory for cloud-hosted Go + SolidJS apps.
Production harness — plans, module specs, 45 Cursor rules, drift CI, integration test harness — plus a runnable starter app and GCP deploy scripts.
Live example: golid.ai — marketing site built with this factory; clone the repo for the harness and template app.
Factory · Quick Start · Fork · Why Golid · Deploy · Docs
Tech Stack
| Layer | Technology | Layer | Technology |
|---|---|---|---|
| Backend | Go 1.26 · Echo v4 · pgx/v5 | Frontend | SolidJS · SolidStart · Tailwind CSS 4 |
| Database | PostgreSQL 16 | Infrastructure | Cloud Run · Cloud SQL · GCS |
| Auth | JWT rotation · selector/verifier tokens | Real-time | SSE hub with ticket auth |
Mailgun (IsConfigured()) | Job Queue | asynq + Redis (goroutine fallback) | |
| Observability | OpenTelemetry · Prometheus (opt-in) | Feature Flags | DB-backed with 30s cache |
| Hot Reload | Air (Go) + Vite HMR | DevContainer | One-click setup, zero config |
| Testing | 995 tests (353 Go unit + 622 Vitest + 20 E2E) | Factory harness | Plans · spec-drift · rule-health · plan loop |
| AI Rules | 45 Cursor rules (auto-activate on edit) | Integration | TEST_DATABASE_URL · per-package schemas (separate go test -tags integration run) |
How the factory works
Agents and humans share the same production contract — not prompt memory, not ad-hoc CI.
1. Classify & plan — workflow-routing picks risk tier (T0–T3). Write slices in docs/plans/ under planning-standards guardrails: verify schema and file claims against migrations and source; acceptance criteria per slice. New modules: plan-feature. Calibration: golden-slices.
2. Execute slices — slice-and-ship per slice: implement → test → spec/OpenAPI sync → audit-bugs pre-merge gate → commit. For multi-slice plans, invoke plan-execution-loop to orchestrate subagents: implement → audit (≥90/100) → fix → re-audit before the next slice. Archive completed plans under docs/plans/archive/.
| Step | What | Where |
|---|---|---|
| Spec | Current behavior (updated as slices land) | docs/modules/*/spec.md |
| Build | Rules + scaffold enforce patterns | .cursor/rules/ · make new-module |
| Verify | Unit + integration harness, race detector | Per-package it__ schemas · sharded CI |
| Gate | Spec + rules stay aligned with code | check_spec_drift.sh · check_citation_freshness.sh · check_rule_health.sh on every PR |
| Ship | Cloud deploy + full rebrand | ./scripts/deploy.sh · make rename (20+ file categories) |
vs blank repo + AI: OpenAPI + module specs + drift CI (not prompt memory) · planning-standards → slice-and-ship / plan-execution-loop · path-filtered CI + E2E + Codecov 80% gate · make rename rebrands the whole factory.
Full map: Organism Pattern · Plans · routing eval
What's Inside
Starter modules the factory extends — use make new-module or follow example-module.md.
| Module | What it does |
|---|---|
| Auth | Registration, login, JWT refresh rotation, password reset, email verification |
| Users | Profile (/me), settings, admin user_type gates |
| Feature flags | Public GET /features, admin CRUD, cached reads |
| SSE | Per-user channels, one-time ticket auth, reconnect + backpressure |
| Components | 70+ atoms/molecules/organisms — charts, grids, date pickers, modals |
| Opt-in infra | Email, queue, Redis rate limiting, tracing, metrics — off by default |
Also included: OpenAPI 3.1 + TypeScript codegen, sqlc queries, golang-migrate (with down migrations), CSRF + dual-tier rate limiting, scaffold generator, domain-safe rename tool, GCP deploy/teardown scripts.
Quick Start
Prerequisites: Docker 24+, Node.js 24+, Go 1.26+
DevContainer (recommended)
git clone https://github.com/golid-ai/golid.git my-project && cd my-project
# Open in VS Code/Cursor → "Reopen in Container"
Migrations and seed data run automatically (entrypoint.dev.sh). Backend starts on 8080. Frontend starts as a VS Code task — open the Terminal tab and wait until the frontend dev server prints its local URL before opening http://localhost:3000.
Docker Compose (local)
git clone https://github.com/golid-ai/golid.git my-project && cd my-project
make setup
# First run only — migrate + seed the dev database
export DATABASE_URL=postgres://dev:dev@localhost:5432/golid?sslmode=disable
make migrate-up seed
docker compose up # DB + backend on :8080
cd frontend && npm run dev # frontend on :3000
Test accounts (after seed): admin@example.com / Password123! (admin) · user@example.com / Password123! (user)
Guides: Quick Start · [Start Here](docs/start-here.