inkreach-official-website/plans/fix/product-external-id-fix.md

Product External ID Fix Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Make the public goods API return the SDS/InkPOD product ID as id, so product-card links target the correct InkPOD detail page.

Architecture: Keep the local goods.good_id as the database identity used by admin and relations. At the public API serialization boundary, map originGood.sdsGoodId to the existing response id field; the website can continue consuming product.id without a second identifier.

Tech Stack: NestJS, Prisma, Jest, Nuxt/Vue

---

Task 1: Lock the public API ID contract

Files:

• Modify: apps/api/src/public/public.service.spec.ts

• Add an assertion that a listed public product has id equal to the seeded OriginGood.sdsGoodId, not the local Good.id.

• Run the focused API test and confirm it fails because the service currently returns good.id.

Task 2: Return the SDS product ID

Files:

• Modify: apps/api/src/public/public.service.ts

• Include sdsGoodId in the serializer's originGood type.

• Return good.originGood.sdsGoodId as PublicGoodDto.id.

• Run the focused API test and confirm it passes.

Task 3: Verify consumers and document the contract

Files:

• Modify: docs/references/product-center.md

• Modify: docs/references/structs.md

• Document that public product id is the SDS/InkPOD external product ID.

• Run API public-service tests, website tests, and the website build.

• Verify the running public endpoint returns 126673 for 200g纯棉T恤KRTM001 when local services are available. (The API was not listening on port 3001 during verification.)