- 소유권 게이팅(common/authz): 변경 액션 본인∪OWNER, 협력사 삭제 OWNER 전용
- 견적 수동 낙찰(award) + 작성자명(creatorName) 표시 + 전화번호 입력 컴포넌트 + 카드 엑셀 업로드
- supplier_type 은 이번 커밋 미변경(다음 커밋에서 코드부터 정리 예정)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
str.format_map 이 {{·}} 를 이스케이프로 해석해 색 마커 {{강조|텍스트}} 를 {강조|텍스트} 로
붕괴시키던 버그 수정. 정규식 \{(\w+)\} 으로 {변수} 단일 토큰만 치환 — 색 마커는 내부 |(비-\w)로
매칭되지 않아 그대로 보존된다. {변수} 치환·미등록 토큰 원형 유지는 동일.
엔드투엔드 검증(backoffice_db + 실 DB 카드)에서 발견. 회귀 테스트 추가, agent 87/87.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
표현 아키텍처: agent 스크립트는 의미(텍스트)만 소유, 표현(굵기·색)은 프론트 소유.
Slate 는 negodata 에디터 내부에만 두고, 전송/저장은 마커 문자열 한 벌(구버전의 리치텍스트 이중관리 폐기).
- 트랙 A (negodata): serializeToMarker 추가 — Slate 마크(bold/underline/color)를 **/__/{{토큰}} 로
인코딩해 nego_cards.script 저장. edit_script(Slate 원본)는 재편집 전용. 고정 3색 → 시맨틱 토큰(강조/안내).
- 트랙 B (agent): 카드 멘트 DB 소스 — ICardScriptRepository/CardScriptDbRepository(port+adapter),
ScriptRepository.resolve_card_script 가 cards.source_type=backoffice_db 면 card.nego_cards.script 우선,
없으면 파일 폴백. action_id→card_id→nego_cards.number 매칭.
- 트랙 C (양 프론트): renderEmphasis 재귀 파서 — **굵게**·__밑줄__·{{강조|빨강}}·{{안내|파랑}} 중첩 렌더.
색은 시맨틱 토큰→디자인 토큰 클래스(다크모드 안전). negodata tokens.css 에 --info 신설. CardTable 미리보기 적용.
- supplier_items 연동: 유통코드=supplier_items.supply_type(→quotations.supplier_type 폴백),
파트너유형=상품별 매핑 협력사 수(→세션 이력 폴백).
- 가격 수용률: 기존 공급가(item_price) 기준 양보율로 정정 — 첫 라운드부터 실값(첫 제시가 기준 0 아님).
테스트: agent 86/86, 공급사 frontend·negodata front tsc 통과.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- gmodel: ErrorInfo(success/code/desc) + Res_WebPacketProtocol(result/msg)
에 description 추가 → 모든 Res_* 응답의 공통 봉투가 Swagger 에 채워짐.
- router: /healthz 에 summary/description 추가(유일하게 설명 없던 오퍼레이션).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- protocol: ChatSummary 전 필드 + ChatMessage/Res_ChatInit/Res_ChatSend 의
빈 Field 에 description 추가. 혼동되던 두 배송 필드를 조립 코드 기준으로
구분 명시(item_delivery_type=상품 기본 폴백 / delivery_type=배송형태선택 결과).
- chat.py: session_id 경로 파라미터에 Path(description=...) 추가.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- negotiation_locustfile: 공급사 브라우징(list/chat init·messages) +
참여/거부 부하. reject 는 1회성이라 소비 전용 REJECT 풀(큐),
participate 는 IN_PROGRESS no-op 이라 재사용 READ 풀. 시드 세션마다
chat 오프닝 행을 심어 agent 호출 회피. catch_response 로 result.success 검증.
- run_local_locust.sh:
· 단일 파일 자동 선택(불필요한 프롬프트 생략) + 다중 시 입력 검증
· .venv 존재 확인, glob 수집, psql 에러 노출(2>/dev/null 제거)
· negotiation 선택 시 세션 풀(CTE+generate_series) 시딩 → 풀 파일 전달
· LOAD_READ_POOL / LOAD_REJECT_POOL 로 풀 크기 조절
검증: 10 users·20s 헤드리스에서 전 엔드포인트 0% 실패, agent 무호출 확인.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
KT-NEGOWIZ fe_v2 의 서비스 안내 팝업을 우리 구조로 이식.
- frontend: GuideContent(공용 본문, VAT/배송비는 chat init 메타로 동적 표시)
+ ServiceInfoPopup(채팅 진입 시 자동 — 안내 보지 않기/오늘 하루 보지 않기)
+ ServiceGuidePopup(메뉴 유의사항·이용 가이드 버튼 수동 — X/배경/ESC 닫기)
+ useServiceInfoPopup 훅(서버 상태 + localStorage 오늘 하루)
+ apis/auth 에 popupStatus 쿼리·hidePopup 뮤테이션, 헬프데스크 연락처 반영,
한국어 단어 잘림 방지(break-keep)
- backend: GET /v1/auth/popup/status, POST /v1/auth/popup/hide
(authenticate 공통 인증 + supplier_users.hide_service_info 영구 저장), 테스트 4건
- db: supplier_users.hide_service_info 컬럼 — 00-init 테이블 정의 갱신,
기존 DB 보정은 alters/2026-07-07-supplier-users-hide-service-info.sql 별도 파일
(기준선 이후 보정 ALTER 는 alters/ 파일로 관리하도록 규칙 변경)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 프론트: 채팅 반응형 레이아웃(~1024px)·정렬 보정, 협상 종료 캐시 무효화, 완료세션 재진입 검증 생략, 목록 테이블 레이아웃 정리
- DB: postgres-init 를 00-init.sql(스키마 전체+기존 DB 보정 ALTER) + temp-data.sql(시드) 2파일로 통합, 구 01~05 폐기
- 카드: script TEXT + tone·strategy_type 컬럼, 협상 카드 시드(일반 11장·와일드 5장, 변수 9종 체계)
- 문서: ENUM_TYPE.md 코드값 조견표 신설
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- ENUM_TYPE.md: SQL 코드값 16종 정리(값/코드명/의미/사용 컬럼), 진실 원천=각 서비스 enums.py 명시
- UserRole 값 2 서비스별 상이(OWNER/MANAGER)는 의도된 설계로 기재
- CardTone·CardStrategyType 앱 enum 미정의 표시, CardStatus 는 API 전용(available 매핑) 각주
- 00-init.sql 말미에 기존 DB 보정 섹션 신설(구 04-alter 역할): 카드 script TEXT + tone·strategy_type
멱등 ALTER — 기존 DB 재실행 시 최신 스키마로 보정, 신규 DB 는 no-op
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 00-init.sql: 구 01(도메인)+02(learning)+05(anchoring) 통합, 구 04(누적 ALTER)는 01에 기반영되어 폐기
- temp-data.sql: 구 03 시드 + 협상 카드 시드(일반 11장·와일드 5장, 멱등 가드, available=TRUE)
- card 테이블: script TEXT 전환 + tone·strategy_type 컬럼 추가, 카드 변수 9종 체계 문서화
- 참조 갱신: 루트 README·docker-compose 주석, schedules/anchoring conftest(00-init 적용)·README·문서
- anchoring 테스트 20건 통과, 신규 DB 초기화·멱등성 검증 완료
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- table-fixed 를 내용 기반 자동 레이아웃으로 전환, 셀의 overflow-hidden·text-ellipsis 제거
- 셀 내용이 잘리는 대신 컬럼 폭이 내용에 맞게 조정되도록 (whitespace-nowrap 은 유지)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- DONE 세션의 participate 는 결과 열람용 재진입(무변경)이므로 견적마감(NEGO_QUOTATION_CLOSED)·마감시간 검증을 건너뛴다
- reject 는 blocked_statuses 로 DONE 을 이미 차단하므로 이 분기는 participate 에만 적용
- 테스트: 견적마감+마감시간 경과 상태에서도 완료 세션 참여 성공, 세션·견적 상태 무변경 검증
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- send 응답에서 종료 전이(session_status ≠ 협상중 또는 chat_end) 감지 시 sessions·init 캐시 무효화
- 마감/종료/권한 에러로 목록 복귀할 때도 동일하게 무효화
- /list 복귀 시 staleTime(60s) 과 무관하게 항상 최신 상태 표시, 종료 세션 재진입 시 인디케이터 숨김 즉시 적용
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 반응형: 최소 폭 1350→1024px, max-[1350px]/max-[1180px] 2단계 축소
- 사이드바 350→310→280, 우측 메뉴 360→320→280, 채팅 거터 140/126→80/72→48/40 (헤더 패딩 동기)
- 가격·할인율 입력 min-w 480→420→320, 가운데 버튼 패딩·최소폭 축소, 상품목록 버튼 1180px 미만 아이콘만
- 상품 이미지 220→200, 사이드바 정보 행 값 영역 고정 150px → flex-1
- 리드타임: formatLeadTime 헬퍼 신설 — 좌측 상품정보·협상 결과 요약 카드에 "일" 접미 표시
- 인디케이터: init 의 session_status 를 스토어에 적재, 협상중(IN_PROGRESS) 세션에서만 표시
- 사이드바 정보 영역 의미 없는 가로 스크롤 제거 (shrink 금지 컬럼 + overflow-x 자동 계산이 원인)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 상품목록 버튼 래퍼에 pr-[16px] 추가 — 채팅 스크롤바 오른쪽 끝과 정렬
- 상단 pt-[64px] 를 스크롤 컨테이너 안쪽으로 이동 — 첫 메시지는 협상절차 카드와 높이 유지, 스크롤 시 여백 없이 맨 위까지 표시
- chat-scroll 스크롤바 트랙에 margin-top 64px — 스크롤바 시작 높이를 협상절차 카드 상단과 일치
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- config.py: APP_ENV(기본 local) 기반 config.{APP_ENV}.toml 로드 — backend/negodata 와 동일 관례
- dev/prod 는 파일 부재 시 기동 즉시 중단(FileNotFoundError) — 오타·미배치 상태로
코드 기본값(로컬 DB)에 붙는 무증상 사고 방지. local 만 파일 없이 기본값 허용(개발 편의)
- main 기동 로그에 APP_ENV·설정 파일 명시
- 루트 compose: anchoring 서비스에 APP_ENV=local + config.local.toml 마운트
- config.toml.example 을 3환경 공용 템플릿으로 갱신, .gitignore 에 config.*.toml
(env별 실파일은 gitignore — dev/prod 는 배포 시 CHANGE_ME 채움)
- TODO.md 삭제(주요 과제 전부 종결) + README·개발용.md 참조 정리
- 검증: 모듈 20 테스트 통과, APP_ENV=staging fail-fast(exit 1)·local dry-run 기동 확인
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Dockerfile 의 COPY config.toml* 제거: 실 시크릿이 이미지 레이어에 구워지는 문제 해소
- .dockerignore 신설로 빌드 컨텍스트에서도 config.toml 차단(이중 방어)
- docker-compose 가 ./config.toml 을 읽기 전용 마운트 — up 전에 파일이 있어야 함
(없으면 docker 가 디렉터리를 생성해 기동 실패 — 주석·런북에 명시)
- 설정 변경 반영이 리빌드 없이 restart 로 단순화
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 인수인계.md §1 에 적용 완료 블록(이식 위치·무Redis 계약·검증 결과·전환기 점프
확인 결과) 추가, 적용 순서 ③ 쿼리 컬럼명 오류 수정(anchor_rate_after →
뷰 실제 컬럼 anchor_rate_permille)
- 개발용.md §7(Redis)·§9.1 과 README 경계표의 "negodata 가 Redis 참조" 서술을
실제 적용 상태(current_rates 뷰 직조회)로 보정 — Redis 사용 주체는 배치만 남음
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- common/anchoring 이식 패키지 신설: 원본(schedules/anchoring)에서 읽기 경로 발췌
(constants·base_table·service) + reader 이식판(Redis 미사용 — current_rates 뷰
단일 쿼리, 실패·무이력 시 정적 테이블 폴백으로 견적 생성 무중단)
- _build_quotation: 목표가 산정과 앵커 산출 분리 — 칸(items.company_id ×
quotations.supplier_type × 가격구간) rate 로 tp*(1000-rate)//1000 정수 박제,
anchor_rate_permille 동시 기록. quotation_settings.anchoring_value 계산 사용 중단
- 재생성(regenerate_next_round): target_price 만 상속, 앵커는 생성 시점 rate 재계산
(인수인계 규칙 1 — 상속 폐지)
- sessions 모델 anchor_rate_permille 매핑, crud get_item_companies 신설
- 테스트 6종 신설(스키마 부재 폴백·칸별 조정 반영·유형 미지정·재생성 재계산·
bracket 경계 골든 벡터) — 전체 스위트 50 통과
- negodata 담당자 승인 하 직접 적용. 6개월 압축 시뮬레이션(격주 배치 13회,
세션 522건)으로 박제→소비→재박제 루프·클램프·이월·이중소비 방지 검증 완료
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- 04-alter 에 quotations.close_reason · quotation_settings.mid_action/over_action/regen_limit ALTER 누락분 append. 기존 DB 마이그레이션이 close_reason 개편을 안 담고 있어 UndefinedColumn 나던 것 보정(멱등 IF NOT EXISTS).
- postgres-init/01-schema.sql·04-alter.sql → *_20260702.sql 로 rename(스키마 최종 변경일 = 파일명). 사람들이 DB 최신 여부를 파일명으로 판단.
- 주석·문서 참조(README·docker-compose·02-learning·agent models·anchoring doc)는 글롭 01-schema*.sql·04-alter*.sql 로 바꿔 다음 rename 때 수정 불필요.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
종합 피드백에서 남긴 마지막 개선 3종:
- --once --dry-run: 판정·예상 조정(조정예정 라인)·제외 예정 건수를 로그로만
보고 DB/Redis 를 일절 변경하지 않는 예행 연습 — 첫 운영 실행(레거시 전량
판정·마킹) 전에 규모를 눈으로 확인하는 안전장치. status=dry_run, 종료코드 0
- 박제 정합 감시: 스캔 시 정수식 tp×(1000−rate)//1000 과 박제 anchor 를 대조,
불일치 시 WARN + 요약에 snapshot_mismatch — negodata 이식 오류(float 잔재·
칸 해석 오류)를 적용 첫 주에 자동 감지. 전환기(rate 미박제)엔 자동 스킵
- 전환기 점프 절차화: 인수인계 적용 순서에 "negodata 적용 직전 current_rates
분포 확인 → 점프 감수/이력 리셋 정책 결정" 단계 삽입 + TODO 등재
테스트 2종 추가(dry-run 무변경·정합 WARN) — 모듈 20개·backend 57개 통과.
리허설 완료: dry-run 예상과 실제 실행 결과 일치 확인(제외 3·조정 1칸 10‰→30‰).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
모듈·backend·문서 3개 관점의 적대 리뷰에서 확인된 결함 일괄 수정:
[모듈]
- 배치에 company_ids 스코프 옵션 추가 — 통합 테스트가 공유 dev DB 의 실세션을
소비/마킹하던 문제 해소(테스트는 시드 회사로 한정), 표적 수동 실행 옵션 겸용
- Redis 방어: compose 포트를 127.0.0.1 바인딩(무인증 공개 차단), get_rate 에
범위([10,200]) 검증 — 오염 캐시값은 미스 취급 후 자가 교정, 미스 백필은 SET NX
(배치가 방금 쓴 새 값을 구값으로 덮는 write-after-read 경합 방지)
- 배치: Redis ping 후 re-SET(다운 시 셀×timeout 지연 없이 즉시 스킵), 스캔 조인
ON 절에 quotations/items deleted 필터(철회 거래를 학습에서 배제), 제외 마킹을
청크별 커밋(레거시 대량 첫 실행의 장시간 단일 트랜잭션 방지)
- main: SIGTERM/SIGINT 핸들러(docker stop 시 정리 로직 보장), --once 부분 실패 시
종료코드 1(런북/cron 감지 가능)
[backend]
- finalize_session·update_last_offered_price 에 status=IN_PROGRESS 가드 —
negodata 일괄마감/중복 전송 경합이 종료된 세션을 되살리거나 가격 흔적을
사후 변경하는 것 차단(파생 판정 결정성 보호)
- 신규 DB 부트스트랩: sessions 3컬럼을 postgres-init/01-schema·04-alter 에도
반영(backend 가 모듈 DDL 없이 기동) — anchoring 스키마 자체는 모듈 소유 유지
- 낡은 주석 정리(agent_client·quotation_settings 의 구 앵커 산출 서술)
[테스트·문서]
- 신규 테스트: 격주 게이트 골든(ISO 주차), supplier_type NULL, 가격 제시율 0%
WARN — 모듈 18개·backend 57개 통과
- 문서 정합 감사 20건 반영: 잔존 33,334/노출 문구 제거, §10 SQL 을 실제 코드
(LEFT JOIN+deleted)와 일치, §11 자동/수동 검증 구분, FastAPI 오기 제거,
인수인계 reader 시그니처(db 인자), TODO 백로그 5건 기록
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
DB 과설정 점검에서 발견: 기존 술어(adjustment_id IS NULL AND deleted=false)로는
배치가 마킹하지 않는 비재협상 세션(재견적 등)이 인덱스에 영구 잔류해, "이월 풀만
담는 소형 인덱스" 의도와 달리 전체 세션 수에 비례해 성장하고 sessions 쓰기마다
유지 비용을 냈다. qt_type=1 을 술어에 포함해 재협상 미처리분만 남도록 수정
(키 컬럼도 status 단독으로 축소). dev DB 재생성 적용, 문서 동기화.
점검 결과 그 외 객체(테이블 1·컬럼·인덱스 1·뷰 2)는 과설정 없음으로 판정.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
요구(회사별 앵커링 값 업데이트 리스트업 + 이전 값 판별)는 rate_adjustments
한 행에 anchor_rate_before→after 가 박제되어 이미 충족 — 신규 테이블은 동일
정보의 사본만 만들므로 기각하고, 조회를 제품화하는 파생 뷰로 해결:
- anchoring.rate_history: 값 변경 이력 리스트업(이전→새 값, delta_permille,
success_rate, created_at)
- anchoring.current_rates: 칸별 현재값(최신 조정 행 — 없는 칸 = 시작값 10‰)
뷰는 상태가 없어 오염·재구축 이슈 자체가 없고 append-only 보호 대상 아님.
통합 테스트에 뷰 검증 추가(이력 before/after·성공률, 현재값). 운영 문서 §8
쿼리를 뷰 기반으로 단순화, TODO 과제 2 종결(대시보드 페이징 요구 시 스냅샷
테이블 승격 재검토 명시).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
