Files
sam-docs/changes/20260319_db_codebridge_migration_and_fixes.md

3.3 KiB

DB 아키텍처 정리 + 손익계산서 수정

날짜: 2026-03-19 작업자: Claude Code

변경 개요

MNG 전용 테이블을 sam DB에서 codebridge DB로 이관하고, DB 관리 정책을 정립. 손익계산서 운영서버 매출액 미표시 버그 수정 및 월별 보기 세부내역 추가.

1. DB 아키텍처 정리

원칙 확립

  • sam DB = API가 관리하는 공용 비즈니스 데이터
  • codebridge DB = MNG(백오피스) 전용 테이블
  • MNG는 마이그레이션 파일을 생성하지 않고 API에서만 관리

pmis_* + daily_work_logs 테이블 이관

작업 내용
API 마이그레이션 생성 2026_03_19_200000_migrate_mng_tables_to_codebridge.php
codebridge DB에 생성 pmis_* 21개 + daily_work_logs 2개 = 23개 테이블
sam DB 기존 5개 테이블 데이터 복사 → 건수 검증 → 삭제 (안전 장치 포함)
MNG 모델 수정 23개 모델에 $connection = 'codebridge' 추가
MNG 마이그레이션 삭제 18개 파일 전체 삭제
validation 규칙 수정 exists:pmis_*exists:codebridge.pmis_* (4개 컨트롤러, 10곳)

CLAUDE.md 업데이트

  • MNG CLAUDE.md: DB 환경 분리 테이블 추가, MySQL 컨테이너 참조 제거
  • 전역 CLAUDE.md: DB 환경 6열 테이블, Docker 직접 연결 설명 추가, samdbsam 수정

2. 손익계산서 매출액 미표시 수정

원인

운영서버 홈택스 매출 전표가 41100 용역매출로 분개되어 있었으나, 이 계정코드의 sub_category가 NULL이라 손익계산서의 매출액 집계(sub_category = 'sales_revenue')에서 누락.

수정

운영서버 account_codes 테이블에서 41100 용역매출sub_categorysales_revenue로 업데이트.

UPDATE account_codes SET sub_category = 'sales_revenue'
WHERE tenant_id = 1 AND code = '41100';

3. 손익계산서 월별 보기 세부내역 추가

수정 전

월별 전체 보기 시 I.매출액, IV.판매비와관리비 등 합계만 표시.

수정 후

기간 보기와 동일하게 하위 계정과목(용역매출, 직원급여, 복리후생비 등) 세부내역 표시.

수정된 파일

프로젝트 파일 변경 내용
API database/migrations/2026_03_19_200000_migrate_mng_tables_to_codebridge.php codebridge 이관 마이그레이션
MNG app/Models/Juil/Pmis*.php (21개) $connection = 'codebridge' 추가
MNG app/Models/Finance/DailyWorkLog*.php (2개) $connection = 'codebridge' 추가
MNG database/migrations/*.php (18개) 전체 삭제
MNG app/Http/Controllers/Juil/Pmis*Controller.php (4개) validation exists 규칙 수정
MNG resources/views/finance/income-statement.blade.php 월별 전체보기 세부내역 추가
MNG CLAUDE.md DB 환경 분리 정보 업데이트

테스트 체크리스트

  • codebridge DB에 23개 테이블 생성 확인
  • sam DB에서 pmis_* 테이블 삭제 확인
  • PMIS 작업자 등록 500 에러 해결 (validation exists 수정)
  • 손익계산서 매출액 표시 확인 (운영서버)
  • 손익계산서 월별 보기 세부내역 표시 확인

관련 문서

  • docs/changes/20260319_esign_salary_year_regex_fix.md — 같은 날 전자계약 수정

최종 업데이트: 2026-03-19