Development

[gustaavik]

This pull request introduces several enhancements and fixes across multiple areas, including workflow updates, API documentation improvements, validation and contract additions, and feature expansions for product and category management. Below is a summary of the most important changes grouped by theme:

Workflow Updates

• .github/workflows/release.yml: Added workflow_dispatch to enable manual testing and updated the authentication token for Docker registry login to use GHCR_TOKEN exclusively. Also expanded supported platforms for Docker builds to include linux/arm64. [1] [2] [3]

API Documentation Enhancements

• docs/RESTAPI.md: Expanded documentation for the POST /api/admin/test/email endpoint, detailing request and response formats, query parameters, and status codes. Added status codes for DELETE /api/admin/categories/{id} to clarify error handling scenarios. [1] [2]
• docs/email_test_api_examples.md: Added examples for testing the email API, including request formats, response samples, and notes about fallback behavior and validation.

Validation and Contract Additions

• internal/infrastructure/validation/validator.go: Introduced email validation logic and a structured approach for handling validation errors.
• internal/interfaces/api/contracts/email_contract.go: Added EmailTestRequest contract with validation support for email format.
• internal/interfaces/api/contracts/payments_contracts.go: Added contracts for payment capture and refund requests, supporting partial and full operations.

Category Management Enhancements

• internal/application/usecase/category_usecase.go: Updated CategoryUseCase to prevent deletion of categories with associated products. Added dependency on ProductRepository for this check. [1] [2]
• internal/application/usecase/category_usecase_test.go: Added unit tests to verify behavior when attempting to delete categories with products or child categories.
• internal/domain/repository/product_repository.go: Added HasProductsWithCategory method to check for products linked to a category.

Product Management Enhancements

• internal/application/usecase/product_usecase.go: Enhanced UpdateProduct to validate currency changes and explicitly update CategoryID. [1] [2]
• internal/domain/entity/product.go: Updated Product.Update method to support currency and category updates. [1] [2] [3]
• internal/domain/entity/product_test.go: Adjusted tests for Product.Update to include new fields like currency and category.
• internal/infrastructure/repository/gorm/product_repository.go: Modified Update to explicitly handle all fields, including CategoryID. Added HasProductsWithCategory method implementation. [1] [2]

These changes collectively improve the functionality, maintainability, and clarity of the codebase while addressing key feature gaps and enhancing documentation.