# 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 직접 연결 설명 추가, `samdb` → `sam` 수정

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

### 원인

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

### 수정

운영서버 `account_codes` 테이블에서 `41100 용역매출`의 `sub_category`를 `sales_revenue`로 업데이트.

```sql
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 환경 분리 정보 업데이트 |

## 테스트 체크리스트

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

## 관련 문서

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

---

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