Files
dbx-main/scripts/sql/project_db_018_meeting_line_keys.sql
T
king e1006c63de fix(project): 목표·주간 회의록 저장 손실·지난주 연결·실적 미확인 수정 (점검 9건)
- 칸별 자동 저장 createFieldSaver: 같은 칸 요청 직렬화, 보낸 값만 saved,
  늦은 응답이 새 초안을 덮지 않음, 실패 시 초안·dirty 유지(빨간 테두리),
  localStorage 초안 백업·되살리기, 페이지 떠남 keepalive + 이탈 경고
- 목표 표: 저장 실패면 영역·줄·병합 작업과 표 교체 중단, 받는 사이 입력 보호
- 회의록: 금주 목표 저장 뒤 새로고침 대신 숫자 칸만 다시(차례 번호로 옛 응답 버림),
  이번주 실적 %는 서버 확정 목표로 즉시 재계산
- 지난주 = 정확히 7일 전 주의 같은 연결키 줄(line_key, 마이그레이션 018),
  역순 생성·이름 변경·삭제 후 재생성에도 연결, 이름 추정 연결 없음
- 실적 조회 장애를 0원 대신 미확인으로(목록·매출·부분 실패 구분)
- 구역·항목 ⋮ 메뉴 버튼(키보드·터치), 메뉴 키보드 탐색·포커스 복귀
- 매출 갱신 실패·일부 실패 안내 + 재시도, 서버 기록 갱신 시각, 권한 없으면 호출 안 함
- 테스트: Python 통합(역순 생성·실적 장애), 018 백필, jsdom UI 106건

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 21:14:10 +09:00

88 lines
5.8 KiB
PL/PgSQL

-- =====================================================================
-- project_db 마이그레이션 018 — 주간 회의록 줄 연결키(line_key)
-- =====================================================================
-- 멱등(idempotent). DROP TABLE/TRUNCATE/DELETE 없음 — 새 칸을 더하고 비어 있는 칸만 채운다.
--
-- 왜: 예전엔 "지난주" 줄을 carry_from(만들 때 앞선 회의록 줄 id)으로만 찾았다.
-- · 다음 주(9/28)를 먼저 만들고 앞 주(9/21)를 나중에 만들면 9/28 의 carry_from 이 비어 지난주 리뷰가 빠졌다.
-- · 한 주를 건너뛰면 몇 주 전 줄이 "지난주"로 보였다.
-- · 앞 주를 지웠다 다시 만들면 ON DELETE SET NULL 로 끊긴 연결이 돌아오지 않았다.
-- 이제: 줄마다 연결키(line_key) — 회의록을 만들 때 원본 줄의 키를 그대로 이어받고, 새 줄은 새 키.
-- "지난주" = 정확히 7일 전 주 회의록에서 같은 키의 줄(생성 순서·이름 변경·순서 이동과 무관).
--
-- ① line_key UUID 칸 추가
-- ② 기존 줄 채우기 — carry_from 사슬을 따라 같은 키를 준다(사슬의 맨 앞 줄 = 키의 뿌리).
-- carry_from 이 없는 줄(첫 회의록·줄 추가·앞 주 삭제로 끊긴 줄)은 자기만의 새 키 → 다른 줄에 붙지 않는다.
-- 이름(label)으로 추정해 붙이지 않는다(같은 이름 줄·이름 변경 때 다른 줄 결과가 섞일 수 있어서).
-- → 9/14 를 원본으로 9/28 을 먼저, 9/21 을 나중에 만든 경우 두 주 줄이 모두 9/14 키를 받아 9/28 ↔ 9/21 이 다시 연결된다.
-- → 둘 다 양식(앞선 회의록 없음)으로 만든 주끼리는 사슬이 없어 연결되지 않는다(자동 복구 범위 밖,
-- project_db_018b_meeting_line_link_candidates.sql 로 후보를 조회해 사람이 확인 후 따로 연결).
-- ③ 한 주 안에서 키가 겹치면(정상 데이터에선 없음) 순서가 뒤인 줄에 새 키 — 한 줄이 두 줄에 붙지 않게
-- ④ 기본값(예전 코드 호환) + NOT NULL + (week_start, line_key) UNIQUE
--
-- 미적용이어도 회의록은 동작한다 — "지난주"는 carry_from 이 정확히 7일 전 주 줄을 가리킬 때만 보인다(역순 생성 연결은 안 됨).
--
-- 적용 (1회, 여러 번 돌려도 안전, 적용 전 project_db 백업):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_018_meeting_line_keys.sql
-- 확인:
-- docker exec -i postgres-db psql -U postgres -d project_db -c \
-- "SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;"
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
BEGIN;
-- ① 칸 ─────────────────────────────────────────────────────────────
ALTER TABLE goal_meeting_items ADD COLUMN IF NOT EXISTS line_key UUID;
-- ② 기존 줄 — carry_from 사슬로 키 채우기(비어 있는 줄만). id 는 만든 순서라 자식 id > 부모 id(순환 방지).
-- 뿌리 키 = md5('goal_meeting_item:' || 뿌리 id) — 같은 데이터면 몇 번 돌려도 같은 키.
WITH RECURSIVE chain AS (
SELECT i.id, COALESCE(i.line_key, md5('goal_meeting_item:' || i.id)::uuid) AS k
FROM goal_meeting_items i
WHERE i.line_key IS NOT NULL
OR i.carry_from IS NULL
OR NOT EXISTS (SELECT 1 FROM goal_meeting_items p WHERE p.id = i.carry_from)
UNION ALL
SELECT c.id, chain.k
FROM goal_meeting_items c
JOIN chain ON c.carry_from = chain.id
WHERE c.line_key IS NULL AND c.id > chain.id
)
UPDATE goal_meeting_items g
SET line_key = chain.k
FROM chain
WHERE g.id = chain.id AND g.line_key IS NULL;
-- 사슬에 닿지 않은 줄(있을 수 없지만 안전하게) — 자기만의 키
UPDATE goal_meeting_items SET line_key = md5('goal_meeting_item:' || id)::uuid WHERE line_key IS NULL;
-- ③ 한 주 안 같은 키 — 순서가 뒤인 줄만 새 키(줄 내용·carry_from 은 그대로)
UPDATE goal_meeting_items g
SET line_key = md5('goal_meeting_item:dup:' || g.id)::uuid
FROM (SELECT id, row_number() OVER (PARTITION BY week_start, line_key ORDER BY sort_order, id) AS rn
FROM goal_meeting_items) d
WHERE g.id = d.id AND d.rn > 1;
-- ④ 제약 ───────────────────────────────────────────────────────────
-- 기본값 — 018 을 먼저 적용하고 코드를 나중에 배포해도(예전 코드는 line_key 를 넣지 않음) 줄 추가가 실패하지 않게 새 키.
-- 새 코드는 늘 키를 직접 넣는다(이어받기 = 원본 키, 새 줄 = 새 키). pgcrypto 없이 되는 식(md5 → uuid).
ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET DEFAULT md5(random()::text || clock_timestamp()::text)::uuid;
ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET NOT NULL;
CREATE UNIQUE INDEX IF NOT EXISTS uq_goal_meeting_items_week_key ON goal_meeting_items (week_start, line_key);
CREATE INDEX IF NOT EXISTS idx_goal_meeting_items_key ON goal_meeting_items (line_key);
COMMENT ON COLUMN goal_meeting_items.line_key IS
'주가 바뀌어도 같은 줄을 가리키는 연결키 — 회의록을 만들 때 원본 줄 키를 이어받음. 지난주 = 7일 전 주의 같은 키 줄';
COMMENT ON COLUMN goal_meeting_items.carry_from IS
'만들 때 이어받은 앞선 회의록 줄(이력). 화면의 지난주 연결은 line_key(018) 로 찾는다';
COMMIT;
SELECT 'project_db 018 meeting line keys ready' AS status,
(SELECT count(*) FROM goal_meeting_items) AS items,
(SELECT count(*) FROM goal_meeting_items WHERE line_key IS NULL) AS missing_keys;