docs: K-4 문의 댓글 API 연동 완료 업데이트

- K-4 문의 관리: 댓글 CRUD 연동 상태 추가
- 변경 이력에 댓글 API 연동 작업 기록

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-29 09:24:09 +09:00
parent 8f8d56adc1
commit 95fba81f08

View File

@@ -307,30 +307,36 @@ interface BoardSetting { // EAV 필드 스키마
| # | 페이지 | React 경로 | 조회 | 등록 | 수정 | 삭제 | API 연동 전략 |
|---|--------|-----------|------|------|------|------|--------------|
| J-1 | 게시판 목록 | `/board` | 🔄 Mock | ⏭️ | ⏭️ | ⏭️ | `GET /boards` + 게시글 API 필요 |
| J-2 | 게시글 상세 | `/board/[id]` | 🔄 Mock | ⏭️ | 🔄 | 🔄 | 게시글 API 필요 (posts CRUD) |
| J-3 | 게시글 작성/수정 | `/board/[id]/edit` | 🔄 Mock | 🔄 | 🔄 | ⏭️ | 게시글 API + 커스텀필드 동적 렌더링 |
| J-1 | 게시판 목록 | `/board` | | ⏭️ | ⏭️ | | ✅ 완료 (2025-12-29) - `actions.ts` getPosts/getMyPosts |
| J-2 | 게시글 상세 | `/board/[boardCode]/[postId]` | ✅ | ⏭️ | ⏭️ | ✅ | ✅ 완료 (2025-12-29) - `actions.ts` getPost/deletePost |
| J-3 | 게시글 작성/수정 | `/board/[boardCode]/[postId]/edit` | | | | ⏭️ | ✅ 완료 (2025-12-29) - `actions.ts` createPost/updatePost |
| J-4 | 게시판 관리 | `/board/board-management` | ✅ | ✅ | ✅ | ✅ | ✅ 완료 (2025-12-27) |
**파일 구조 → 연동 계획:**
> ✅ **Phase J 완료** (2025-12-29): 모든 게시판 Mock → API 연동 완료
**파일 구조 (완료):**
```
components/board/
├── types.ts ← 🔄 Board, Post, BoardSetting 타입으로 교체
├── actions.ts ← 🆕 Server Actions (게시판/게시글 CRUD)
├── BoardForm/ ← 🔄 동적 폼 렌더링 (EAV 필드 기반)
├── BoardDetail/ ← 🔄 게시글 상세 + 커스텀필드 표시
├── BoardList/ ← 🔄 게시판별 필터링 + 페이지네이션
├── types.ts ← ✅ Post, Comment, PostApiData 등 API 타입 정의
├── actions.ts ← Server Actions (getPosts, getPost, createPost, updatePost, deletePost)
├── BoardForm/ ← ✅ getBoards + createPost/updatePost API 연동
├── BoardDetail/ ← 게시글 상세 + 삭제 API 연동
├── BoardList/ ← 게시판별 필터링 + 페이지네이션 + 삭제
└── BoardManagement/
├── types.ts ← 🔄 Board 관리 타입으로 교체
├── actions.ts ← 🆕 `/admin/boards/*` API 연동
└── BoardForm.tsx ← 🔄 템플릿 선택 + 필드 관리 UI
├── types.ts ← Board 관리 타입
├── actions.ts ← ✅ getBoards, createBoard, updateBoard, deleteBoard
└── index.tsx ← ✅ 게시판 CRUD 완료
```
**라우트 변경:**
- 기존: `/board/[id]` → 신규: `/board/[boardCode]/[postId]`
- 삭제된 파일: `board/[id]/page.tsx`, `board/[id]/edit/page.tsx`
---
### 2.2 Phase K: 고객센터
> **상태**: mng 게시판 시스템의 **템플릿 기반 게시판**으로 통합 운영
> **상태**: ✅ React 연동 완료 (2025-12-29) - `shared/actions.ts` 통해 시스템 게시판 API 호출
#### 🎯 통합 전략: 고객센터 = 게시판 템플릿 활용
@@ -352,10 +358,10 @@ components/board/
| # | 페이지 | React 경로 | 조회 | 등록 | 수정 | 삭제 | API 연동 전략 |
|---|--------|-----------|------|------|------|------|--------------|
| K-1 | FAQ 관리 | `/customer-center/faq` | 🔄 Mock | 🔄 | 🔄 | 🔄 | `board_code: system-faq` 게시글 API |
| K-2 | 이벤트 관리 | `/customer-center/events` | 🔄 Mock | 🔄 | 🔄 | 🔄 | `board_code: system-event` 게시글 API |
| K-3 | 공지사항 관리 | `/customer-center/notices` | 🔄 Mock | 🔄 | 🔄 | 🔄 | `board_code: system-notice` 게시글 API |
| K-4 | 문의 관리 | `/customer-center/inquiries` | 🔄 Mock | 🔄 | 🔄 | 🔄 | `board_code: system-qna` 게시글 API + 답변 |
| K-1 | FAQ 관리 | `/customer-center/faq` | ✅ | ⏭️ | ⏭️ | ⏭️ | ✅ 완료 (2025-12-29) - `shared/actions.ts` |
| K-2 | 이벤트 관리 | `/customer-center/events` | | ⏭️ | ⏭️ | ⏭️ | ✅ 완료 (2025-12-29) - `shared/actions.ts` |
| K-3 | 공지사항 관리 | `/customer-center/notices` | | ⏭️ | ⏭️ | ⏭️ | ✅ 완료 (2025-12-29) - `shared/actions.ts` |
| K-4 | 문의 관리 | `/customer-center/inquiries` | ✅ | ✅ | | | ✅ 완료 (2025-12-29) - `shared/actions.ts` + 댓글 CRUD |
**파일 구조 → 연동 계획:**
```
@@ -464,6 +470,9 @@ react/src/components/
| 날짜 | 작업 | 상세 내용 |
|------|------|----------|
| 2025-12-29 | K-4 문의 댓글 API 연동 완료 | 댓글 CRUD API 연동 (getComments, createComment, updateComment, deleteComment). BoardComment 모델 replies() 추가, PostService user eager loading 추가, user.id localStorage 저장으로 본인 글 수정/삭제 버튼 표시 |
| 2025-12-29 | Phase J 게시판 시스템 React 연동 완료 | J-1~J-3 완료: `board/actions.ts` 생성 (getPosts, getPost, createPost, updatePost, deletePost). BoardList, BoardDetail, BoardForm 모두 API 연동. 라우트 변경: `/board/[id]` → `/board/[boardCode]/[postId]`. Toast sonner 통일, MOCK_BOARDS 완전 제거 |
| 2025-12-29 | Phase K 고객센터 API 연동 완료 확인 | K-1~K-4 모두 `shared/actions.ts` 통해 시스템 게시판 API 호출. FAQList, NoticeList, EventList, InquiryList/Form 모두 `getPosts()` 사용 |
| 2025-12-28 | 시스템 게시판 API 개발 완료 | `/api/v1/system-boards/*` 엔드포인트 12개 추가 (게시판 3개 + 게시글 5개 + 댓글 4개), SystemBoardController, SystemPostController, Swagger 문서 |
| 2025-12-27 | 게시판 API 아키텍처 개선 | 시스템/테넌트 게시판 엔드포인트 분리 (`/system-boards/{code}` vs `/boards/{code}`), ID 기반에서 code 기반 URL로 통일, 메뉴 자동 생성 기능 추가 예정 |
| 2025-12-27 | 종합분석 승인/반려 버그 수정 | `ComprehensiveAnalysisService::getTodayIssue()` - 현재 사용자가 결재자인 문서만 표시하도록 수정. 이전에는 테넌트의 모든 대기 결재가 표시되어 "결재 순서가 아닙니다" 오류 발생 |