توليد التوثيق من Spring (springdoc)

في هذا الدرس

get a spec and Swagger UI from existing code.

الموضوعات المخطط لها

• springdoc-openapi reads your controllers and DTOs and builds the spec at run time. Verify the artifact name and version for your Spring Boot version before recording.
• The spec is served as JSON (commonly at /v3/api-docs).
• Swagger UI is a web page (commonly /swagger-ui.html) where you read and try endpoints.
• Annotations such as @Operation and @Schema add detail where the code alone is not enough.
• In production, decide whether the docs endpoints should be public.