From fe6757f00aaf39c8bf859c4202f94c93aeeedcec Mon Sep 17 00:00:00 2001 From: zio Date: Mon, 13 Jul 2026 23:48:03 +0900 Subject: [PATCH] docs(web): fix stale backend-not-implemented comments (GAP hygiene item) auction/visitor/marketing sample data + cms.css headers now state the real wiring status (live API primary, samples are degraded fallback only; G-04 SMTP follow-up noted). Mark hygiene item resolved in GAP_AUDIT. Co-Authored-By: Claude Fable 5 --- docs/GAP_AUDIT.md | 14 +++++++------- src/frontend/src/screens/auction/sampleAuction.ts | 2 +- src/frontend/src/screens/cms/cms.css | 2 +- .../src/screens/marketing/sampleMarketing.ts | 2 +- src/frontend/src/screens/visitor/sampleVisitor.ts | 2 +- 5 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/GAP_AUDIT.md b/docs/GAP_AUDIT.md index d47aec5..7a9c59a 100644 --- a/docs/GAP_AUDIT.md +++ b/docs/GAP_AUDIT.md @@ -81,12 +81,12 @@ ### 데이터 이슈 (코드 정상 · 담당=kintex-testdata-dev) - sample-import 12개 화면(analytics·dashboard·ops·floorplan·gallery·marketing×2·schedule·visitor×3)은 **조건부 degraded 폴백**(NETWORK/NOT_FOUND/NOT_IMPLEMENTED 시에만 sample). 실 API가 primary. 빈 화면으로 보이면 코드가 아니라 **행사스코프 시드 미정렬** → testdata 담당. -### 문서 위생 — STALE 주석 (기능 영향 없음 · 담당=frontend-dev 청소) -- `screens/auction/sampleAuction.ts:3` "M15 역경매 엔진 미구현" → 실구현됨 -- `screens/visitor/sampleVisitor.ts:3` "M10/M11 백엔드 미구현" → 실구현됨 -- `screens/marketing/sampleMarketing.ts:3` "M12 백엔드 미구현" → 실구현됨 -- `screens/cms/cms.css:4` "M17 백엔드 미구현 → 전 화면 로컬 샘플" → cmsApi 실배선됨 -→ 주석만 갱신(오해 유발). 재감사 오탐 방지 위해 정리 권장. +### 문서 위생 — STALE 주석 (기능 영향 없음 · 담당=frontend-dev 청소) — ✅해소(2026-07-13) +- ~~`screens/auction/sampleAuction.ts:3` "M15 역경매 엔진 미구현"~~ → 실구현 반영 주석 갱신 +- ~~`screens/visitor/sampleVisitor.ts:3` "M10/M11 백엔드 미구현"~~ → 실구현 반영 주석 갱신 +- ~~`screens/marketing/sampleMarketing.ts:3` "M12 백엔드 미구현"~~ → 실구현 반영 주석 갱신(G-04 실발송 후속 명시) +- ~~`screens/cms/cms.css:4` "M17 백엔드 미구현 → 전 화면 로컬 샘플"~~ → cmsApi 실배선 반영 주석 갱신 +→ 4건 모두 "실구현 완료 + 샘플은 강등 폴백" 문구로 정정. 재감사 오탐 방지. --- @@ -101,7 +101,7 @@ | 5 | G-06/G-07 | 회의 STT·통합검색 자연어 AI | kintex-ai-dev | | 6 | G-05/G-09 | 서류 HWP/PDF 생성·렌더 이력 영속(파일/렌더 큐) | kintex-backend-dev | | 7 | G-08 | 마이페이지 프로필 PUT·알림설정 API | kintex-backend-dev + frontend-dev | -| 8 | (위생) | STALE "미구현" 주석 4건 정리 | kintex-frontend-dev | +| 8 | ~~(위생)~~ ✅ | STALE "미구현" 주석 4건 정리 — 2026-07-13 해소 | kintex-frontend-dev | | — | (데이터) | 행사스코프 시드 정렬(빈 화면 폴백 해소) | kintex-testdata-dev | --- diff --git a/src/frontend/src/screens/auction/sampleAuction.ts b/src/frontend/src/screens/auction/sampleAuction.ts index 8125a3c..9b3818f 100644 --- a/src/frontend/src/screens/auction/sampleAuction.ts +++ b/src/frontend/src/screens/auction/sampleAuction.ts @@ -1,6 +1,6 @@ /* * M15 공사/장치 옥션 시연용 샘플 데이터. - * ★ M15 역경매 엔진은 미구현 — 실 API 연동 전까지 화면 시연을 위한 정적 데이터. + * ★ M15 역경매 엔진은 백엔드 실구현 완료(auctionApi 실배선). 본 파일은 오프라인/미연결 강등 시 시연용 폴백 데이터일 뿐이며 정상 경로는 실 API 를 소비한다. * 존재하지 않는 엔드포인트를 fetch 하지 않으며, 모든 화면 상단에 "샘플 데이터" 배지를 노출한다. * 응찰/낙찰 등 뮤테이션은 로컬 상태 데모로만 처리한다. * 보안 도메인 규칙(UI 반영): diff --git a/src/frontend/src/screens/cms/cms.css b/src/frontend/src/screens/cms/cms.css index cca2eef..9ab03c8 100644 --- a/src/frontend/src/screens/cms/cms.css +++ b/src/frontend/src/screens/cms/cms.css @@ -1,7 +1,7 @@ /* * M17 CMS 화면(SCR-35 게시 워크플로 · SCR-36 마이크로사이트 편집기 · SCR-37 다국어 관리) 공유 스타일. * design.md §1 토큰(tokens.css)만 참조. shared.css 프리미티브(kx-page·kx-card·kx-seg·kx-select·kx-kpi·kx-barlist) 위에 얹는다. - * M17 백엔드 미구현 → 전 화면 로컬 샘플 데이터 데모. 존재하지 않는 API 호출 없음. + * M17 백엔드 실구현 완료(cmsApi 실배선). 화면은 정상 경로에서 실 API 를 소비하며, 로컬 샘플은 강등 시 폴백 데모용이다. */ @import '../shared.css'; diff --git a/src/frontend/src/screens/marketing/sampleMarketing.ts b/src/frontend/src/screens/marketing/sampleMarketing.ts index 35300cd..24864b6 100644 --- a/src/frontend/src/screens/marketing/sampleMarketing.ts +++ b/src/frontend/src/screens/marketing/sampleMarketing.ts @@ -1,6 +1,6 @@ /* * SCR-33 EDM·캠페인 · SCR-34 스폰서십 샘플 데이터 (M12). - * ★ M12 백엔드 미구현 → 화면은 실 API 미호출, 본 시연 데이터 표시("샘플 데이터" 배지). + * ★ M12 백엔드 실구현 완료(marketingApi 실배선 — 캠페인 상태 전이까지). 화면은 정상 경로에서 실 API 를 소비하며, 본 데이터는 강등 시 폴백이다. (실 이메일 발송은 SMTP 연동 후속 — G-04.) * ★ 세그먼트 규모는 M10 관람객 데이터 파생 가정치이며 실제 개인정보는 포함하지 않는다(N2). */ diff --git a/src/frontend/src/screens/visitor/sampleVisitor.ts b/src/frontend/src/screens/visitor/sampleVisitor.ts index 62a70fe..98e6359 100644 --- a/src/frontend/src/screens/visitor/sampleVisitor.ts +++ b/src/frontend/src/screens/visitor/sampleVisitor.ts @@ -1,6 +1,6 @@ /* * SCR-30 관람객 등록 관리 · SCR-32 리드 관리 샘플 데이터 (M10/M11). - * ★ M10/M11 백엔드 미구현 → 화면은 실 API 를 호출하지 않고 본 시연 데이터를 표시한다("샘플 데이터" 배지). + * ★ M10/M11 백엔드 실구현 완료(visitorApi 실배선). 화면은 정상 경로에서 실 API 를 소비하며, 본 데이터는 NETWORK/NOT_FOUND/NOT_IMPLEMENTED 강등 시에만 노출되는 오프라인 폴백("오프라인 — 샘플" 배지)이다. * ★ 보안 불변(PII 미노출): 이름·연락처·이메일은 이미 마스킹된 형태로만 보관/노출한다. * 실제 구현 시 원문 PII 는 서버가 보관하고 API 응답에서 마스킹하여 내려준다(N2/R10). */