[Docs] 인터페이스정의서 5-2 매핑표 DASH-W01 구분 확인

[yslee4601]

Description

인터페이스정의서 5-2 매핑표의 DASH-W01 갱신 방식이 실제 구현과 다르다. 어느 쪽이 맞는지 확정하고
문서 또는 코드를 맞춘다.

문서끼리 어긋나는 지점

위치	내용
docs/05_인터페이스정의서_v2_0.md:273	4-2 API 목록 — IF-API-03 의 구분 열이 Ajax
docs/05_인터페이스정의서_v2_0.md:355	5-2 매핑표 — "DASH-W01 | GET / | dashboard/index.html | Ajax 엔드포인트: IF-API-03 | 갱신 트리거: 진입 + 기준월 변경"
docs/05_인터페이스정의서_v2_0.md 5-1 총칙	"1차는 입력·목록은 MPA, 한도게이지·검증실행·대사상세는 Ajax" — 대시보드가 명시돼 있지 않다

즉 총칙에는 대시보드가 없는데 매핑표는 구체적으로 Ajax 라고 적어 두었다.

실제 구현 (PR #59)

DashboardViewController.java:30 — 진입 시 DashboardService.summarize(..) 를 서버에서 직접
호출하고, 기준월 변경은 ?month= 전체 페이지 리로드로 갱신한다. 두 트리거 모두 Ajax 를 타지 않는다.

그렇게 만든 이유는 같은 JVM 안에서 자기 REST API 를 HTTP 로 다시 부르면
직렬화·역직렬화와 인증을 한 번 더 태우는 값만 들기 때문이다. IF-API-03 자체는
DashboardController 에 그대로 살아 있고, 화면과 API 가 같은 DashboardService 를 공유한다.

확인·결정할 것

• 5-2 매핑표의 DASH-W01 구분을 MPA 로 교정할지, 아니면 구현을 Ajax 로 바꿀지 결정
  • MPA 로 교정 → :355 행의 "Ajax 엔드포인트" 칸을 IF-API-03 → 없음 으로
    (같은 표 AUTH-W01 행이 이미 없음 을 쓴다, :354). "갱신 트리거" 칸도 진입 + 기준월 변경
    이 전체 리로드라는 뜻이 되도록 손볼 것. 4-2 :273 의 IF-API-03 구분 열(Ajax)도 함께 검토 —
    IF-API-03 은 API 로는 계속 살아 있으므로 지울 대상은 아니다
  • Ajax 유지 → DashboardViewController 를 빈 셸만 내려보내고 화면 스크립트가
    GET /api/v1/dashboard/summary 를 호출하도록 변경. 이 경우 SIR-006(1차 MPA 위주)과의
    관계도 같이 정리해야 한다
• 결정한 내용을 5-1 총칙에도 한 줄로 반영 — 대시보드가 총칙에 없어서 생긴 충돌이다
• 근거대장.md 에 이 결정의 근거 ID 를 남길지 확인

참고

• 결정 전까지 코드는 현행(SSR + 전체 리로드) 유지. PR [Feat] 공통 셸(Thymeleaf 레이아웃) 및 DASH-W01 업무 대시보드 화면 구현 #59 는 이 상태로 진행한다.
• PR [Feat] 공통 셸(Thymeleaf 레이아웃) 및 DASH-W01 업무 대시보드 화면 구현 #59 리뷰 코멘트에서 분리. 봇도 "근거가 상충되어 확답하기 어렵다"고 판단했다.