jackyu66gitandCursor
2fb1dfee14
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>
21 lines
450 B
Markdown
21 lines
450 B
Markdown
# ADR-0003 REST API (not GraphQL)
|
|
|
|
## Status
|
|
|
|
Accepted
|
|
|
|
## Decision
|
|
|
|
Public HTTP API is REST under `/api/v1` with envelope `{code,message,data}`.
|
|
|
|
## Reason
|
|
|
|
1. Simpler mental model for H5 + mini-program
|
|
2. Better Cursor/Claude reliability than GraphQL schemas mid-flight
|
|
3. Easier debugging with curl
|
|
|
|
## Never
|
|
|
|
Never replace with GraphQL without approval + new ADR.
|
|
Internal gRPC later is allowed only behind a new ADR; public clients stay REST.
|