init: 클린 기반 auth 서버 설계

2026-07-24 14:30:18 +09:00
parent 471db0203d
commit 8a1ac1e769
3642 changed files with 275893 additions and 1 deletions
@@ -0,0 +1,77 @@
+# AGENTS.md
+
+Read order:
+1. `/AGENTS.md`
+2. nearest module `AGENTS.md`
+3. `/docs/architecture/README.md`
+4. relevant `/docs/standards/**`
+5. relevant `/docs/examples/**`
+6. `/docs/standards/ops/standard-application-priority.md`
+7. current request
+
+> **WARNING TO AI AGENTS**: You MUST READ the relevant files in `/docs/standards/**` and `/docs/examples/**` with file reading tools BEFORE proposing or writing code for any task. DO NOT rely on generic framework knowledge, memory, assumptions, or existing code patterns alone. The standard and example documents contain mandatory project rules for architecture, layer boundaries, design, language style, Spring, web contracts, integration, observability, DB, testing, operations, and documentation. Producing analysis, boilerplate code, manifests, tests, refactors, or docs without relevant standards/examples compliance is a critical failure.
+
+Goal:
+- prefer clear boundaries over quick implementation
+- prefer maintainable structure over local convenience
+- follow the repository architecture before adding code
+
+Modules:
+- `bootstrap`: Spring Boot composition, security, filter/wiring, outer technical adapters
+- `domain`: invariant, entity, value object, domain rule only
+- `application`: use case, port, transaction boundary, business outcome
+- `presentation`: HTTP contract, validation, response/error translation
+- `infrastructure`: persistence, external API, token/security technical implementation
+- `common`: forbidden by default; reintroduce only with explicit rules
+
+Global standards: always read before editing
+- `/docs/standards/language/stream.md`
+- `/docs/standards/language/optional.md`
+- `/docs/standards/language/null.md`
+- `/docs/standards/language/collections-immutability.md`
+- `/docs/standards/language/enum-constants.md`
+- `/docs/standards/language/time.md`
+- `/docs/standards/language/exceptions.md`
+- `/docs/standards/language/duplication.md`
+- `/docs/standards/language/javadoc.md`
+
+Hard bans:
+- no layer violation
+- no hardcoded provider/header/path/status/business value without explicit owner
+- no `Instant.now().toString()` inside dto/response/model
+- no broad catch or swallowed exception
+- no stale Javadoc
+- no inline external API call inside controller/use case
+- no direct `presentation -> domain` dependency
+- no direct `presentation -> infrastructure` dependency
+- no DB transaction held across remote call
+- no meaningless interface pair like `XService` + `XServiceImpl` by default
+
+Routing:
+- layer ownership / boundary -> `/docs/architecture/README.md`
+- standard application priority / conflict resolution -> `/docs/standards/ops/standard-application-priority.md`
+- abstraction / design -> `/docs/standards/design/**`
+- language/style -> `/docs/standards/language/**`
+- Spring abstraction/wiring -> `/docs/standards/spring/**`
+- web/http contract -> `/docs/standards/web/**`
+- external call/retry/timeout/fallback -> `/docs/standards/integration/**`
+- logging/trace/health/pii -> `/docs/standards/observability/**`
+- PostgreSQL/query/transaction/concurrency -> `/docs/standards/db/**`
+- test scope/fixture/mock/repository/@SpringBootTest -> `/docs/standards/testing/**`
+- approved examples -> `/docs/examples/**`
+
+Before editing:
+- identify the owning layer
+- identify the boundary crossed
+- identify whether exception mapping, transaction scope, query shape, or docs must change
+
+After code work — documentation cycle:
+1. identify whether the change involves an architectural decision (ADR) or troubleshooting / runbook worth recording
+2. if yes, write the topic document in `/docs/topics/<nn-topic>/` following the relevant template from `/docs/templates/`
+3. update the topic's `README.md` index
+4. follow `/docs/documentation-guide.md` for writing standards (Why → What → How → Result)
+
+Documentation routing:
+- writing standards / structure / checklist -> `/docs/documentation-guide.md`
+- topic ADR + troubleshooting / runbook -> `/docs/topics/`
+- reusable templates -> `/docs/templates/`