hungryroot/jira/be_7471_create_serializers_viewsets_and_hook_up_url_routing_for_cookbooks.org

BE-7471 Create serializers, viewsets and hook up URL routing for Cookbooks

- points :: 2

Description

We need to expose the cookbooks functionality via the REST API. This task

involves creating Django Rest Framework (DRF) serializers, ViewSets, and

configuring URL routing.

Crucially, the ViewSet logic must delegate write operations (create/update) to

the existing CookbookService to ensure the upsert behavior and transactional

integrity implemented in BE-7470 are enforced via the API.

This task also includes writing integration tests for the API endpoints to

ensure the serializers, views, and service layer interact correctly.

- Create serializers for Cookbook, CookbookAuthor, CookbookSection, and CookbookItem.

- Implement nested serializers for writing (e.g., accepting items data within the Cookbook payload).

- Ensure validation logic matches model constraints.

- Create a CookbookViewSet extending ModelViewSet or ViewSet.

- Override create and update methods to call CookbookService.upsert_cookbook instead of direct model serialization saving.

- Ensure read operations (list/retrieve) function as expected.

- Register the CookbookViewSet with the default router.

- Ensure endpoints are accessible (e.g., /api/cookbooks/, /api/cookbooks/{slug}/).

- Write integration tests using APIClient.

- Test GET (list/retrieve) for correct data structure.

- Test PUT (upsert) to verify service layer invocation and transactional behavior.

- Test validation errors (e.g., missing required fields).

Ensure API schema (Swagger/Redoc) reflects the new endpoints correctly.

- Do not call serializer.save() directly for write operations.

- Nested Writes: Ensure the Serializer write methods handle the nested items and author data correctly before passing it to the Service.

- Permissions: Apply standard project permissions (e.g., IsAuthenticated or IsAdminUser) as per project standards.

Use django.test.TestCase or pytest with APIClient.

Verify that a PUT request with nested items triggers the _update_items logic in

the service (upsert).