chore: seal Design Vision v1 and monorepo scaffold

Archive the differentiated YuXinGu product docs, AI engineering system, design contract, and Go/Vue scaffold. Next execution prioritizes Cece-parity over early innovation (see .ai/product/STRATEGY.md). Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-02 16:00:44 +08:00
parent 2686866376
commit 2fb1dfee14
193 changed files with 8854 additions and 1851 deletions
@@ -0,0 +1,67 @@
+# Commands — Do Not Guess
+
+Run from repo root unless noted.
+
+## Go API (`apps/api`)
+
+```bash
+export GOPROXY=https://goproxy.cn,direct   # if download timeout
+
+cd apps/api
+go mod tidy
+go build ./...
+go test ./...
+go run ./cmd/server
+```
+
+Health:
+
+```bash
+curl -s http://127.0.0.1:8080/api/v1/healthz
+curl -s http://127.0.0.1:8080/api/v1/ping
+```
+
+## User H5
+
+```bash
+npm install
+npm run dev:h5
+npm run build:h5
+```
+
+## Docker / DB
+
+```bash
+docker compose -f deploy/docker-compose.yml up -d
+docker compose -f deploy/docker-compose.yml down
+```
+
+## Lint (when configured)
+
+```bash
+# Go — after golangci-lint is added:
+# cd apps/api && golangci-lint run
+
+# H5 — after eslint is added:
+# npm run lint -w @yuxingu/user-h5
+```
+
+## Migrations (when make targets exist)
+
+```bash
+# Preferred once Makefile lands:
+# make migrate
+# make migrate-down
+
+# Until then: document the goose/migrate command used in the PR.
+```
+
+## Dev all (local)
+
+```bash
+# terminal 1
+cd apps/api && go run ./cmd/server
+
+# terminal 2
+npm run dev:h5
+```