Batch drag updates per frame and defer full layout recalculation until release. Cover resize edge cases and retain goals review records.
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 응답만 지연했다.
draft A를 입력하고 칸을 떠나 저장 요청을 보낸다.- 요청이 끝나기 전에 같은 칸에
draft B를 입력한다. - 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도 그 임시 폴더에 설치했다. 저장소 의존성 파일은 변경하지 않았다. - 수정 순서: 칸별 저장 큐·요청값/초안 분리 → 실패 시 초안 보존·구조 변경 중단 → 전주 연결/날짜 정합성 → 실적 장애 구분·달성률 갱신 → 메뉴 접근성과 갱신 실패 안내.
이 보고서는 발견·재현 결과이며 수정 완료 보고서가 아니다.