diff --git a/sam/docs/system/database/codebridge-separation.md b/sam/docs/system/database/codebridge-separation.md index 159e562..74a0874 100644 --- a/sam/docs/system/database/codebridge-separation.md +++ b/sam/docs/system/database/codebridge-separation.md @@ -2,7 +2,7 @@ > **작성일**: 2026-03-07 > **상태**: 로컬/개발 서버 적용 완료, 운영 서버 미적용 -> **최종 수정**: 2026-03-09 — API 사용 테이블 점검 완료, codebridge 이동 대상 100개 → 55개로 축소 +> **최종 수정**: 2026-03-09 — API 사용 테이블 점검 완료, codebridge 이동 대상 100개 → 59개로 축소, 개발 서버 samdb에서 59개 테이블 삭제 완료 --- @@ -17,9 +17,10 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 ### 1.2 핵심 원칙 -- 기존 samdb의 테이블은 **삭제하지 않는다** (복사만 수행) +- codebridge DB에 테이블을 복사한 후, samdb에서 해당 테이블을 **삭제**하여 실질적 분리 - MNG 모델에 `$connection = 'codebridge'`를 설정하여 읽기 대상 DB만 변경 - React/API 서비스에는 **영향 없음** +- 개발 서버: samdb에서 59개 테이블 삭제 완료 (백업: `/home/pro/backup/sam_backup_20260309.sql.gz`) ### 1.3 분리 기준 @@ -34,9 +35,10 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 --- -## 2. codebridge 테이블 목록 (55개) +## 2. codebridge 테이블 목록 (59개) > 2026-03-09 점검: API 프로젝트 전체 코드 조사를 통해 API에서 사용하는 22개 테이블을 제외함. 제외된 테이블은 [3절](#3-api-사용-테이블--samdb-유지-필수-22개) 참조. +> Equipment 하위 테이블 4개 추가 (FK 의존성으로 equipments와 동일 DB 필수). ### Admin (9) @@ -54,13 +56,13 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 ### DevTools (5) -| 테이블 | 설명 | -|--------|------| -| `api_bookmarks` | API 북마크 | -| `api_deprecations` | API 지원종료 관리 | -| `api_environments` | API 환경 설정 | -| `api_histories` | API 호출 이력 | -| `api_templates` | API 템플릿 | +| 테이블 | 설명 | 비고 | +|--------|------|------| +| `admin_api_bookmarks` | API 북마크 | 문서 기존명 `api_bookmarks` → 실제 테이블명 | +| `api_deprecations` | API 지원종료 관리 | | +| `api_environments` | API 환경 설정 | | +| `api_histories` | API 호출 이력 | | +| `api_templates` | API 템플릿 | | ### Sales (17) @@ -107,12 +109,18 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 > esign_contracts, esign_audit_logs, esign_sign_fields, esign_signers는 API에서 전자계약 기능으로 사용 중 → samdb 유지 -### Equipment (2) +### Equipment (6) | 테이블 | 설명 | |--------|------| | `equipments` | 설비 | | `equipment_processes` | 설비 공정 | +| `equipment_inspections` | 설비 점검 (FK → equipments) | +| `equipment_inspection_details` | 설비 점검 상세 (FK → equipment_inspections) | +| `equipment_inspection_templates` | 설비 점검 템플릿 (FK → equipments) | +| `equipment_repairs` | 설비 수리 (FK → equipments) | + +> Equipment 하위 4개 테이블은 `equipments`에 FK 의존하므로 반드시 동일 DB에 있어야 한다. ### HR (1) @@ -132,17 +140,17 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 ### 기타 (9) -| 테이블 | 설명 | -|--------|------| -| `biz_certs` | 사업자등록증 | -| `cm_songs` | R&D 곡 관리 | -| `construction_site_photos` | 시공 현장 사진 | -| `construction_site_photo_rows` | 시공 사진 행 | -| `meeting_logs` | 회의 로그 | -| `meeting_minutes` | 회의록 | -| `meeting_minute_segments` | 회의록 세그먼트 | -| `interview_knowledges` | 면접 지식 | -| `sales_records` | 매출 기록 | +| 테이블 | 설명 | 비고 | +|--------|------|------| +| `biz_cert` | 사업자등록증 | 문서 기존명 `biz_certs` → 실제 테이블명 (단수) | +| `cm_songs` | R&D 곡 관리 | | +| `construction_site_photos` | 시공 현장 사진 | | +| `construction_site_photo_rows` | 시공 사진 행 | | +| `admin_meeting_logs` | 회의 로그 | 문서 기존명 `meeting_logs` → 실제 테이블명 | +| `meeting_minutes` | 회의록 | | +| `meeting_minute_segments` | 회의록 세그먼트 | | +| `interview_knowledges` | 면접 지식 | | +| `sales_records` | 매출 기록 | | --- @@ -212,15 +220,24 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 ### 4.1 환경별 상태 -| 환경 | codebridge DB | 테이블 복사 | .env 설정 | MNG 모델 적용 | 상태 | -|------|:---:|:---:|:---:|:---:|------| -| **로컬 Docker** | O | 55개 | O | O (develop) | 정상 작동 | -| **개발 서버** | O | 55개 | O | O (develop) | 정상 작동 | -| **운영 서버** | X | X | X | X (revert) | 미적용 (기존 samdb 사용) | +| 환경 | codebridge DB | 테이블 복사 | samdb 삭제 | .env 설정 | MNG 모델 적용 | 상태 | +|------|:---:|:---:|:---:|:---:|:---:|------| +| **로컬 Docker** | O | 59개 | 미수행 | O | O (develop) | 정상 작동 | +| **개발 서버** | O | 59개 | **59개 삭제 완료** | O | O (develop) | 정상 작동 | +| **운영 서버** | X | X | X | X | X (revert) | 미적용 (기존 samdb 사용) | -> **2026-03-09 정리**: -> - `finance_*` 17개 + `barobill_companies` 1개: 마이그레이션 없이 수동 생성된 테이블 → 삭제 완료 -> - API 사용 테이블 22개: codebridge 이동 대상에서 제외 → samdb 유지 (MNG 모델의 `$connection = 'codebridge'` 제거 필요) +> **2026-03-09 작업 내역**: +> - API 사용 테이블 22개: codebridge 이동 대상에서 제외 → samdb 유지 +> - `finance_*` 17개 + `barobill_companies` 1개: codebridge에 없는 유령 테이블 → samdb에서만 삭제 +> - Equipment 하위 4개 테이블: FK 의존성으로 codebridge 이동 대상에 추가 (55→59개) +> - **개발 서버 samdb에서 59개 테이블 DROP 완료** (FOREIGN_KEY_CHECKS=0 사용) +> - 백업: `/home/pro/backup/sam_backup_20260309.sql.gz` (6.3MB) +> - 개발 서버 상태: samdb 276개 테이블, codebridge 101개 테이블 +> +> **테이블명 불일치 발견 (수정 완료)**: +> - `api_bookmarks` → 실제: `admin_api_bookmarks` +> - `meeting_logs` → 실제: `admin_meeting_logs` +> - `biz_certs` → 실제: `biz_cert` (단수형) ### 4.2 코드 변경 사항 @@ -244,7 +261,7 @@ SAM 프로젝트의 DB를 **서비스용**과 **내부 관리용**으로 분리 CODEBRIDGE_DB_DATABASE=codebridge ``` -**MNG 모델** — `$connection` 속성 추가 (codebridge 55개만): +**MNG 모델** — `$connection` 속성 추가 (codebridge 59개만): ```php class SalesPartner extends Model @@ -257,13 +274,33 @@ class SalesPartner extends Model > **주의**: API 사용 테이블 22개에 해당하는 MNG 모델은 `$connection = 'codebridge'`를 설정하지 않는다. 기본 samdb connection을 사용해야 API와 동일한 데이터를 참조한다. +### 4.3 samdb 테이블 삭제 절차 (개발 서버 완료) + +> Sales 테이블 그룹은 FK 상호 참조가 있어 `FOREIGN_KEY_CHECKS = 0`으로 일괄 삭제. + +```sql +-- FK 체크 비활성화 (Sales, Equipment 등 FK 체인 테이블) +SET FOREIGN_KEY_CHECKS = 0; + +-- 59개 테이블 DROP (codebridge에 복제 완료 확인 후) +DROP TABLE IF EXISTS admin_api_flows, admin_api_flow_runs, ...; + +SET FOREIGN_KEY_CHECKS = 1; +``` + +> **롤백**: 백업에서 특정 테이블만 복원 가능 +> ```bash +> gunzip < /home/pro/backup/sam_backup_20260309.sql.gz | mysql -u codebridge -p sam +> ``` + --- ## 5. 운영 서버 적용 절차 (미완료) > **전제**: 운영 서버 SSH 접근 + DB root 권한 필요 +> **코드는 이미 main에 배포 완료** — 운영 서버에 codebridge DB만 생성하면 즉시 적용됨 -### 순서 (반드시 1 → 2 → 3 순서로) +### 순서 (반드시 1 → 2 → 3 → 4 순서로) **1단계: codebridge DB 생성 + 테이블 복사** @@ -274,7 +311,7 @@ mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS codebridge CHARACTER SET utf8 # DB 계정 권한 부여 mysql -u root -p -e "GRANT ALL PRIVILEGES ON codebridge.* TO 'codebridge'@'localhost'; FLUSH PRIVILEGES;" -# sam에서 55개 테이블 구조+데이터 복사 (mysqldump → import) +# sam에서 59개 테이블 구조+데이터 복사 (mysqldump → import) mysqldump -u codebridge -p sam [테이블목록] | mysql -u codebridge -p codebridge ``` @@ -285,12 +322,22 @@ echo 'CODEBRIDGE_DB_DATABASE=codebridge' >> /home/webservice/mng/.env cd /home/webservice/mng && php artisan config:clear ``` -**3단계: 코드 배포 (main push)** +**3단계: MNG 웹 동작 확인** -MNG 코드(codebridge 55개 모델 `$connection` 변경)를 main에 cherry-pick + push. -Jenkins가 자동 배포. +codebridge connection이 활성화되므로 MNG 관리자 페이지에서 영업관리, 설비, 재무 등 주요 메뉴 동작 확인. -> **주의**: 3단계 전에 1, 2단계가 완료되어야 한다. DB가 없는 상태에서 코드를 배포하면 MNG 페이지 접속 불가. +**4단계: samdb에서 59개 테이블 삭제 (선택)** + +개발 서버에서 검증 완료 후, 운영 서버에서도 삭제하여 실질적 분리 완성. + +```sql +SET FOREIGN_KEY_CHECKS = 0; +DROP TABLE IF EXISTS [59개 테이블 목록]; +SET FOREIGN_KEY_CHECKS = 1; +``` + +> **주의**: 2단계 전에 1단계가 완료되어야 한다. DB가 없는 상태에서 .env를 설정하면 MNG 페이지 접속 불가. +> **코드 배포**: 이미 main에 59개 모델의 `$connection = 'codebridge'` 코드가 반영됨. .env에 `CODEBRIDGE_DB_DATABASE`가 없으면 기본값 'codebridge'가 사용되므로, DB가 존재하지 않으면 에러 발생. 반드시 1단계 먼저 완료할 것. --- @@ -313,7 +360,7 @@ Jenkins가 자동 배포. ┌─────┴─────┐ | | samdb codebridge - (공통 참조) (MNG 전용 55개) + (공통 참조) (MNG 전용 59개) ``` - **React → API → samdb**: 서비스 트래픽 (수주, 견적, 생산, 바로빌, 전자서명 등)