# 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`