gorig

README

Gorig: AI-Native Backend Delivery System

English | 简体中文

Gorig is a backend delivery system for the AI era. It combines a Go web service framework, gorig_gen_cli, and the gorig-agent AI skill so teams can turn product intent into structured, verified, and operable backend services.

📚 Project Wiki: https://deepwiki.com/WnJee/gorig
🔧 Operations Dashboard: https://github.com/WnJee/gorig-om

Why Gorig

AI can generate backend code quickly, but speed alone is not enough. Real teams still need stable architecture, source-aware framework usage, tests, documentation, runtime visibility, and a path from local development to production operation.

Gorig packages those needs into one delivery workflow:

Product value	What teams get
Ship from intent	Describe a business need such as CRUD, login, reminders, live updates, async jobs, or deployment prep, then generate a runnable Go service shape.
Keep AI on rails	Preserve consistent Router -> Controller -> Service -> Model boundaries instead of accepting one-off generated code.
Verify before trust	Treat AI output as a delivery artifact with build checks, tests, smoke verification, and generated docs.
Operate after launch	Use built-in patterns for health, logs, scheduling, messaging, SSE, auth, configuration, graceful shutdown, and rollback planning.
Grow as an ecosystem	Pair with gorig-agent for autonomous delivery and gorig-om for runtime observability and operations.

Delivery Workflow

Gorig is designed around the full backend lifecycle, not a single scaffolding command.

Step	What happens
1. Describe	Start from product language: customer management, order workflow, reminder task, admin API, service deployment.
2. Scaffold	Structure projects, modules, CRUD services, validation rules, docs, and environment configuration.
3. Implement	The gorig-agent skill guides AI agents with real Gorig APIs, module boundaries, source checks, and framework rules.
4. Verify	Generated services are expected to pass go fmt, go vet, go build, and route-level checks.
5. Operate	Services connect to gorig-om for runtime monitoring, log analysis, error clustering, and lifecycle management.

Ecosystem

Project	Role
gorig	Core Go backend framework: HTTP routing, generic request binding (apix), fluent ORM (dx), multi-level cache, distributed cron, auth, messaging, SSE, and storage.
gorig-agent	AI Agent delivery skill: framework-aware implementation rules, layer boundaries, source patterns, and standard engineering guidelines.
gorig-om	Operations & Observability platform: service status, runtime metrics, logs, error signatures, goroutine trends, and memory diagnostics.

Quick Start

Create a New Backend

Run without installing globally:

npx gorig_gen_cli@latest init my-new-project

Or install the CLI globally:

npm install -g gorig_gen_cli
gorig_gen_cli init my-new-project

The generated project includes a runnable entry point (_cmd/main.go), multi-environment configs (_bin/*.yaml), HTTP services (api/init.go), and DDD domain initialization (domain/init.go).

Run the Project

cd my-new-project
go run _cmd/main.go

Add a Module

npx gorig_gen_cli@latest create user

This creates the outer API layer and inner DDD domain layer:

├── api/user/
│   ├── controller.go
│   └── router.go
└── domain/user/
    ├── dto.go
    ├── model.go
    └── service.go

Generate Persistent CRUD

Choose the storage backend explicitly when you want database-backed CRUD:

npx gorig-cli@latest create order --crud --db mysql --db-name Main
npx gorig-cli@latest create order --crud --db mongo --db-name main

The CRUD generator creates service/model logic, optional HTTP routes, validation tests, module docs, API docs, and non-secret configuration skeletons.

Use with AI Agents

Install the bundled gorig-agent skill when you want AI agents (Codex, Claude, Antigravity) to work with Gorig projects using framework-aware rules instead of generic backend generation.

npx gorig-cli@latest skill install codex
npx gorig-cli@latest skill install all
npx gorig-cli@latest skill install codex project

Then ask for backend work in product language:

Use the gorig-agent skill to create a customer management backend with CRUD APIs, MySQL persistence, tests, and API docs.

Use the gorig-agent skill to add login, protected routes, token refresh, logout, and security tests to this Gorig service.

Use the gorig-agent skill to prepare this service for deployment with health checks, structured logs, release layout, and rollback steps.

Functional Modules & Demos

Gorig provides clean, high-productivity modules for backend development. Explore practical guides and code demos for each package:

Package	Key Capabilities	Guide & Demos
apix	Route/Query/Form/JSON param extraction, generic BindReq[T], unified responses, custom validators, panic/error recovery	📘 apix Guide & Demos
domainx / dx	Type-safe fluent ORM, multi-engine (MySQL, MongoDB, SQLite), auto Snowflake ID, transactions, pagination	📘 domainx Guide & Demos
cache	Multi-level cache (Memory, Redis, SQLite, JSON), Remember anti-stampede Singleflight, distributed locks	📘 cache Guide & Demos
httpx & ssex	Gin engine management, security middlewares, generic HTTP client (GetJSON, Post), SSE streaming with heartbeat	📘 httpx Guide & Demos
cronx	Standard Cron, interval tasks, delay tasks, Redis-backed persistent distributed tasks with auto-recovery	📘 cronx Guide & Demos
mid/tokenx	JWT issuance & parsing, claims extraction, token revocation/blacklist, Memory/Redis storage	📘 tokenx Guide & Demos
mid/messagex	Event bus, local & Redis Pub/Sub, typed event pub/sub (PublishEvent, SubscribeEvent), DLQ replay	📘 messagex Guide & Demos
storage	Unified object storage (Local, S3, OSS, MinIO), string/byte/file helpers, resumable upload, presigned URLs	📘 storage Guide & Demos
utils	Structured logging, YAML/env configuration, AES/Bcrypt encryption, error models, alert notifications (DingTalk/Feishu/WeCom)	📘 utils Guide & Demos

Framework Installation

If you only need the Go framework dependency:

go get github.com/WnJee/gorig@latest

For most new projects, start with gorig_gen_cli instead of adding the package manually.

Quality Gates

Recommended checks before shipping:

go fmt ./...
go vet ./...
go build ./...
go test ./... -v

For generated persistent CRUD modules, run the default tests first, then run database integration tests after local MySQL or MongoDB configuration is ready.