Commit Graph

447 Commits

Author SHA1 Message Date
김보곤
fc97dfe454 revert: CLAUDE.md DB 마이그레이션 정책 원래대로 복원 2026-02-27 09:30:10 +09:00
bcb8bb26b3 docs: [검사문서] 리뷰 정책 결정 16건 전체 완료
CRITICAL (5건):
- C1: row_index=개소 통일, 구성품은 field_key 인코딩
- C2: EAV 전환, options 경로 병행 유지
- C3: TemplateInspectionContent 통합 방향
- C4: 현행 유지 → BOM 동적화 시 스냅샷+식별자 병행
- C5: product_code 전파 누락 버그 수정

IMPORTANT (7건):
- I1: DEFAULT_GAP_PROFILES 기준 통일
- I2: lockForUpdate + transaction 추가
- I3: 3관점(구성품/개소/수주) 지원, 주 입력=구성품별
- I4: 기각 — 템플릿 유무로 롤백 이미 가능
- I5: inspection-config API (공정 자동 판별)
- I6: 누락 테스트 케이스 구현 시 반영
- I7: 입력=개소별, 출력=수주별 읽기전용 뷰

MINOR (4건): M1~M4 모두 결정

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:26:26 +09:00
김보곤
0ae6eec973 docs: CLAUDE.md DB 마이그레이션 정책 변경 (MNG 허용) 2026-02-27 09:24:17 +09:00
김보곤
d24a19a3f1 docs: [esign] 전자계약 알림톡/SMS 환경별 설정 가이드 작성
- esign-notification-guide.md 신규 작성 (환경별 설정, 역할 기반 알림, 템플릿 분기)
- README.md 현황 업데이트 (완료 템플릿, OTP SMS, 환경별 분기 반영)
- INDEX.md에 새 문서 등록
2026-02-27 08:26:14 +09:00
28b69e5449 docs: archive 37개 + COMPLETED 3개 복원 - 향후 docs/ 정식 문서화 시 참조용
- 완료 문서의 상세 내용은 추후 docs/ 구조화 시 정식 문서에 반영 예정
- HISTORY.md는 요약 인덱스로 유지, 개별 파일은 상세 참조용 보관

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 22:32:20 +09:00
730266f069 docs: plans 폴더 정리 - 53개 문서 삭제/통합, 가이드 및 히스토리 신규
- 5단계 분류(ACTIVE/PLANNED/SUPERSEDED/COMPLETED/OBSOLETE) 기반 정리
- SUPERSEDED 4개: 최신 문서에 대체 확인 후 삭제
- COMPLETED 3개: HISTORY.md에 요약 후 삭제
- OBSOLETE 1개: 일회성 핫픽스 이력 삭제
- archive/ 37개 개별 파일 → HISTORY.md 1파일로 통합 (40건 요약)
- sub/ 7개 + clodeCheck/ 7개 폴더 삭제
- GUIDE.md 신규: 문서 관리 최소 원칙 6개 (명명규칙, 필수섹션, 상태표기, 생명주기, 폴더구조, 인덱스관리)
- index_plans.md 재작성: ACTIVE 18개 + PLANNED 19개만 도메인별 그룹핑
- 정리 계획 문서(docs-plans-cleanup-plan.md) 포함

Before: 95파일 → After: 42파일 (56% 감소)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 22:32:20 +09:00
김보곤
73f7811da3 docs: [leave] 휴가관리 모듈 개발 계획서 작성
- Phase 1: 기본 휴가관리 (신청/승인/잔여연차/사용현황)
- Phase 2: 연차 정책 및 자동 계산 (근로기준법 기반)
- Phase 3: 연차 촉진, 알림, 리포트
- 기존 API 테이블 4개 활용
- 근태현황 vacation 기능 분리 전략 포함
2026-02-26 22:07:36 +09:00
김보곤
6b2d990d6a docs: [hr] 근태관리 기획서 작성
- 화면 구성, 데이터 구조, 비즈니스 규칙, API 엔드포인트 정리
- 1차 구현 완료 12건, 2차 고도화 예정 8건 목록
- INDEX.md에 문서 등록
2026-02-26 20:36:00 +09:00
김보곤
34f9cf41e7 docs: [barobill-kakaotalk] 알림톡 연동 완료 문서화 (트러블슈팅, v2 템플릿 가이드) 2026-02-26 20:36:00 +09:00
김보곤
95bbc90f93 docs: [guides] .env 동기화 문서 업데이트
- API 키 관리 방식 변경 반영 (DB → .env 전환)
- 공유 API 키 동기화 항목 추가 (Gemini, Vertex AI 등)
- .env.example 참조 안내 추가
- 누락 항목 현황 최신화
2026-02-26 20:36:00 +09:00
김보곤
f4ae2ee53a docs: [plans] ERP 스토리보드 D1.4 마크다운 변환 2026-02-26 20:36:00 +09:00
김보곤
113bf826ee docs: [plans] SAM ERP 스토리보드 D1.4 마크다운 변환
- 167페이지 PDF에서 추출한 원본 텍스트를 구조화된 마크다운으로 변환
- 14개 섹션, 146개 화면, 4개 플로우차트 포함
- UI 목업 노이즈 제거 및 Description 내용 보존
- INDEX.md에 문서 등록
2026-02-26 20:36:00 +09:00
김보곤
920d83c27a docs: [plans] ERP 회계관리 스토리보드 D1.6 마크다운 변환 문서 추가
- 65페이지 PDF를 AI 참조용 마크다운으로 변환
- 대시보드, 회계관리(7개 화면), 기준정보(5개 화면) 전체 수록
- 이관 기초자료 CSV 스펙 4종(거래처/거래내역/계좌내역/세금계산서) 포함
- INDEX.md에 plans/ 섹션 추가
2026-02-26 20:36:00 +09:00
김보곤
52720952ea docs: [architecture] SAM 10,000 테넌트 스케일링 로드맵 추가
- 5단계 로드맵: 캐시→수평확장→마이크로서비스→샤딩→엔터프라이즈
- SAM 특수 고려사항: tenant_id 샤딩, 권한 캐싱, 219개 테이블 분류
- INDEX.md에 문서 항목 추가
2026-02-26 20:36:00 +09:00
김보곤
472f6a1b44 docs: [guides] 서버 인프라 학습 시리즈 통합 PPTX 추가 2026-02-26 20:36:00 +09:00
김보곤
d2b4264b13 docs: [guides] 서버 인프라 학습 시리즈 연결
- 3개 가이드에 시리즈 배너 추가 (Part 1/2/3)
- 관련 문서 섹션에 시리즈 네비게이션 추가
- INDEX.md에 시리즈 순서 반영
2026-02-26 20:36:00 +09:00
김보곤
bb28e68847 docs: [guides] Nginx & FastCGI 초보자 가이드 추가
- Nginx 개념 (웹서버, 리버스 프록시, SSL 종료)
- FastCGI 프로토콜 (CGI→FastCGI 발전, 바이너리 프로토콜)
- nginx.conf 설정 해부 (try_files, fastcgi_pass, SCRIPT_FILENAME)
- SAM 2계층 Nginx 구조 및 도메인별 라우팅
- FastCGI vs HTTP 프록시 비교
- PPTX 프레젠테이션 포함
2026-02-26 20:36:00 +09:00
김보곤
07fb6bb535 docs: [guides] PHP-FPM 초보자 가이드 PPTX 추가 2026-02-26 20:36:00 +09:00
김보곤
d406e54fcf docs: [guides] PHP-FPM 초보자 가이드 추가
- PHP-FPM 개념, 역사(CGI→mod_php→PHP-FPM), 구조 설명
- Nginx-PHP-FPM 관계 및 FastCGI 프로토콜
- SAM 컨테이너별 설정(www.conf) 상세
- 자주 묻는 질문 (502 에러, 워커 부족, 재시작 등)
2026-02-26 20:36:00 +09:00
김보곤
86ea901de0 docs: [guides] Jenkins 셋업 가이드 작성
- Jenkins 이해하기 (용어, CI/CD 개념)
- 사전 준비 (Swap, Java, 방화벽)
- 설치 및 초기 설정
- 필수 플러그인 설치
- Credential 설정 (SSH, Gitea, Slack)
- Gitea Webhook 연동
- Jenkinsfile 작성 가이드
- 트러블슈팅 & FAQ
2026-02-26 20:36:00 +09:00
김보곤
c726e0852e docs: [plans] 운영 환경 배포 계획서 작성
- 12개 섹션 구성: 환경 전략, 서버 아키텍처, CI/CD, DB, 보안 등
- Jenkins CI/CD 파이프라인 설계 (4개 저장소)
- 단계별 마이그레이션 체크리스트 (Phase 1~4)
- INDEX.md에 문서 등록
2026-02-26 20:36:00 +09:00
김보곤
3847483090 docs: CLAUDE.md 전역 설정 추가
- PPT 제작 규칙 (회사명, BI 로고, 금지 사항)
- Git 커밋/푸시 정책, 서버 접근 금지 등 전역 규칙
2026-02-26 20:36:00 +09:00
김보곤
ac35c5c0f9 docs: [attendance] MNG 근태현황 개발 계획서 작성
- Phase 1: 버그 수정, 엑셀 다운로드, 일괄 삭제, 통계 기간 선택
- Phase 2: 개인별 상세, 출퇴근 설정, 월간/주간 요약, 일괄 등록
2026-02-26 20:32:43 +09:00
94d65b8211 docs:E-Sign TCPDF 폰트 정의 파일 오류 트러블슈팅 추가
- TCPDF font definition file 오류 원인/진단/해결 문서화
- 개발 vs 운영 환경 차이 (vendor 권한) 비교표 추가
- registerKoreanFont() 코드 수정 배경 설명
- 긴급 임시 조치 명령어 포함
2026-02-26 15:47:49 +09:00
dbcfe65692 docs:MNG storage/logs 심링크 변경 및 E-Sign PDF 트러블슈팅 추가
- 05-deployment: MNG Jenkinsfile/수동배포 storage/logs 심링크 방식 반영
- 08-troubleshooting: 전자계약 PDF 서명 합성 오류 진단/조치 가이드 추가
- 08-troubleshooting: MNG 500 에러 섹션 로그 경로 shared로 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 14:39:50 +09:00
김보곤
fd60e51ac9 docs: CLAUDE.md 운영서버 SSH 접근 불가 정책 추가 2026-02-25 17:10:18 +09:00
김보곤
dd3b045c46 docs: CLAUDE.md 운영서버 푸시를 cherry-pick 방식으로 변경 2026-02-25 17:01:36 +09:00
김보곤
62fdc6869b docs: CLAUDE.md MNG 운영 브랜치 master→main 통일 2026-02-25 15:46:03 +09:00
김보곤
d44b99d5e4 docs: CLAUDE.md 푸시 정책 트리거 워드 기반으로 개편
- "개발서버 푸시" / "운영서버 푸시" 트리거 워드 추가
- 운영서버 푸시 시 main 최신화 → merge → push → develop 동기화 절차 명시
- 브랜치 동기화 규칙 추가 (충돌 방지)
- 푸시 대상 자동 판별 규칙 추가
2026-02-25 15:36:58 +09:00
dc8b3ae0c9 docs: 운영서버 SMTP 메일 설정 가이드 추가
- api/mng 프로젝트별 SMTP 설정 정보
- Google 앱 비밀번호 관리 주의사항
- 트러블슈팅 가이드 (535 인증 실패 등)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 13:41:18 +09:00
87482be2b1 docs: 운영서버 LibreOffice 및 폰트 설치 가이드 추가
- LibreOffice 24.2.7 헤드리스 문서 변환 설정
- Pretendard (9 웨이트), Nanum, Noto CJK 폰트 설치 정보
- 폰트 관리 명령어 및 추가 절차

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 13:37:01 +09:00
8a00a9ec7d docs: 배포 가이드 Jenkinsfile 코드 블록에 커밋 메시지 알림 반영
- 3개 Jenkinsfile(react, api, mng) 코드 블록 업데이트
- Checkout 단계: checkout scm → GIT_COMMIT_MSG 캡처 → slackSend 순서
- 모든 slackSend 메시지에 ${env.GIT_COMMIT_MSG} 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 12:54:42 +09:00
46c5e23972 docs:배포 가이드 현행화 — 동시빌드방지, 승인알림, 환경파일 변경 반영
- 전체 Jenkinsfile에 disableConcurrentBuilds() 반영
- react/api Production Approval에 #product_deploy Slack 알림 추가
- react 환경파일 .env.local → .env.production 변경 반영
- Slack 알림 채널 테이블 추가 (#product_infra, #product_deploy)
- 환경변수 파일 테이블 DEV_TOOLBAR 컬럼 추가
- 수동 배포 섹션 .env.production 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 11:37:03 +09:00
4d9a044243 docs:MNG 배포 문서 업데이트 — Jenkinsfile 권한 수정 반영
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 11:23:35 +09:00
a68a9ba098 docs:MNG 500 에러 진단 결과 반영 — php8.4-soap 설치, 로그 경로/권한 문서화
- 11-server-setup: PHP 확장 목록에 php8.4-soap 추가
- 02-daily-operations: MNG 로그 경로 수정 (shared → current, 심링크 아님)
- 03-service-prod: Redis 용도 정확하게 테이블로 정리 (캐시=redis, 세션=database)
- 05-deployment: MNG 배포 시 storage/logs 권한 경고 추가, 배포 후 확인에 MNG 로그 추가
- 08-troubleshooting: MNG 500 에러 트러블슈팅 사례 추가 (2026-02-25 실제 사례)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 10:48:23 +09:00
김보곤
007277d401 fix: [docs] MNG 개발서버 도메인 수정
- mng.dev.codebridge-x.com → admin.codebridge-x.com
- 도메인 스왑(48ef98e) 반영
2026-02-25 09:27:03 +09:00
김보곤
9c00447e18 docs: docs/CLAUDE.md 인프라 변경 동기화
- ~/CLAUDE.md와 동일한 인프라 정보 반영
- 기술 스택: Laravel 12 + PHP 8.4 + MySQL 8.0
- 서버 접속 정보: 개발/운영 2서버, Jenkins CI/CD
- React 빌드: Jenkins 자동화 + fallback 정책
- DB 환경 분리: samdb/sam_prod/sam_stat
- 실행 환경: 3-Tier 비교, 서버 구조도, 도메인 매핑
- 공동 개발: 브랜치 전략, 비상 수동 배포 절차
2026-02-25 06:20:58 +09:00
김보곤
bbe410150d docs: CLAUDE.md 인프라 변경 반영
- 기술 스택: Laravel 12 + PHP 8.4 + MySQL 8.0 업데이트
- 서버 접속 정보: 개발/운영 2서버 분리, Jenkins CI/CD 반영
- 배포 흐름: Jenkins 자동화 파이프라인 다이어그램 추가
- React 빌드: Jenkins 빌드 + fallback 정책으로 변경
- DB 아키텍처: 환경별 분리(samdb/sam_prod/sam_stat), --force 플래그
- 실행 환경: 3-Tier 환경 비교, 서버 구조도, 도메인 매핑 추가
- 공동 개발: 브랜치 전략(develop→개발, main→운영), 비상 수동 배포 절차
2026-02-25 06:16:21 +09:00
김보곤
b8a8ca5442 merge: origin/main sam-docs 저장소 통합
- Gitea sam-docs 원격 저장소 연결
- ops-manual, deploys, 운영 매뉴얼 문서 반영
- admin/mng 도메인 스왑 문서 포함
2026-02-25 05:56:58 +09:00
김보곤
8d6fd5aee6 docs: [business-card] 명함신청 기능 문서 추가
- features/business-card-request.md 생성 (테이블, 워크플로우, 화면 구성, API)
- INDEX.md에 문서 등록
2026-02-25 05:49:33 +09:00
7922745bea docs:ops-manual 누락 항목 보강 — DB 동기화, PM2, MySQL 업그레이드
- 10-backup-recovery: 개발→운영 DB 동기화 절차 추가
- 05-deployment: Jenkins env-files에 APP_ENV 컬럼 및 접두사 설명 추가
- 11-server-setup: 개발서버 PM2 설정, MySQL 8.0→8.4 업그레이드 절차 추가
- 11-server-setup: 개발서버 MySQL 버전 8.0.45→8.4.8 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 04:33:12 +09:00
cba43034ef docs:개발서버 MySQL 8.0→8.4 업그레이드 반영
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 00:55:58 +09:00
93803da56f docs:모니터링 문서에 개발서버(sam-dev) 추가 반영
- 아키텍처 다이어그램에 개발서버 라인 추가
- Prometheus 스크래핑 설정에 sam-dev job 반영
- 스크래핑 대상 추가 가이드에 node_exporter 설치, 방화벽 허용 절차 보강

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 00:51:29 +09:00
47586a2922 docs:CI/CD 서버 4vCPU 업그레이드 반영, 타이틀 접두사 설정 문서화
- CI/CD 서버 CPU 2 vCPU → 4 vCPU 업데이트
- 환경별 타이틀 접두사 ([L]/[D]) 설정 방법 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 00:37:24 +09:00
4610ae128b docs: ops-manual 배포 가이드 현행화
- 05-deployment.md: Jenkinsfile 코드블록 전체 현행화
  - React/API/MNG: slackSend + tokenCredentialId 추가
  - API/MNG: mkdir-p bootstrap/cache, storage/framework 추가
  - MNG: npm install --production=false → --prefer-offline
  - 수동배포 섹션: mkdir-p 추가, 단계 번호 재정렬
  - 빌드 실패 트러블슈팅: Laravel 디렉토리 누락 항목 추가
- 07-monitoring.md: Contact Point TODO → 실제 설정 완료 내용 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 23:53:56 +09:00
48ef98e20a docs:도메인 스왑 반영 — admin.codebridge-x.com ↔ mng.codebridge-x.com
운영: admin.codebridge-x.com → mng.codebridge-x.com
개발: mng.codebridge-x.com → admin.codebridge-x.com

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 22:40:20 +09:00
50899c6a0e docs:백업 자동화 문서 보강 — 크론 설정, sam_stage 동기화 절차 추가
- 10-backup-recovery.md: CI/CD 자동 백업 상세화 (스크립트, 크론, 복원 절차), sam→sam_stage 동기화 절차 신규
- 11-server-setup.md: CI/CD ⑪ 백업 자동화 설치 가이드, ⑫ 최종 점검 추가, PM2 stage 메모리 실제값 반영

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 22:14:32 +09:00
47fdf147c3 docs:ops-manual 서버 점검 결과 반영 — Grafana 알림, 개발서버 보안, 백업 설정
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 20:45:48 +09:00
801c9ddfd5 docs(DOC): Jenkins 보안 강화 — Java 21 업그레이드, CSP 활성화, 분산 빌드 설정
- Java 17 → 21 업그레이드 (17은 2026-03-31 지원 종료)
- CSP(Content Security Policy) JVM 옵션 추가
- Built-in Node executor 0으로 변경, local-agent 분산 빌드 구성
- 운영 매뉴얼 3개 파일 업데이트 (01, 04, 11)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 17:15:25 +09:00
김보곤
41b1e01ce4 refactor: [contracts] 영업파트너 위촉계약서(단체용)에서 관리자(3%) 역할 제거
- 용어 정의에서 관리자 항목 삭제
- 3.2 관리자의 역할 섹션 삭제, 3.3→3.2 번호 조정
- 수수료 비율 테이블에서 관리자 행 삭제
- 수수료 산정 예시 테이블에서 관리자 칼럼 삭제
- docx, md 동시 반영
2026-02-24 17:04:38 +09:00