MH-DashBoard-organization/docs/NEXT_SESSION_CHECKPOINT.md

Next Session Checkpoint

Current Base

• branch: total
• latest integration commit: 61b5638
• main history doc: DEVELOPMENT_HISTORY.md

What Was Finished

Dashboard Integration

• 조직 현황, 프로젝트별 분석, 팀/개인별 분석, 자리배치도를 하나의 허브에 통합
• payment.html, mh.html을 현재 프로젝트에 편입
• 공통 헤더, 탭, 로그인 정보, 공통 기간 제어 구성

Integrated DB

• organization.xlsx, MH.xlsx, payment.csv, ptj.csv 기반 통합 DB 구성
• raw/staging/standard 성격의 구조를 PostgreSQL에 반영
• members, seat_maps, seat_slots, seat_positions
• integration_raw_*, integration_work_logs, integration_work_log_segments, integration_vouchers
• 프로젝트 카테고리 매핑 반영

Team / Member Analysis

• omh.html 원본 기준으로 계산식/카테고리/디자인 복원
• DB raw MH 데이터를 원본 입력 구조처럼 다시 공급하는 방식으로 정리

Project Analysis

• opayment.html 원본 기준으로 화면 복원
• payment.csv 분류 우선, ptj.csv fallback 적용
• 연장근무는 연장근무 시간(가공) 기준으로 반영

Organization / Seat Map

• 조직도 상세 프로필에 재석위치 preview 연결
• 관리자/비관리자 자리배치도 화면 분리
• 저장 후 조직도와 비관리자 열람에 반영되도록 seat save 흐름 정리
• seat persistence bug 수정
  • 원인: seat_positions_map_cell_idx가 slot 기반 도면에도 적용됨
  • 조치: seat_slot_id IS NULL인 grid map에만 적용되도록 수정

Member Data Governance

• 이름 alias, 퇴사 제외, 조직 override를 DB 테이블 기반으로 전환
• 사용 테이블:
  • member_aliases
  • member_retirements
  • member_overrides

External Access

• WSL 내부 8080 리슨 확인
• Windows portproxy를 이용해 다른 PC에서 접속 가능하게 설정
• 현재 기준 주소:
  • http://172.16.40.144:8080

Important Runtime Notes

Seat Map Save

• 저장이 안 되면 먼저 backend 로그에서 PUT /api/seat-maps/{id}/layout 상태코드 확인
• 과거 핵심 장애는 DB 인덱스 충돌이었다
• 현재 저장 구조는:
  • seat_positions
  • members.seat_label 둘 다 같이 갱신

External Access

• Windows LAN IP가 바뀌면 접속 주소가 바뀔 수 있음
• WSL IP가 바뀌면 portproxy connectaddress를 다시 맞춰야 함
• 다음 확인 명령:
  • Windows: ipconfig
  • WSL: hostname -I
  • Windows: netsh interface portproxy show all

Open Issues

• #2 백엔드 영속 저장 구조 운영 마무리 및 스냅샷 검증
• #3 사무실 좌석 배치도 조회 및 관리자 편집 기능 고도화
• #5 실제 인증 체계 전환
• #6 4개 기능 통합 대시보드 프레임 및 공통 헤더 구축
• #7 자리배치도 팀별 색상 오버레이 표시
• #8 자리배치도 좌석 클릭 시 개인 상위 조직 트리 표시
• #9 조직도·자리배치도 변경 이력 버전 누적 저장

Unfinished Ideas Discussed Today

Seat Map UX

• 자리배치도 내 인원 등록 시 팀별 색상 표시
• 좌석 클릭 시 본인까지의 상위 조직 트리 표시
• 나머지 사무실 2개 도면 추가
  • 한맥빌딩 7층
  • 한맥빌딩 6층
• 비관리자 열람 화면 품질 추가 점검

History / Versioning

• 조직도와 자리배치도 수정 이력을 버전 누적형으로 저장
• 원본 DB와 별도의 history/snapshot 구조 설계
• 날짜/버전 형식 예:
  • 00.00.00
  • 또는 날짜 기반 revision

Project Analysis Accuracy

• 총합은 거의 맞았지만 일부 프로젝트 단위 소수점/분류 오차는 추가 정밀 보정 필요
• opayment 기준으로 특정 프로젝트 차이를 계속 줄여야 함

Auth / Permission

• mock login을 실제 인증 체계로 전환
• 역할별 접근 제어 정리
• 조직도/자리배치도/분석 화면 권한 경계 재정리

Recommended Next Work Order

1. 자리배치도 저장/표시를 브라우저에서 한 번 더 실사용 검증
2. #7, #8, #9 중 우선순위 확정
3. 프로젝트별 분석 남은 오차 정밀 보정
4. 실제 인증 체계 설계/구현

Quick Resume Prompt

다음 세션 시작 시 아래 기준으로 이어가면 된다.

• 브랜치 total에서 시작
• 최근 커밋 61b5638 확인
• docs/DEVELOPMENT_HISTORY.md
• docs/NEXT_SESSION_CHECKPOINT.md
• Gitea 이슈 #7, #8, #9

그리고 먼저 현재 외부 접속과 자리배치 저장이 정상인지 확인한 뒤 다음 기능 개발로 넘어간다.