Files
dbx-main/docs/reviews/GOALS_MEETINGS_REVIEW_2026-10-01.md
T
king e726f986db perf(project): smooth sidebar resizing
Batch drag updates per frame and defer full layout recalculation until release. Cover resize edge cases and retain goals review records.
2026-10-03 06:45:56 +09:00

8.5 KiB

목표관리·주간회의록 점검 — 2026-10-01

대상: 로컬 HEAD 21981eb, app/modules/project/의 목표·회의록 저장/조회, app/static/project.js, 두 화면 템플릿. 실제 Chrome 운영 화면은 읽기 전용으로 관찰했다. 기능 코드·운영 DB·환경변수는 수정하지 않았다.

확인 결과: 기능 버그 7개, UI·UX 문제 2개. P1은 입력 손실 때문에 우선 수정, P2는 데이터 연결·표시 정확도 수정이다. UI·UX 항목은 개선 제안으로 구분한다.

번호 우선순위 위치 문제와 수정 방향
1 P1 app/static/project.js:9110 회의록 자동 저장 응답에서 요청 당시 글 대신 현재 입력값을 saved로 기록한다. 미전송 글이 저장됐다고 간주되어 다음 저장을 생략한다. 요청값을 캡처하고 칸별 저장 순서·최신 입력을 관리한다.
2 P1 app/static/project.js:8229, 9179 숫자 저장의 늦은 응답이 사용자가 다시 입력 중인 값을 덮는다. 목표 표 숫자와 회의록 정량 목표·결과 입력에 같은 구조가 있다. 응답은 요청값이 현재 초안과 일치할 때만 입력창에 반영한다.
3 P1 app/static/project.js:8257, 8386, 8416 목표 글 저장 실패를 함수 내부에서 삼켜 구조 변경이 계속된다. 표를 다시 그리면 미저장 글이 사라진다. 저장 실패를 상위 작업에 전달하고, 모든 변경·진행 중 저장을 완료하기 전 DOM 교체·병합을 막는다.
4 P2 app/modules/project/db.py:2524, 2536 다음 주 회의록을 먼저 만들고 앞 주를 나중에 만들면 기존 다음 주의 carry_from을 연결하지 않는다. 실제 운영 화면에도 앞 주 존재 표시와 다음 주 리뷰 미연결이 동시에 있다. 안정적인 항목 연결키를 두고 생성 순서와 무관하게 전주 연결을 처리한다.
5 P2 app/modules/project/router.py:2922, app/modules/project/templates/project/goal_meeting.html:190 한 주 이상 건너뛰면 가장 가까운 과거 회의록의 줄을 읽으면서 표 머리는 무조건 직전 주 날짜를 표시한다. 다른 주의 목표·결과·달성률을 지난주 수치로 오인한다. 실제 참조 주를 표시하거나 직전 주가 없으면 리뷰를 비운다.
6 P2 app/modules/project/router.py:2849, 2854, 2901 쇼핑몰 목록 조회 장애를 빈 목록으로 바꿔 매출 합계를 0원으로 표시한다. 저장소 객체만 있으면 연결 여부도 참이다. 조회 실패와 실제 0건을 구분해 장애 시 지표를 미확인으로 표시한다.
7 P2 app/static/project.js:9179 이번주 정량 목표 저장 뒤 pj-meet-week-slot의 목표 대비 %를 갱신하지 않는다. 이번주 실적 표시를 보관해 목표 변경 후 즉시 재계산한다.
8 UX app/static/project.js:8483, 8560, app/modules/project/templates/project/goals.html 목표 구역·항목의 색·순서·줄 추가·삭제가 우클릭 메뉴에만 있다. 키보드로 이름 칸에 접근할 수 없고 터치 대안도 없어 기능을 찾고 실행하기 어렵다. 이름 칸에 포커스 가능한 메뉴 버튼이나 키보드·터치 진입점을 제공한다.
9 UX app/static/project.js:8860, 8926, app/modules/project/templates/project/goal_meeting.html:109 매출 자동 갱신 실패 메시지도 숨은 상태 요소에만 전달되어 사용자는 실패·자료 시점을 알 수 없다. 정상 갱신은 조용히 유지하되 실패 안내와 마지막 성공 시점·재시도 진입점을 제공한다.

재현 근거

1. 회의록: 저장되지 않은 글을 저장됨으로 처리

실제 project.js를 jsdom에서 실행하고 PUT 응답만 지연했다.

  1. draft A를 입력하고 칸을 떠나 저장 요청을 보낸다.
  2. 요청이 끝나기 전에 같은 칸에 draft B를 입력한다.
  3. A의 저장 응답을 완료하고 B의 자동 저장 대기 시간 800ms가 지나도록 기다린다.

관찰 결과: 화면 B, data-saved B, 서버 A, PUT 1회. 두 번째 글은 서버에 보내지지 않았다. flush()가 await p.save(ta.value) 뒤 바뀐 ta.value를 저장 완료 값으로 기록하기 때문이다.

추가 실패 시나리오: 저장을 503으로 실패시킨 뒤 beforeunload를 발생시키면 요청은 실패한 PUT 한 번뿐이었다. pending에서 먼저 지운 칸은 페이지 이탈 저장에도 포함되지 않는다. 실패한 초안을 계속 dirty 상태로 보관해야 한다.

2. 숫자: 이전 저장 응답이 최신 입력을 덮음

목표 숫자 200의 저장 응답을 지연한 동안 같은 입력창을 300으로 바꾸고, 그 후 200 응답을 완료했다.

관찰 결과: 현재 입력 300 → 200. 사용자 초안이 이전 요청 응답으로 바뀌었다. 회의록 금액 저장도 응답값을 무조건 입력창에 대입하는 동일한 방식이다.

3. 목표 표: 저장 실패 후 구조 새로 그리기로 글 손실

목표 칸에 unsaved important plan을 입력한 직후 업무 영역 추가를 실행했다. 글 PUT은 503으로 실패, 화면 GET은 기존 저장본을 반환하도록 했다.

관찰 요청 순서: 영역 POST → 글 PUT(503) → 화면 GET. 최종 textarea는 **미저장 계획 → 기존 original**로 돌아갔다. 오류 토스트가 떠도 편집 글 자체가 사라진다. saveText()가 실패를 다시 던지지 않아 flushTexts()가 성공한 것처럼 끝난다.

4. 회의록 생성 순서에 따른 전주 연결 누락

실제 ProjectStore.create_meeting()을 호출하되 SQL 실행만 메모리 대역으로 바꿨다. 실제 DB에는 접속하지 않았다.

재현: 9/28 주 생성 → 9/21 주 생성. 결과: 앞 주 회의록은 존재하지만 9/28 줄의 carry_from은 NULL로 남았다.

운영 화면 관찰: 2026년 9월 화면에서 9/21·9/28 모두 회의록 존재 점이 있으며, 선택된 9/28 주의 24개 줄 중 data-prev가 있는 줄은 0개였다. 실제 운영 데이터가 이 상태에 이른 생성·삭제 이력은 확인하지 않았다. 생성 순서는 같은 상태를 만드는 확인된 원인이다.

5. 주차를 건너뛰었을 때 리뷰 기간 불일치

실제 _meeting_view()에 9/28 회의록의 참조 줄이 9/7 회의록인 데이터를 전달했다.

관찰 결과: 표 머리에 사용할 지난주 날짜는 9/21~9/27, 실제 줄의 결과 기간은 9/7~9/13, 그 다른 주의 목표 100·결과 50을 사용한 달성률 **50%**가 나온다. 머리의 전주 목표는 정확히 직전 주인지 검사하지만 줄은 검사하지 않는다.

6. 조회 장애가 실제 매출 0원처럼 표시

실적 저장소 대역의 list_marketplaces()에서 예외를 발생시켰다.

관찰 결과: 월 누적 0, 전주 결과 0, 금주 결과 0, perf=true. 월 목표 1,000원인 재현 데이터에서 필요 매출도 1,000원으로 계산됐다. 장애로 실적을 못 읽은 상태와 실제 무매출을 구분하지 못한다.

7. 목표 변경 뒤 이번주 달성률 미갱신

실제 회의록 JS에 현재 실적 100·목표 100·표시 100%인 행을 전달하고 목표를 200으로 저장했다.

관찰 결과: 목표 200, 이번주 실적 100, 표시 100% 유지. 올바른 표시는 50%다. 입력 금액만 바꾸고 아래 실적 비율은 재계산하지 않는다.

검증 범위와 우선순위

  • JS는 실제 전체 app/static/project.js를 실행했다. DOM·API는 로컬 테스트 대역이며 운영 화면에는 입력·생성·삭제를 실행하지 않았다.
  • Python은 실제 조회 함수·생성 메서드를 호출하고 DB·실적 저장소를 대역으로 바꿨다. 실제 PostgreSQL 통합 테스트는 실행하지 않았다.
  • 총 8개 재현 시나리오를 실행했다(위 7개 버그 + 저장 실패 후 페이지 이탈 시나리오). 레이아웃은 실제 Chrome 화면으로 확인했으며 모바일·인쇄는 미검증이다.
  • 재현 스크립트는 개발 PC %TEMP%/main-app-goals-review-20261001/에 review_ui.cjs, review_backend.py, review_rate.cjs로 보관했다. jsdom도 그 임시 폴더에 설치했다. 저장소 의존성 파일은 변경하지 않았다.
  • 수정 순서: 칸별 저장 큐·요청값/초안 분리 → 실패 시 초안 보존·구조 변경 중단 → 전주 연결/날짜 정합성 → 실적 장애 구분·달성률 갱신 → 메뉴 접근성과 갱신 실패 안내.

이 보고서는 발견·재현 결과이며 수정 완료 보고서가 아니다.