OpenAPI / Swagger auth — P4-08 (2026-07-07)
Runtime: SpringDoc /v3/api-docs · Estático: anotations/endpoints/openapi.yaml
Escopo
Alinhar documentação OpenAPI ao contrato MVP1 Modo A:
POST /api/auth/signin— login localPOST /api/auth/external-login— IdP (Azure / Google)- Sem
signin-azureno spec - Campo
azureemLoginRequestmarcadodeprecated - Tags separadas: Autenticação vs Autenticação externa
Alterações
| Área | Detalhe |
|---|---|
OpenApiConfig.java |
Descrição global (já alinhada) |
AuthController |
@ApiResponse 400 legado azure: true |
| DTOs | JwtAuthenticationResponse, ExternalLoginRequest — @Schema |
anotations/endpoints/openapi.yaml |
Versão 0.7.05.202606171, servers com /ecosif-auth, schemas legados removidos |
scripts/verify-openapi-auth.sh |
Verificação automatizada do /v3/api-docs |
OpenApiConfigTest |
Teste unitário da descrição |
Verificação
cd ecosif-auth
mvn -q test -Dtest=OpenApiConfigTest
ECOSIF_AUTH_BASE_URL=http://localhost:8091 ./scripts/verify-openapi-auth.sh
Swagger UI: http://localhost:8091/ecosif-auth/swagger-ui.html
Gate P4-08
- [x] Paths atuais documentados (signin, external-login, admin logs)
- [x]
signin-azureausente do OpenAPI - [x]
LoginRequest.azuredeprecated - [x] Script de verificação + teste unitário
- [x]
openapi.yamlestático sincronizado