🗂 상세 내역

주제별 상세 내용. 목차(주제 색인)의 번호와 대응. 확정/진행중/미결을 구분한다.

A. 인프라 · 환경

환경	포트	앱	브랜치	도메인	RDS
운영	8000	pfs	deploy-live	pfs.poin.co.kr	poin-dbinstance
테스트	8001	pfs-test	master	pfs-test.poin.co.kr	poin-dbinstance-test
- EC2 `i-03225ba8bc12a929e` / EIP `13.209.147.168` / SG `sg-00426f1b66795f5f9` / DB `pfs` user `admin`.
- .env: `/home/ubuntu/env/pfs-{live,test}.env`. 운영 service `pfs-live.uwsgi.service`.
- nginx 설정은 git 외 서버파일 → reload로 즉시 반영(deploy 불필요).
배포 메커니즘 `[확정]`: push → GitHub Actions(`deploy.yml`) → SSM send-command → `git fetch+reset --hard origin/<branch>` + 배포스크립. master는 pfs-test 디렉터리, deploy-live는 pfs 디렉터리. 운영 배포스크립은 `systemctl restart pfs-live.uwsgi.service`(과거 pgrep+kill-HUP 중복인스턴스 버그 수정됨).
## B. 작업 체계
3단계 시스템 `[확정]`
- ① 진단 — 채티가 원인을 코드/캐시/배포/DB 중 어디인지 확정. 필요시 MCP 즉석 확인. 불확실성 0으로 만든 뒤 다음 단계.
- ② 위임 — 정확한 위치+before/after .md 작성 → 코디에게 큰 묶음 한 번에. 검증 끝난 변경만 묶음에(미검증 추측 금지).
- ③ 분리 — 대량삭제·운영배포·DB변경·권한변경은 묶음에서 빼서 별도 승인.
채티 MCP 직접 vs 코디 위임 `[확정]` — 채티 직접(MCP)은 증상별로 완화: 진단·단건확인은 채티, 대량멀티파일 수정은 코디. 큰 묶음일수록 효율↑ 통제력↓ → 검증으로 상쇄. (MCP 쓰기 작업은 이번 세션에서 여러 차례 타임아웃 — 대량 편집은 코디 영역).
## C. estimate v2
QA #1~5 `[커밋확인]` (commit 5ee6663 등) — 품목유형/비고/단가 항상 입력 활성화(_isNew 조건 제거), cell-name resize:none/overflow:hidden, size-summary contenteditable 고정.
QA #6~9 `[커밋확인]` (commit 7be87f5) — cat-sel focus/click 시 keyword='' 강제로 전체목록, 기본 마진 15.5→10, menu_catalog 메뉴명 변경, company.margin_rate 컴럼 추가.
전체마진 자동반영 `[커밋확인]` (commit f6126d3) — site-search SQL에 company_no/company_member_no/company_margin_rate 추가. pickSite에서 선택 업체 margin_rate를 전체마진 자동 반영(없으면 10), 자동/수동 배지. 사용자 수정 시 수동 전환. 불러오기 시 저장값=수동.
## D. 업체 관리 · 권한
업체 관리 페이지 `[커밋확인]` (commit 424c099) — `/admin/company-permission` 제목·메뉴명 "업체 관리"로. company_dao.update_company_margin_rate / user_admin_service.set_company_margin_rate / PUT `/api/admin/company/<id>/margin-rate`. 좌:업체목록 우:상세+마진율+권한매트릭스. company/search가 a.* 반환 → margin_rate 자동 포함.
> 검증 일화(중요): "마진율이 전체 적용된다"는 증상은 진단 결과 백엔드·DB·배포 모두 정상, 실제 원인은 브라우저 캐시였음. DB에서 단건 UPDATE affected=1 증명 완료.
## E. 운영 배포
운영 RDS 스키마 진단 `[진단완료 2026-05-22]` — 운영에 부족한 것은 단 2가지: company.margin_rate 컴럼(없음), menu_catalog 메뉴명(업체 권한→업체 관리). estimate 컴럼(estimate_div 등)·Patch#32 테이블(menu_catalog 등 4개)·dispatch·estimate_detail_sub·ESTIMATE_DIV common_code는 이미 운영 존재. master→deploy-live 병합 충돌 0(merge-tree 미리보기 확인).
운영 배포 절차 `[지시문작성]` — 순서: ① 운영RDS SQL(margin_rate 컴럼 append+메뉴명) → ② deploy-live 병합·push(자동배포) → ③ 검증. 이유: 컴럼 먼저 추가해야 구코드 무중단(미참조). ALTER 락 주의: lock_wait_timeout=10, 실패시 uWSGI 중단 fallback.
## F. 디버깅 학습
- 엑셀/PDF 0KB `[해결 de4605a]` — Content-Disposition 한글 파일명 → werkzeug latin1 인코딩 실패 → 200+0bytes. safe_ascii가 c.isalnum()만 봤으나 Python3는 한글도 True. 수정: (ord(c)<128 and c.isalnum()) or c in '-.'. 교훈: uWSGI 디버그는 journalctl -u 먼저. 200+0bytes=헤더 인코딩 실패 의심.
- send_file(BytesIO) 호환성 `[확정]` — uWSGI wsgi.file_wrapper 충돌. make_response(buf.getvalue())+헤더 직접 사용.
- 로딩 최적화 `[해결 5bbaf87]` — nginx gzip(css/js/json/svg) 1.76MB→0.45MB. base.html 외부 SDK(Daum/Kakao) 동기로드 제거. 운영 미적용(테스트만).
- 수정해도 반영안됨 `[확정]` — ①서버파일 grep ②git pull 권한/safe.directory ③uWSGI 재시작 ④브라우저 시크릿 ⑤view-source. JS 에러는 후속 코드 전체 차단.
## G. 코딩 규약 (요약)
- 파일 다운로드: send_file(BytesIO) × → make_response(getvalue())+헤더. 한글파일명 RFC5987 + ASCII필터 ord(c)<128.
- args["key"] × → args.get("key",""). SELECT a.*+명시컴럼 중복 × → 별칭(AS).
- JS: 신규 API URL apiURL(), 버튼색 !important, 이벤트는 $(document).ready 내/위임, ready try/catch.
- REST: POST /api// · PUT/DELETE/GET /api// · GET .../list 또는 POST .../search. estimate GET={estimateMaster, estimateDetailList}.