Repository navigation
[profile-store-api] 實作 DESIGN-03 批 4（BE-07）：V7、客戶資料庫與搜尋（profiles.md）、旅程列表與唯讀旅程頁 API（journeys.md §2）、/enrollments 瀏覽 #106
Description
派工單 profile-store-api
- 類型：feat
- 負責：backend
- 目標：實作 DESIGN-03 批 4（BE-07）：V7、客戶資料庫與搜尋（
profiles.md）、旅程列表與唯讀旅程頁 API（journeys.md§2）、/enrollments瀏覽 - 背景：前端（journey-customer-ui，PR feat(journey-customer-ui): 旅程列表與唯讀旅程頁、最近 Enrollment 瀏覽、客戶搜尋→客戶頁→圖形軌跡（直線） #98）已對這些契約 mock 完成；user-auth-api（PR feat(user-auth-api): 依
auth.md實作使用者登入（email＋密碼，BCrypt）、角色（VIEWER／EDITOR／ADMIN）、CSRF、登入限速與/users管理 API，取代 v0.1.0 的共用客服帳密 #104）已合併，角色矩陣依auth.md§2。D-048 搜尋完全比對、D-050 列表不顯示人數 - 設計依據：
docs/design/DESIGN-03.md做法 [UI-01] 出 v0.1.0 唯讀 Enrollment 軌跡查詢頁的畫面規格、靜態設計稿與設計 token #4、[CHORE-01] 把 agent 專案記憶目錄加進 .gitignore #5、chore(CHORE-01): 把 agent 專案記憶目錄加進 .gitignore #6 與派工順序批 4；docs/contracts/profiles.md、docs/contracts/journeys.md§2、docs/contracts/auth.md§2；docs/spec/07-database-schema.md§12 - 相依：無（BE-06 已合併）
- 負責檔案：
api/src/main/java/com/cdp/profile/、api/src/main/java/com/cdp/journey/、api/src/main/java/com/cdp/query/api/src/main/java/com/cdp/ingest/EventIngestionService.java、api/src/main/java/com/cdp/persistence/JdbcProfileStore.javaapi/src/main/resources/db/migration/V7__profile_store.sqlapi/src/test/java/com/cdp/中對應上述類別的單元測試（acceptance/除外）
- 禁區：
auth.md與 security／user 套件（另有 auth-session-design 進行中）；不可改驗收測試；不可讀 .env - 驗收測試：
api/src/test/java/com/cdp/acceptance/profile-store-api/
- 驗收條件：
-
profiles.md全部 API：四種方式搜到客戶（完全比對）、客戶頁資料、遮罩依白名單 -
journeys.md§2 旅程列表與唯讀旅程頁（含版本切換）、/enrollments瀏覽與 V7 兩個索引 - 事件攝取對未知客戶建空白 profile（
on conflict do nothing），寫入只經ProfileWriter - 三種角色依
auth.md§2 放行／拒絕 - 既有驗收全綠
-
- 驗證指令：
make check - 回報檔：
reports/profile-store-api.json
Activity
Marcus778899 commentedon Oct 23, 2026
派工單追加 2026-10-23
範圍補充（qa 寫驗收時發現，manager 追認）
api/src/main/resources/application.yml、api/src/test/resources/application-test.yml、.env.example（只為接上CDP_PHONE_DEFAULT_COUNTRY_CODE等本單需要的設定）acceptance/profile-store-api/（套件com.cdp.acceptance.profilestoreapi，commit b210339，已 lock）cdp.phone.default-country-code、cdp.phone-default-country-code、cdp.profile.phone-default-country-code、cdp.profile.default-country-code其中一個profile／profile_identifier的 SQL 只出現在com.cdp.profile.ProfileWriter；EventIngestionService與com.cdp.profile.ProfileService都依賴它（ArchUnit＋原始碼掃描）cursor不合法 → 400VALIDATION_FAILED；攝取建空白客戶為同步（202 後立即可 GET）；被拒絕的事件不建客戶"***"（journey-engine §4.4）Marcus778899 commentedon Oct 23, 2026
派工單追加 2026-10-23
範圍修正（manager 追認 worker 回報的 open_questions，取代上方「負責檔案」）
api/src/main/java/com/cdp/profile/、api/src/main/java/com/cdp/journey/、api/src/main/java/com/cdp/query/api/src/main/java/com/cdp/ingest/EventIngestionService.java、api/src/main/java/com/cdp/persistence/JdbcProfileStore.javaapi/src/main/java/com/cdp/persistence/JdbcEnrollmentQueryStore.java、api/src/main/java/com/cdp/persistence/JdbcJourneyQueryStore.java（新增）api/src/main/java/com/cdp/common/web/ErrorCode.java（只新增profiles.md的錯誤碼）api/src/main/resources/db/migration/V7__profile_store.sqlapi/src/main/resources/application.yml、api/src/test/resources/application-test.yml、.env.exampleapi/src/test/java/com/cdp/中對應上述類別的單元測試（acceptance/除外）acceptance/query/EnrollmentQueryAcceptanceTest的爭議交 architect 仲裁中，結果另行通知；updated_at行為一併請 architect 確認Marcus778899 commentedon Oct 24, 2026
派工單作廢
作廢（D-072）：仲裁 TEST_WRONG 要改的舊驗收 acceptance/query/EnrollmentQueryAcceptanceTest.java 不在派工單範圍，本輪已追加過無法補；以正確範圍重開新單