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,58 @@
+# application AGENTS
+
+Role:
+- orchestrate use cases
+- define ports
+- own transaction boundary
+- translate domain meaning into business outcome and error code
+
+Allowed:
+- use case/service orchestration
+- command/result dto
+- input/output port
+- business exception and error code
+- transaction boundary
+
+Forbidden:
+- HTTP concerns
+- Servlet/SecurityContext access
+- ObjectMapper/HttpClient/WebClient/JPA details
+- inline external call implementation
+- direct dependency on presentation/infrastructure internals
+
+Rules:
+- application decides business outcome and error code
+- do not expose HTTP status here
+- catch only to translate or add business context
+- transaction starts here, not in controller/filter/resolver
+- do not hold transaction across remote IO
+- ports exist for boundaries, not for every internal helper
+
+Read first:
+- `/docs/architecture/README.md`
+- `/docs/standards/design/interface-creation.md`
+- `/docs/standards/design/port-abstraction.md`
+- `/docs/standards/design/dto-domain-entity-separation.md`
+- `/docs/standards/spring/transaction.md`
+- `/docs/standards/spring/application-event.md`
+- `/docs/standards/language/exceptions.md`
+- `/docs/standards/integration/external-api-client-structure.md`
+- `/docs/standards/db/transaction.md`
+- `/docs/standards/db/isolation.md`
+- `/docs/standards/db/concurrency.md`
+- `/docs/standards/testing/mock-usage.md`
+- `/docs/standards/testing/fixture-factory.md`
+- `/docs/standards/testing/springboottest-usage.md`
+
+Examples:
+- `/docs/examples/spring/transaction.md`
+- `/docs/examples/spring/application-event.md`
+- `/docs/examples/design/port-abstraction.md`
+- `/docs/examples/design/interface-creation.md`
+- `/docs/examples/design/dto-domain-entity-separation.md`
+- `/docs/examples/db/transaction.md`
+- `/docs/examples/db/isolation.md`
+- `/docs/examples/db/concurrency.md`
+- `/docs/examples/testing/mock-usage.md`
+- `/docs/examples/testing/fixture-factory.md`
+- `/docs/examples/testing/springboottest-usage.md`