52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
# presentation AGENTS
|
|
|
|
Role:
|
|
- own HTTP contract only
|
|
- handle controller, request/response dto, validation, response/error mapping
|
|
|
|
Allowed:
|
|
- controller
|
|
- request/response dto
|
|
- validation annotation
|
|
- API response model
|
|
- HTTP status mapping
|
|
- controller advice
|
|
- argument resolver for controller parameter injection only
|
|
|
|
Forbidden:
|
|
- repository access
|
|
- external API call
|
|
- business rule decision
|
|
- direct dependency on domain/infrastructure
|
|
- MDC/clock logic inside dto
|
|
|
|
Rules:
|
|
- controller handles HTTP only
|
|
- dto must stay pure data
|
|
- validation at boundary, invariant in domain
|
|
- use ArgumentResolver only for controller parameter injection
|
|
- do not hardcode provider/business meaning in mapper
|
|
- response shape must stay centralized and consistent
|
|
|
|
Read first:
|
|
- `/docs/architecture/README.md`
|
|
- `/docs/standards/web/api-controller.md`
|
|
- `/docs/standards/web/request-response-dto.md`
|
|
- `/docs/standards/web/response-format.md`
|
|
- `/docs/standards/web/error-code-http-status-separation.md`
|
|
- `/docs/standards/web/serialization-jackson.md`
|
|
- `/docs/standards/web/authentication-object-access.md`
|
|
- `/docs/standards/spring/filter-interceptor-resolver-advice.md`
|
|
- `/docs/standards/spring/validation-location.md`
|
|
- `/docs/standards/testing/mock-usage.md`
|
|
- `/docs/standards/testing/springboottest-usage.md`
|
|
|
|
Examples:
|
|
- `/docs/examples/web/api-controller.md`
|
|
- `/docs/examples/web/request-response-dto.md`
|
|
- `/docs/examples/web/response-format.md`
|
|
- `/docs/examples/web/error-code-http-status-separation.md`
|
|
- `/docs/examples/web/authentication-object-access.md`
|
|
- `/docs/examples/testing/mock-usage.md`
|
|
- `/docs/examples/testing/springboottest-usage.md`
|