993 B

Domain Docs

Layout and reading rules

This repository uses a single-context layout:

  • CONTEXT.md at the repository root: controlled Chinese domain vocabulary.
  • docs/adr/: architecture decision records (0001 through 0005 and subsequent records).

Before exploring the codebase or changing domain behavior, read CONTEXT.md and ADRs relevant to the area being explored.

Vocabulary

Use the exact Chinese terms defined in CONTEXT.md when naming domain concepts in customer-facing UI copy, issues, specs, proposals, and domain discussions. Go/TypeScript identifiers and test function names may stay in English.

If a needed concept is missing from CONTEXT.md, check whether existing vocabulary covers it; otherwise document the new term in CONTEXT.md (with domain-modeling if available, or directly following the existing format).

Decision conflicts

If a proposal contradicts an existing ADR, identify the ADR and explain why the decision should be reconsidered.