24.5 KB · 수정 2026-10-19 10:40
목차

pfs 유사작업 매뉴얼 (playbook)

새 pfs 작업 시 여기서 유사작업을 찾아 절차 + 참고 포인터만 펼쳐 정보수집 후 진행한다. 불변 사실(경로·포트·인증·위험규칙)은 handoff.md "확정 사실", 함정은 traps.md, 스키마는 schema-estimate.md.

작업유형 → 참고 포인터 인덱스 (빠른 진입)

§1 발주서정리/입고일정(orderpaper) UI 변경

§2 운영 배포 절차 (master→deploy-live)

  1. master에 push(테스트 자동배포) → gh run watch <id> --exit-status로 확인.
  2. 운영은 페페가 "운영 배포해줘" 명시 시에만. ⚠deploy-live 는 워크트리 C:\dev\pfs_deploy_wt 가 점유한다 — 메인 C:\dev\pfs 에서 git checkout deploy-live 는 fatal: already used by worktree(26.9.10 이 옛 문구대로 하다 재발). 배포는 그 워크트리에서(깨끗한지·브랜치 확인 → merge --ff-only origin/deploy-live → 아래 선별 포워드 → push). ⛔git merge master 금지 — 두 브랜치가 수백 커밋 갈라져 있어 미배포분이 통째로 나간다(projects/dwgrev/rules.md).
  3. 강제푸시·reset --hard 도구 차단 → 일반 머지/커밋만. 되돌림은 포워드 복원(파일을 목표 커밋으로 checkout 후 일반 커밋).
  4. 배포 후 운영 Playwright 검증(§4) → handoff/세션 갱신 → notify-step/done. - 참고: deploy-live↔master 순수차이=migrations/create_dispatch_tables.sql(무해). - 미반영 커밋 세기(2026-07-27): 운영은 cherry-pick 이력이라 해시가 달라 deploy-live..master 원시 개수는 과대계상(89건→실제 20건). patch-id 비교로 세라: git log --no-merges --cherry-pick --right-only origin/deploy-live...origin/master → 그 결과도 git diff --stat origin/deploy-live origin/master와 대조해 diff 0인 것 제외. - 선별 배포(일부 커밋만): merge는 원치 않는 커밋까지 끌고 온다 → 파일단위 포워드 반영 git checkout deploy-live → git checkout origin/master -- <files> → 그룹별 커밋(위험 낮은 순: 스크립트→백엔드 파서→웹UI) → push 1회(그룹마다 push하면 운영 재시작 N회). 전제 = 대상 파일이 제외할 커밋에 걸치지 않을 것(git log ... -- <file>로 확인). - 관리 페이지: 미반영 커밋 현황·배포 체크리스트 = C:\dev\devplan\pfs.html(devplan 허브 pfs 카드). 배포하면 그 파일의 PENDING/DONE 배열을 갱신한다.

§3 RDS 컬럼 추가/조회 (SSM 경유)

§4 Playwright 화면 검증

§5 알림(broker)

§7 견적서(양식) xlsx → 본건+추가건 등록 (2026-07-30 신설)

§6 worklog 추정현장 자동연결 (표준규칙 — 페페 지시 2026-06-22 "앞으로도")

§8 포인/PFS 견적 → 한샘 양식 엑셀 변환 (+타입별 견적 위치도) — 26.10.8 신설 [코디]

§9 도어발주서 수작업 완료 → 최신도면 대조 검토(포인검토 사본) — 26.10.19 신설 [코디]