Compare commits
128 Commits
88726573bf
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ee1aaf183d | ||
|
|
c143c7e9f8 | ||
| 7a969b9d57 | |||
| cc38b00c11 | |||
| bfcd6178ea | |||
| 04e877dea3 | |||
| 85dc30bfcd | |||
|
|
e94123ad49 | ||
|
|
1f7bd13816 | ||
|
|
03ccd7ba93 | ||
|
|
ec3abc1a85 | ||
|
|
5000c67ec1 | ||
| 925ed82ae1 | |||
|
|
8f939d3609 | ||
|
|
2efe56df70 | ||
|
|
129332d4b1 | ||
|
|
4d13301ce0 | ||
|
|
7c9f7afb52 | ||
|
|
8e700fcd64 | ||
|
|
ba68e138e6 | ||
|
|
95b9efbcc5 | ||
|
|
2dc20952b2 | ||
|
|
428e77aa9b | ||
| 03850fefdd | |||
| cf189fd453 | |||
| b1472f3c35 | |||
| 5bfc89afa7 | |||
| f1683f753e | |||
|
|
5798058125 | ||
| 614e90066f | |||
| 8efe0ac477 | |||
| 303de36e1c | |||
| 334c8f3918 | |||
|
|
6d042f5bfd | ||
|
|
51446080db | ||
|
|
37bbab7cd4 | ||
|
|
29117d65d4 | ||
|
|
78cfc292a9 | ||
|
|
4f90c0e869 | ||
|
|
09793e629b | ||
| 0223c33fd9 | |||
| db63fcff85 | |||
| 7e1daca81b | |||
| a320c85e94 | |||
|
|
ee42b12c2b | ||
|
|
4c581ad7f5 | ||
|
|
52417acad6 | ||
|
|
8cb15cf3c4 | ||
|
|
a3c910d91b | ||
|
|
f8c4536331 | ||
|
|
23570d3ee9 | ||
|
|
b8fa244271 | ||
|
|
4c9fd233cc | ||
|
|
8769b68ef0 | ||
|
|
132c573ab9 | ||
|
|
415c55b7c0 | ||
|
|
66db1832da | ||
|
|
d5e6172c22 | ||
|
|
08577b5af9 | ||
|
|
7b45b4c635 | ||
|
|
1f06c1a607 | ||
|
|
00d7a583cb | ||
|
|
8be729c698 | ||
|
|
9c5443aec1 | ||
|
|
5d76705f4f | ||
|
|
b52c31a700 | ||
|
|
490477421d | ||
|
|
359dc5d029 | ||
|
|
0123c3d780 | ||
|
|
fc97dfe454 | ||
|
|
0ae6eec973 | ||
|
|
d24a19a3f1 | ||
|
|
ac35c5c0f9 | ||
|
|
fd60e51ac9 | ||
|
|
dd3b045c46 | ||
|
|
62fdc6869b | ||
|
|
d44b99d5e4 | ||
|
|
007277d401 | ||
|
|
9c00447e18 | ||
|
|
bbe410150d | ||
|
|
b8a8ca5442 | ||
|
|
8d6fd5aee6 | ||
|
|
41b1e01ce4 | ||
|
|
b8e249c6b3 | ||
|
|
5acac8f558 | ||
|
|
f98d287958 | ||
|
|
e9c7cd21cc | ||
|
|
0c923401bf | ||
|
|
73d25b99ec | ||
|
|
b7d1fb97b4 | ||
|
|
5957261ffa | ||
|
|
9660c58bf4 | ||
|
|
8601d1738e | ||
|
|
f0f4a8627d | ||
|
|
a0de29d5ec | ||
|
|
27e17bad48 | ||
|
|
98b01bf633 | ||
|
|
cd3b155cdc | ||
|
|
e4b875a69f | ||
|
|
92c5b3575d | ||
|
|
52e3f8e375 | ||
|
|
3013406100 | ||
|
|
96f25fc0eb | ||
|
|
d57b84c8f2 | ||
|
|
01eee88e40 | ||
|
|
bf6bbf92f7 | ||
|
|
24a542cb95 | ||
|
|
6fb6e4fdbe | ||
|
|
833a957d9e | ||
|
|
1a1ef04798 | ||
|
|
ccb93e3aca | ||
|
|
06e8d5f328 | ||
|
|
71654f5f63 | ||
|
|
03e12d8fe2 | ||
|
|
56fdf76f49 | ||
|
|
8278284e97 | ||
|
|
665e6b52a4 | ||
|
|
61f226be7f | ||
|
|
b1b6a83aef | ||
|
|
768ab68f13 | ||
|
|
017f492d70 | ||
|
|
24271cfef3 | ||
|
|
6ba8738b71 | ||
|
|
a8e5e2fba0 | ||
|
|
9a2948da6c | ||
|
|
89226629eb | ||
|
|
a28a4ef2f2 | ||
|
|
57b9a189a4 |
42
.gitignore
vendored
@@ -1 +1,43 @@
|
||||
# 모든 파일 무시
|
||||
*
|
||||
|
||||
# 추적할 파일만 허용
|
||||
!.gitignore
|
||||
!INDEX.md
|
||||
!README.md
|
||||
!resources.md
|
||||
|
||||
# 문서 폴더 (루트 기준)
|
||||
!assets/
|
||||
!assets/**
|
||||
!brochure/
|
||||
!brochure/**
|
||||
!changes/
|
||||
!changes/**
|
||||
!contracts/
|
||||
!contracts/**
|
||||
contracts/docx/backup/
|
||||
!data/
|
||||
!data/**
|
||||
!dev/
|
||||
!dev/**
|
||||
!features/
|
||||
!features/**
|
||||
!frontend/
|
||||
!frontend/**
|
||||
!guides/
|
||||
!guides/**
|
||||
!plans/
|
||||
!plans/**
|
||||
!projects/
|
||||
!projects/**
|
||||
!requests/
|
||||
!requests/**
|
||||
!rules/
|
||||
!rules/**
|
||||
!system/
|
||||
!system/**
|
||||
|
||||
# 기타
|
||||
.DS_Store
|
||||
_to_notion/
|
||||
|
||||
@@ -1,11 +0,0 @@
|
||||
# SAM Docs 작업 현황
|
||||
|
||||
> 모든 문서 정리 및 E2E 테스트 버그 수정 완료. 현재 활발한 작업 없음.
|
||||
|
||||
## 최근 커밋 이력 (참고용)
|
||||
|
||||
| 날짜 | 내용 |
|
||||
|------|------|
|
||||
| 2026-01-15 | E2E 테스트 버그 수정 완료 (Phase 1-3) |
|
||||
| 2025-12-26 | 문서 업데이트 및 정리 (Phase 1-4.5) |
|
||||
| 2025-12-22 | MNG 견적수식 관리 개발 계획 문서 작성 |
|
||||
454
INDEX.md
@@ -1,391 +1,213 @@
|
||||
# SAM 프로젝트 문서 인덱스
|
||||
# SAM 문서 인덱스 (Claude Code용)
|
||||
|
||||
> **Claude Code 작업 전 필수 확인** — 작업 유형에 맞는 문서를 먼저 읽고 시작하세요.
|
||||
> **최종 갱신**: 2026-02-27
|
||||
> 작업 유형에 맞는 문서를 먼저 읽고 시작하세요.
|
||||
> 최종 갱신: 2026-03-07
|
||||
|
||||
---
|
||||
|
||||
## 🎯 작업별 필수 문서
|
||||
## 작업별 필수 문서
|
||||
|
||||
| 작업 유형 | 필수 문서 | 용도 |
|
||||
|----------|----------|------|
|
||||
| **API 개발** | `standards/api-rules.md` | Service-First, FormRequest, i18n 규칙 |
|
||||
| **DB 변경** | `system/database/README.md` | 테이블 구조, 관계, 컬럼 규칙 |
|
||||
| **새 기능 구현** | `system/overview.md` | 전체 아키텍처 이해 |
|
||||
| **보안 관련** | `system/security-policy.md` | 인증/인가, 보안 규칙 |
|
||||
| **Git 커밋** | `standards/git-conventions.md` | 커밋 메시지, 브랜치 전략 |
|
||||
| **품질 검증** | `standards/quality-checklist.md` | 코드 품질 체크리스트 |
|
||||
| **Swagger 작성** | `guides/swagger-guide.md` | API 문서 작성 방법 |
|
||||
| **품목관리** | `rules/item-policy.md` | 품목 정책 (유형, 예약어, API 규칙) |
|
||||
| **단가관리** | `rules/pricing-policy.md` | 원가/판매가 계산, 리비전 관리 |
|
||||
| **견적관리** | `features/quotes/README.md` | 견적 시스템, BOM 계산, 10단계 로직 |
|
||||
| **운영 배포** | `plans/production-deployment-plan.md` | 운영 환경 배포 계획 |
|
||||
| **서버 운영** | `deploys/ops-manual/README.md` | 서버 운영 매뉴얼 |
|
||||
| **MES 개발** | `projects/mes/README.md` | MES 프로젝트 개요 |
|
||||
| API 개발 | `dev/standards/api-rules.md` | Service-First, FormRequest, i18n |
|
||||
| DB 변경 | `system/database/README.md` | 테이블 구조, 관계, 컬럼 규칙 |
|
||||
| 새 기능 | `system/overview.md` | 전체 아키텍처 |
|
||||
| 보안 | `system/security-policy.md` | 인증/인가, 보안 규칙 |
|
||||
| Git 커밋 | `dev/standards/git-conventions.md` | 커밋 메시지, 브랜치 전략 |
|
||||
| 품질 검증 | `dev/standards/quality-checklist.md` | 코드 품질 체크리스트 |
|
||||
| Swagger | `dev/guides/swagger-guide.md` | API 문서 작성법 |
|
||||
| 품목관리 | `rules/item-policy.md` | 품목 정책 |
|
||||
| 단가관리 | `rules/pricing-policy.md` | 원가/판매가, 리비전 |
|
||||
| 견적관리 | `features/quotes/README.md` | 견적 시스템, BOM 계산 |
|
||||
| 운영 배포 | `dev/dev_plans/production-deployment-plan.md` | 배포 계획 |
|
||||
| 서버 운영 | `dev/deploys/ops-manual/README.md` | 서버 운영 매뉴얼 |
|
||||
| 서버 접근/백업 | `system/server-access-management.md` | 계정, 권한, 백업, 리플리케이션 |
|
||||
| MES | `projects/mes/README.md` | MES 프로젝트 |
|
||||
|
||||
---
|
||||
|
||||
## 📁 폴더 구조
|
||||
## 폴더 구조
|
||||
|
||||
```
|
||||
docs/
|
||||
├── system/ # 시스템 현황 — 아키텍처, DB 스키마, 인프라 (architecture/ + specs/ 통합)
|
||||
├── standards/ # 개발 표준 — "어떻게 코드를 작성할 것인가"
|
||||
├── rules/ # 비즈니스 규칙 — "무엇이 유효한 데이터인가"
|
||||
├── features/ # 기능별 상세 — 도메인별 기능 문서
|
||||
├── guides/ # 구현 가이드 — "어떻게 구현할 것인가"
|
||||
├── quickstart/ # 빠른 시작 — 핵심 요약, 명령어
|
||||
├── plans/ # 작업 추적 — 예정 → 진행 → 완료 → archive/
|
||||
├── projects/ # 프로젝트 자료 — 프로젝트성 분석, 설계, 참고
|
||||
├── deploys/ # 운영 매뉴얼 — 서버 운영, 배포
|
||||
├── changes/ # 변경 이력
|
||||
├── data/ # 데이터 분석
|
||||
├── history/ # 히스토리 기록
|
||||
├── api/ # API 통합 문서
|
||||
├── requests/ # 요청/기획 문서
|
||||
└── assets/ # BI 등 정적 자산
|
||||
├── [공유]
|
||||
│ ├── features/ # 기능별 상세 명세
|
||||
│ ├── rules/ # 비즈니스 규칙·정책
|
||||
│ ├── projects/ # 프로젝트별 자료
|
||||
│ ├── system/ # 시스템 현황 (아키텍처, DB, 인프라)
|
||||
│
|
||||
├── [개발팀]
|
||||
│ ├── dev/standards/ # 개발 표준
|
||||
│ ├── dev/guides/ # 구현 가이드
|
||||
│ ├── dev/quickstart/ # 빠른 시작
|
||||
│ ├── dev/changes/ # 변경 이력
|
||||
│ ├── dev/deploys/ # 배포/운영
|
||||
│ ├── dev/data/ # 데이터 분석
|
||||
│ ├── dev/history/ # 과거 이력
|
||||
│ ├── dev/dev_plans/ # 개발 계획 (임시)
|
||||
│
|
||||
├── [프론트엔드]
|
||||
│ ├── frontend/api-specs/ # API 연동 명세
|
||||
│ ├── frontend/integration/ # 연동 가이드
|
||||
│
|
||||
├── [기획팀]
|
||||
│ ├── requests/ # 기획 요청
|
||||
│
|
||||
├── resources.md # 외부 자료 링크 (노션)
|
||||
├── README.md # 사람용 안내
|
||||
└── INDEX.md # 이 파일 (Claude Code용)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 폴더별 문서 목록
|
||||
## 폴더별 문서 목록
|
||||
|
||||
### system/ — 시스템 현황
|
||||
> 아키텍처, DB 스키마, 기술 스펙, 인프라 (기존 architecture/ + specs/ 통합)
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [overview.md](system/overview.md) | 전체 시스템 아키텍처 (api/react/mng 구조, 기술 스택) |
|
||||
| [api-structure.md](system/api-structure.md) | API 서버 구조 (~1,027 엔드포인트, 18 도메인) |
|
||||
| [react-structure.md](system/react-structure.md) | React 프론트엔드 구조 (249 페이지, 612 컴포넌트) |
|
||||
| [mng-structure.md](system/mng-structure.md) | MNG 관리자 패널 구조 (171 컨트롤러, 436 뷰) |
|
||||
| [docker-setup.md](system/docker-setup.md) | Docker 환경 + CI/CD (7 서비스, Jenkins) |
|
||||
| [database/README.md](system/database/README.md) | DB 스키마 인덱스 (220 모델, 32 도메인, 459 마이그레이션) |
|
||||
|
||||
**DB 도메인별 스키마:**
|
||||
|
||||
| 문서 | 포함 도메인 |
|
||||
|------|-----------|
|
||||
| [database/tenants.md](system/database/tenants.md) | 테넌트, 사용자, 권한 (63 모델) |
|
||||
| [database/products.md](system/database/products.md) | 제품, 품목, 설계 (21 모델) |
|
||||
| [database/sales.md](system/database/sales.md) | 영업, 수주, 견적 (18 모델) |
|
||||
| [database/production.md](system/database/production.md) | 생산, 시공, 자재, 품질 (20 모델) |
|
||||
| [database/finance.md](system/database/finance.md) | 재무, 회계 |
|
||||
| [database/hr.md](system/database/hr.md) | 인사, 면접 |
|
||||
| [database/documents.md](system/database/documents.md) | 문서, 전자서명 (19 모델) |
|
||||
| [database/commons.md](system/database/commons.md) | 공통, 게시판, 감사 (17 모델) |
|
||||
| [database/stats.md](system/database/stats.md) | 통계 (21 모델, sam_stat DB) |
|
||||
|
||||
**이관 완료 (architecture/ + specs/ → system/):**
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [security-policy.md](system/security-policy.md) | 보안 정책 (다층 방어, Sanctum, RBAC) |
|
||||
| [scaling-roadmap.md](system/scaling-roadmap.md) | 10K 테넌트 스케일링 로드맵 |
|
||||
| [board-system-spec.md](system/board-system-spec.md) | 게시판 시스템 설계 스펙 |
|
||||
| [overview.md](system/overview.md) | 전체 시스템 아키텍처 |
|
||||
| [api-structure.md](system/api-structure.md) | API 서버 구조 (~1,027 엔드포인트) |
|
||||
| [react-structure.md](system/react-structure.md) | React 프론트엔드 구조 |
|
||||
| [mng-structure.md](system/mng-structure.md) | MNG 관리자 패널 구조 |
|
||||
| [docker-setup.md](system/docker-setup.md) | Docker 환경 + CI/CD |
|
||||
| [database/README.md](system/database/README.md) | DB 스키마 인덱스 |
|
||||
| [security-policy.md](system/security-policy.md) | 보안 정책 |
|
||||
| [server-access-management.md](system/server-access-management.md) | 서버 접근 권한, 백업, 리플리케이션 |
|
||||
| [scaling-roadmap.md](system/scaling-roadmap.md) | 스케일링 로드맵 |
|
||||
| [board-system-spec.md](system/board-system-spec.md) | 게시판 시스템 설계 |
|
||||
| [item-master-integration.md](system/item-master-integration.md) | 품목 마스터 통합 설계 |
|
||||
| [remote-work-setup.md](system/remote-work-setup.md) | 원격 개발 설정 (DEPRECATED) |
|
||||
| [erp-analysis/](system/erp-analysis/) | ERP 스토리보드 분석 (9개 파일) |
|
||||
| [erp-analysis/](system/erp-analysis/) | ERP 스토리보드 분석 |
|
||||
|
||||
DB 도메인별:
|
||||
|
||||
| 문서 | 도메인 |
|
||||
|------|--------|
|
||||
| [database/tenants.md](system/database/tenants.md) | 테넌트, 사용자, 권한 |
|
||||
| [database/products.md](system/database/products.md) | 제품, 품목, 설계 |
|
||||
| [database/sales.md](system/database/sales.md) | 영업, 수주, 견적 |
|
||||
| [database/production.md](system/database/production.md) | 생산, 시공, 자재, 품질 |
|
||||
| [database/finance.md](system/database/finance.md) | 재무, 회계 |
|
||||
| [database/hr.md](system/database/hr.md) | 인사 |
|
||||
| [database/documents.md](system/database/documents.md) | 문서, 전자서명 |
|
||||
| [database/commons.md](system/database/commons.md) | 공통, 게시판, 감사 |
|
||||
| [database/stats.md](system/database/stats.md) | 통계 |
|
||||
|
||||
---
|
||||
|
||||
### standards/ — 개발 표준
|
||||
> 코딩 컨벤션, 스타일 가이드, 품질 기준
|
||||
### dev/standards/ — 개발 표준
|
||||
|
||||
| 문서 | 설명 | 필수 확인 시점 |
|
||||
|------|------|--------------|
|
||||
| [api-rules.md](standards/api-rules.md) | API 개발 규칙 (Service-First, FormRequest, i18n) | API 개발 전 |
|
||||
| [git-conventions.md](standards/git-conventions.md) | Git 커밋 메시지, 브랜치 전략 | 커밋 전 |
|
||||
| [quality-checklist.md](standards/quality-checklist.md) | 코드 품질 체크리스트 | PR 전 |
|
||||
| [pagination-policy.md](standards/pagination-policy.md) | 페이지네이션 표준 | 목록 API 구현 시 |
|
||||
| [options-column-policy.md](standards/options-column-policy.md) | JSON options 컬럼 표준 정책 (마이그레이션, 모델, 쿼리) | 테이블 생성/확장 시 |
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [api-rules.md](dev/standards/api-rules.md) | API 개발 규칙 |
|
||||
| [git-conventions.md](dev/standards/git-conventions.md) | Git 컨벤션 |
|
||||
| [quality-checklist.md](dev/standards/quality-checklist.md) | 품질 체크리스트 |
|
||||
| [pagination-policy.md](dev/standards/pagination-policy.md) | 페이지네이션 표준 |
|
||||
| [options-column-policy.md](dev/standards/options-column-policy.md) | JSON options 컬럼 정책 |
|
||||
|
||||
---
|
||||
|
||||
### rules/ — 비즈니스 규칙
|
||||
> 도메인 로직, 검증 규칙, 정책
|
||||
|
||||
| 문서 | 설명 | 필수 확인 시점 |
|
||||
|------|------|--------------|
|
||||
| [README.md](rules/README.md) | 비즈니스 규칙 개요 | 도메인 로직 구현 전 |
|
||||
| [item-policy.md](rules/item-policy.md) | 품목 정책 (유형, 예약어, API 규칙) | 품목 관련 작업 전 |
|
||||
| [pricing-policy.md](rules/pricing-policy.md) | 단가 정책 (원가/판매가, 리비전) | 단가 관련 작업 전 |
|
||||
| [customer-pricing.md](rules/customer-pricing.md) | 고객 안내용 서비스 요금표 | 고객 요금 안내 시 |
|
||||
| [partner-commission.md](rules/partner-commission.md) | 영업파트너 수당 체계 및 정산 | 수당/정산 관련 작업 전 |
|
||||
| [billing-policy.md](rules/billing-policy.md) | 내부용 원가/마진/코드참조 (CONFIDENTIAL) | 과금 코드 개발 전 |
|
||||
| [client-policy.md](rules/client-policy.md) | 고객사 관리 정책 | 고객 관련 작업 전 |
|
||||
| [attendance-api.md](rules/attendance-api.md) | 근태 API 규칙 | 근태 관련 작업 전 |
|
||||
| [department-tree-api.md](rules/department-tree-api.md) | 부서 트리 API 규칙 | 부서 관련 작업 전 |
|
||||
| [employee-api.md](rules/employee-api.md) | 직원 API 규칙 | 직원 관련 작업 전 |
|
||||
| [numbering-rules.md](rules/numbering-rules.md) | 채번규칙 (패턴 기반 자동 번호 생성) | 채번 로직 수정 전 |
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [item-policy.md](rules/item-policy.md) | 품목 정책 |
|
||||
| [pricing-policy.md](rules/pricing-policy.md) | 단가 정책 |
|
||||
| [numbering-rules.md](rules/numbering-rules.md) | 채번 규칙 |
|
||||
| [client-policy.md](rules/client-policy.md) | 고객사 관리 정책 |
|
||||
| [billing-policy.md](rules/billing-policy.md) | 과금 정책 (CONFIDENTIAL) |
|
||||
| [customer-pricing.md](rules/customer-pricing.md) | 고객 요금표 |
|
||||
| [partner-commission.md](rules/partner-commission.md) | 영업파트너 수당 체계 |
|
||||
| [attendance-api.md](rules/attendance-api.md) | 근태 API 규칙 |
|
||||
| [department-tree-api.md](rules/department-tree-api.md) | 부서 트리 API |
|
||||
| [employee-api.md](rules/employee-api.md) | 직원 API |
|
||||
|
||||
---
|
||||
|
||||
### features/ — 기능별 문서
|
||||
> 도메인별 기능 상세 (기능 설명 + 엔드포인트 경로 + Swagger 참조)
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [quotes/README.md](features/quotes/README.md) | 견적 시스템 (BOM 계산, 10단계 로직) |
|
||||
| [boards/README.md](features/boards/README.md) | 게시판 시스템 구현 |
|
||||
| [boards/mng-implementation.md](features/boards/mng-implementation.md) | MNG 게시판 구현 상세 |
|
||||
| [hr/attendance-management-spec.md](features/hr/attendance-management-spec.md) | 근태관리 기획서 |
|
||||
| [hr/hr-api-analysis.md](features/hr/hr-api-analysis.md) | HR API 분석 (근태/직원/부서) |
|
||||
| [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 + 세금계산서 연동 |
|
||||
| ~~business-card-request.md~~ | 명함신청 관리 (DB 마이그레이션만 존재, 문서 미작성) |
|
||||
| [sales/README.md](features/sales/README.md) | 영업 관리 (면접 시나리오 포함) |
|
||||
| [crm/README.md](features/crm/README.md) | CRM (거래처, 미수금, 미지급금) |
|
||||
| [finance/README.md](features/finance/README.md) | 재무 관리 (14개 하위 문서) |
|
||||
| [card-vehicle/README.md](features/card-vehicle/README.md) | 법인카드·차량 관리 |
|
||||
| [settlement/README.md](features/settlement/README.md) | 정산 관리 |
|
||||
| [esign/README.md](features/esign/README.md) | 전자서명 (계약·OTP·PDF 합성) |
|
||||
| [documents/README.md](features/documents/README.md) | 문서관리 (EAV 기반 서식·결재) |
|
||||
| [ai/README.md](features/ai/README.md) | AI 분석 리포트 (Gemini 연동) |
|
||||
| [equipment/README.md](features/equipment/README.md) | 설비관리 (MNG 전용) |
|
||||
| [quotes/README.md](features/quotes/README.md) | 견적 시스템 |
|
||||
| [sales/README.md](features/sales/README.md) | 영업 관리 |
|
||||
| [documents/README.md](features/documents/README.md) | 문서관리 |
|
||||
| [finance/README.md](features/finance/README.md) | 재무 관리 |
|
||||
| [hr/](features/hr/) | 인사관리 |
|
||||
| [crm/README.md](features/crm/README.md) | CRM |
|
||||
| [esign/README.md](features/esign/README.md) | 전자서명 |
|
||||
| [equipment/README.md](features/equipment/README.md) | 설비관리 |
|
||||
| [boards/README.md](features/boards/README.md) | 게시판 |
|
||||
| [ai/README.md](features/ai/README.md) | AI 분석 |
|
||||
| [card-vehicle/README.md](features/card-vehicle/README.md) | 법인카드·차량 |
|
||||
| [settlement/README.md](features/settlement/README.md) | 정산 |
|
||||
| [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 |
|
||||
| [quality-management/README.md](features/quality-management/README.md) | 품질관리 (제품검사, 실적신고) |
|
||||
|
||||
---
|
||||
|
||||
### guides/ — 구현 가이드
|
||||
> 특정 기능 구현을 위한 단계별 매뉴얼
|
||||
|
||||
| 문서 | 설명 | 필수 확인 시점 |
|
||||
|------|------|--------------|
|
||||
| [swagger-guide.md](guides/swagger-guide.md) | Swagger API 문서 작성법 | API 문서 작성 전 |
|
||||
| [file-storage-guide.md](guides/file-storage-guide.md) | 파일 업로드/다운로드 구현 | 파일 기능 구현 전 |
|
||||
| [item-management-migration.md](guides/item-management-migration.md) | Item 시스템 전환 가이드 | 마이그레이션 작업 전 |
|
||||
| [project-launch-roadmap.md](guides/project-launch-roadmap.md) | 런칭 준비 현황 | 런칭 관련 작업 시 |
|
||||
| [production-env-sync.md](guides/production-env-sync.md) | 운영 전환 시 .env 동기화 | 테스트→운영 전환 시 |
|
||||
| [server-how-it-works.md](guides/server-how-it-works.md) | 서버 동작 원리 | 신규 합류 시 |
|
||||
| [nginx-fastcgi-guide.md](guides/nginx-fastcgi-guide.md) | Nginx & FastCGI 가이드 | 서버 이해 시 |
|
||||
| [php-fpm-guide.md](guides/php-fpm-guide.md) | PHP-FPM 가이드 | 서버 이해 시 |
|
||||
| [jenkins-setup-guide.md](guides/jenkins-setup-guide.md) | Jenkins CI/CD 셋업 | Jenkins 설치/설정 시 |
|
||||
| [auto-login-guide.md](guides/auto-login-guide.md) | MNG→DEV 자동 로그인 | 자동 로그인 구현 시 |
|
||||
| [erp-api-list.md](guides/erp-api-list.md) | ERP API 목록 (List vs Detail 구분) | 프론트 API 연동 시 |
|
||||
| [erp-api-detail.md](guides/erp-api-detail.md) | ERP API 상세 스펙 | 프론트 API 연동 시 |
|
||||
| [item-master-guide.md](guides/item-master-guide.md) | 품목기준관리 페이지-섹션-필드 구조 | 품목 UI 구현 시 |
|
||||
| [item-master-items-api.md](guides/item-master-items-api.md) | ItemMaster & Items API 문서 | 품목 API 연동 시 |
|
||||
|
||||
---
|
||||
|
||||
### quickstart/ — 빠른 시작
|
||||
> 핵심 규칙 요약, 자주 쓰는 명령어
|
||||
### dev/guides/ — 구현 가이드
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [quick-start.md](quickstart/quick-start.md) | 프로젝트 핵심 규칙 요약 |
|
||||
| [dev-commands.md](quickstart/dev-commands.md) | 일상 개발 명령어 모음 |
|
||||
|
||||
---
|
||||
|
||||
### plans/ — 작업 추적
|
||||
> 예정 → 진행 → 완료 → archive/ (이미 정리 완료, 현행 유지)
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [index_plans.md](plans/index_plans.md) | 계획 인덱스 (ACTIVE + PLANNED) |
|
||||
| [GUIDE.md](plans/GUIDE.md) | 계획 문서 작성 가이드 |
|
||||
| [swagger-guide.md](dev/guides/swagger-guide.md) | Swagger 작성법 |
|
||||
| [file-storage-guide.md](dev/guides/file-storage-guide.md) | 파일 업로드/다운로드 |
|
||||
| [item-management-migration.md](dev/guides/item-management-migration.md) | Item 전환 가이드 |
|
||||
| [server-how-it-works.md](dev/guides/server-how-it-works.md) | 서버 동작 원리 |
|
||||
| [jenkins-setup-guide.md](dev/guides/jenkins-setup-guide.md) | Jenkins CI/CD |
|
||||
| [erp-api-list.md](dev/guides/erp-api-list.md) | ERP API 목록 |
|
||||
| [erp-api-detail.md](dev/guides/erp-api-detail.md) | ERP API 상세 |
|
||||
| [item-master-guide.md](dev/guides/item-master-guide.md) | 품목기준관리 구조 |
|
||||
|
||||
---
|
||||
|
||||
### projects/ — 프로젝트 자료
|
||||
> 프로젝트성 분석, 설계, 참고 자료 (지속 보관)
|
||||
|
||||
| 프로젝트 | 문서 | 설명 |
|
||||
|---------|------|------|
|
||||
| [index_projects.md](projects/index_projects.md) | 프로젝트 인덱스 | |
|
||||
| **MES** | [README.md](projects/mes/README.md) | MES 프로젝트 개요 |
|
||||
| **MES** | [MES_PROJECT_ROADMAP.md](projects/mes/MES_PROJECT_ROADMAP.md) | 개발 로드맵 |
|
||||
| **5130 이관** | [MASTER_PLAN.md](projects/5130-migration/MASTER_PLAN.md) | 레거시 이관 마스터 플랜 |
|
||||
| **API 연동** | [MASTER_PLAN.md](projects/api-integration/MASTER_PLAN.md) | React↔API 연동 |
|
||||
| **Legacy** | [draw-module.md](projects/legacy-5130/draw-module.md) | 레거시 드로우 모듈 |
|
||||
| **견적** | [quotation/](projects/quotation/) | 견적 프로젝트 자료 |
|
||||
| **전자서명** | [e-sign/](projects/e-sign/) | 전자서명 프로젝트 자료 |
|
||||
| MES | [projects/mes/README.md](projects/mes/README.md) | MES 개요 |
|
||||
| 5130 이관 | [projects/5130-migration/](projects/5130-migration/) | 레거시 이관 |
|
||||
| API 연동 | [projects/api-integration/](projects/api-integration/) | React↔API |
|
||||
| 견적 | [projects/quotation/](projects/quotation/) | 견적 프로젝트 |
|
||||
| 전자서명 | [projects/e-sign/](projects/e-sign/) | 전자서명 |
|
||||
|
||||
---
|
||||
|
||||
### deploys/ — 운영 매뉴얼
|
||||
> 서버 운영, 배포 (현행 유지)
|
||||
### dev/deploys/ — 배포/운영
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [ops-manual/README.md](deploys/ops-manual/README.md) | 서버 운영 매뉴얼 (11부 구성) |
|
||||
| [ops-manual/README.md](dev/deploys/ops-manual/README.md) | 서버 운영 매뉴얼 |
|
||||
|
||||
---
|
||||
|
||||
### changes/ — 변경 이력
|
||||
> 파일명 형식: `YYYYMMDD_description.md`
|
||||
|
||||
---
|
||||
|
||||
### data/ — 데이터 분석
|
||||
### dev/quickstart/ — 빠른 시작
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [analysis/item-db-analysis.md](data/analysis/item-db-analysis.md) | Item DB/API 분석 최종본 |
|
||||
| [analysis/bom-item-mapping-analysis.md](data/analysis/bom-item-mapping-analysis.md) | BOM-품목 매핑 분석 |
|
||||
|
||||
### contracts/ - 전자계약서 버전 관리
|
||||
> DOCX 배포본 + Markdown 추적본 + 자동화 스크립트
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [CHANGELOG.md](contracts/CHANGELOG.md) | 전체 개정이력 |
|
||||
| [revisions.json](contracts/revisions.json) | 개정 데이터 |
|
||||
| [docx/](contracts/docx/) | DOCX 배포본 (전자서명용 4종, 바로 사용 가능) |
|
||||
| [markdown/](contracts/markdown/) | Markdown 추적본 (Git diff용 4종) |
|
||||
| [scripts/extract_to_markdown.py](contracts/scripts/extract_to_markdown.py) | DOCX → Markdown 추출 |
|
||||
| [scripts/sync_check.py](contracts/scripts/sync_check.py) | DOCX ↔ Markdown 동기화 검증 |
|
||||
|
||||
### plans/ - 개발 계획
|
||||
> 임시 개발 계획 문서 (작업 완료 후 정리 → 삭제)
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [SAM_ERP_Storyboard_D1.4_260116.md](plans/SAM_ERP_Storyboard_D1.4_260116.md) | ERP 전체 스토리보드 D1.4 (167p PDF → 마크다운 변환, 14개 섹션 146개 화면) |
|
||||
| [SAM_ERP_Storyboard_D1.4.md](plans/SAM_ERP_Storyboard_D1.4.md) | ERP 스토리보드 D1.4 AI 최적화 버전 (구조화된 한글 마크다운, 15개 섹션) |
|
||||
| [SAM_ERP_회계관리_Storyboard_D1.6.md](plans/SAM_ERP_회계관리_Storyboard_D1.6.md) | ERP 회계관리 스토리보드 D1.6 (65p PDF → 마크다운 변환) |
|
||||
| [SAM_General_Rule_Storyboard_D1.0.md](plans/SAM_General_Rule_Storyboard_D1.0.md) | General Rule 스토리보드 D1.0 (43p PDF → 마크다운 변환, UIUX 공통 규칙) |
|
||||
| [production-deployment-plan.md](plans/production-deployment-plan.md) | 운영 환경 배포 계획 (CI/CD, 서버 아키텍처) |
|
||||
| [attendance-management-plan.md](plans/attendance-management-plan.md) | 근태현황 개발 계획 (Phase 1~2, HTMX 기반) |
|
||||
| [leave-management-plan.md](plans/leave-management-plan.md) | 휴가관리 모듈 개발 계획 (연차 발생/신청/승인/정책) |
|
||||
|
||||
### features/ - 기능별 문서
|
||||
|
||||
| 문서 | 설명 |
|
||||
|------|------|
|
||||
| [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 (알림톡/친구톡) 연동 |
|
||||
| [boards/README.md](features/boards/README.md) | 게시판 시스템 구현 |
|
||||
| [boards/mng-implementation.md](features/boards/mng-implementation.md) | MNG 게시판 구현 상세 |
|
||||
| [hr/attendance-management-spec.md](features/hr/attendance-management-spec.md) | 근태관리 기획서 (화면/데이터/비즈니스규칙/API) |
|
||||
| [hr/hr-api-analysis.md](features/hr/hr-api-analysis.md) | HR API 분석 (근태/직원/부서) |
|
||||
| [quotes/README.md](features/quotes/README.md) | 견적 시스템 분석 (BOM 계산, 10단계 로직) |
|
||||
| [business-card-request.md](features/business-card-request.md) | 명함신청 관리 (3단계 워크플로우: 요청→제작의뢰→처리완료) |
|
||||
| [academy/fire-shutter-image-prompts.md](features/academy/fire-shutter-image-prompts.md) | 방화셔터 백과사전 이미지 생성 프롬프트 (Gemini용) |
|
||||
|
||||
### projects/ - 프로젝트별 문서
|
||||
|
||||
| 프로젝트 | 문서 | 설명 |
|
||||
|---------|------|------|
|
||||
| **MES** | [README.md](projects/mes/README.md) | MES 프로젝트 개요 |
|
||||
| **MES** | [MES_PROJECT_ROADMAP.md](projects/mes/MES_PROJECT_ROADMAP.md) | 개발 로드맵 |
|
||||
| **Legacy** | [draw-module.md](projects/legacy-5130/draw-module.md) | 레거시 드로우 모듈 |
|
||||
|
||||
### history/ - 히스토리
|
||||
|
||||
| 기간 | 문서 |
|
||||
|------|------|
|
||||
| **2025-11** | [item-master-gap-analysis.md](history/2025-11/item-master-gap-analysis.md), [item-master-spec.md](history/2025-11/item-master-spec.md), [front-requests/](history/2025-11/front-requests/), [item-master-archived/](history/2025-11/item-master-archived/) |
|
||||
| **2025-09** | [checkpoint.md](history/2025-09/checkpoint.md), [database-schema.md](history/2025-09/database-schema.md) |
|
||||
| **Roadmaps** | [december-2025.md](history/roadmaps/december-2025.md) |
|
||||
| [quick-start.md](dev/quickstart/quick-start.md) | 핵심 규칙 요약 |
|
||||
| [dev-commands.md](dev/quickstart/dev-commands.md) | 개발 명령어 모음 |
|
||||
|
||||
---
|
||||
|
||||
### 서브프로젝트 문서
|
||||
|
||||
각 서브프로젝트는 독립적인 `docs/` 디렉토리를 가집니다.
|
||||
|
||||
| 프로젝트 | 문서 경로 | 설명 |
|
||||
|---------|----------|------|
|
||||
| **API** | [api/docs/](../api/docs/) | REST API 프로젝트 |
|
||||
| **MNG** | [mng/docs/](../mng/docs/) | Plain Laravel 관리자 |
|
||||
| **React** | [react/docs/](../react/docs/) | Next.js 프론트엔드 |
|
||||
| 프로젝트 | 경로 |
|
||||
|---------|------|
|
||||
| API | [api/docs/](../api/docs/) |
|
||||
| MNG | [mng/docs/](../mng/docs/) |
|
||||
| React | [react/docs/](../react/docs/) |
|
||||
|
||||
---
|
||||
|
||||
## 📝 문서 작성 규칙
|
||||
|
||||
### 폴더 선택 기준
|
||||
## 폴더 선택 기준
|
||||
|
||||
| 질문 | 폴더 |
|
||||
|------|------|
|
||||
| "시스템이 현재 어떤 상태인가?" | `system/` |
|
||||
| "어떻게 코드를 작성할 것인가?" | `standards/` |
|
||||
| "무엇이 유효한 데이터인가?" | `rules/` |
|
||||
| "이 기능은 어떻게 동작하는가?" | `features/` |
|
||||
| "어떻게 구현할 것인가?" | `guides/` |
|
||||
| "무슨 작업을 할 것인가?" | `plans/` |
|
||||
| "프로젝트 자료를 보관하고 싶다" | `projects/` |
|
||||
| "무엇이 변경되었는가?" | `changes/` |
|
||||
|
||||
### 파일명 규칙
|
||||
|
||||
| 유형 | 규칙 | 예시 |
|
||||
|------|------|------|
|
||||
| 기술 문서 (코드 참조) | 영문 kebab-case | `api-rules.md`, `database-schema.md` |
|
||||
| 업무/비즈니스 문서 | 한글 허용 | `영업파트너가이드북.md`, `수당지급.md` |
|
||||
| 변경 이력 | `YYYYMMDD_description.md` | `20260205_sus_inspection_template.md` |
|
||||
| 폴더 인덱스 | `README.md` (대문자) | `features/finance/README.md` |
|
||||
| **혼용 금지** | 한글+영문 섞지 않음 | ❌ `영업partner가이드.md` |
|
||||
|
||||
### 크기 제한
|
||||
- **목표**: 10KB 이하
|
||||
- 초과 시 도메인별로 분할
|
||||
|
||||
### 문서 구조 템플릿
|
||||
|
||||
#### 정책/규칙 문서 (`rules/`, `standards/`)
|
||||
|
||||
```markdown
|
||||
# 제목
|
||||
|
||||
> **작성일**: YYYY-MM-DD
|
||||
> **상태**: 설계 확정
|
||||
|
||||
---
|
||||
|
||||
## 1. 개요
|
||||
## 2. 핵심 원칙
|
||||
## 3. 상세 규칙
|
||||
## 4. API 엔드포인트 (해당 시)
|
||||
## 관련 문서
|
||||
|
||||
---
|
||||
|
||||
**최종 업데이트**: YYYY-MM-DD
|
||||
```
|
||||
|
||||
#### 변경 이력 문서 (`changes/`)
|
||||
|
||||
```markdown
|
||||
# 변경 내용 요약
|
||||
|
||||
**날짜:** YYYY-MM-DD
|
||||
|
||||
## 변경 개요
|
||||
## 수정된 파일
|
||||
## 상세 변경 사항
|
||||
## 테스트 체크리스트
|
||||
```
|
||||
|
||||
### 작성 스타일
|
||||
|
||||
| 항목 | 규칙 |
|
||||
|------|------|
|
||||
| **언어** | 한글 기본, 코드/경로/기술 식별자만 영어 |
|
||||
| **어조** | 서술형 ("X 한다") |
|
||||
| **경고** | `> **경고: ...**` 블록인용 |
|
||||
| **금지/필수** | `❌` 금지, `✅` 필수 |
|
||||
| **우선순위** | `🔴 필수`, `🟡 중요`, `🟢 권장` |
|
||||
| **코드 블록** | 반드시 언어 지정 (```php, ```bash 등) |
|
||||
| **인라인 코드** | 파일 경로, 메서드명, 변수명에 백틱 |
|
||||
| **구분선** | `---` 주요 섹션 사이 |
|
||||
|
||||
### 새 문서 작성 시 체크리스트
|
||||
- [ ] 적절한 폴더에 배치
|
||||
- [ ] 파일명 규칙 준수
|
||||
- [ ] 문서 구조 템플릿 준수
|
||||
- [ ] 이 INDEX.md에 등록
|
||||
|
||||
---
|
||||
|
||||
## 🔄 문서 정비 진행 현황
|
||||
|
||||
> 참조: [docs-comprehensive-update-plan.md](plans/docs-comprehensive-update-plan.md)
|
||||
|
||||
| Phase | 작업 | 상태 |
|
||||
|-------|------|------|
|
||||
| **Phase 0** | 문서 정책 재정립 | ✅ 완료 |
|
||||
| **Phase 1** | 시스템 현황 문서화 (DB, API, React, MNG, Docker) | ✅ 완료 (14개 문서) |
|
||||
| **Phase 2** | 기존 문서 정비 (architecture/+specs/ → system/ 이관) | ⏳ 대기 |
|
||||
| **Phase 3** | 신규 도메인 기능 문서 작성 | ⏳ 대기 |
|
||||
| **Phase 4** | 최종 검증 및 INDEX 갱신 | ⏳ 대기 |
|
||||
| 시스템 현재 상태? | `system/` |
|
||||
| 코드 작성 규칙? | `dev/standards/` |
|
||||
| 비즈니스 규칙? | `rules/` |
|
||||
| 기능 동작 방식? | `features/` |
|
||||
| 구현 방법? | `dev/guides/` |
|
||||
| 개발 계획? | `dev/dev_plans/` |
|
||||
| 프로젝트 자료? | `projects/` |
|
||||
| 변경 이력? | `dev/changes/` |
|
||||
128
README.md
Normal file
@@ -0,0 +1,128 @@
|
||||
# SAM 프로젝트 문서
|
||||
|
||||
SAM ERP 시스템의 기술 문서, 비즈니스 규칙, 기능 명세를 관리하는 저장소입니다.
|
||||
|
||||
---
|
||||
|
||||
## 대상별 안내
|
||||
|
||||
### 전 팀 공유
|
||||
누구나 참고할 수 있는 공통 문서입니다.
|
||||
|
||||
| 폴더 | 설명 | 예시 |
|
||||
|------|------|------|
|
||||
| **features/** | 기능별 상세 명세 | 견적, CRM, 문서관리, 인사, 재무 등 |
|
||||
| **rules/** | 비즈니스 규칙·정책 | 품목 정책, 단가 정책, 채번 규칙, 청구 정책 |
|
||||
| **projects/** | 프로젝트별 자료 | MES, 5130 마이그레이션, 전자서명 등 |
|
||||
| **system/** | 시스템 현황 | 아키텍처, DB 스키마, Docker, 인프라 |
|
||||
| **resources.md** | 외부 자료 링크 | BI, 제품 소개서 등 대용량 자료 (노션 링크) |
|
||||
|
||||
### 개발팀 전용 (`dev/`)
|
||||
개발 표준, 가이드, 변경 이력 등 개발자 대상 문서입니다.
|
||||
|
||||
| 폴더 | 설명 | 예시 |
|
||||
|------|------|------|
|
||||
| **dev/standards/** | 개발 표준 | API 규칙, Git 컨벤션, 품질 체크리스트 |
|
||||
| **dev/guides/** | 구현 가이드 | Swagger 작성법, 파일 저장, Jenkins 설정 |
|
||||
| **dev/quickstart/** | 빠른 시작 | 개발 명령어, 퀵스타트 가이드 |
|
||||
| **dev/changes/** | 변경 이력 | 날짜별 변경 내용 기록 |
|
||||
| **dev/deploys/** | 배포·운영 | 운영 매뉴얼, 배포 SQL |
|
||||
| **dev/data/** | 데이터 분석 | BOM 매핑 분석, 견적 데이터 |
|
||||
| **dev/history/** | 과거 이력 | 월별 히스토리, 로드맵 |
|
||||
| **dev/dev_plans/** | 개발 계획 | 작업별 계획 문서 (개인 작업용, 정리 후 폐기 가능) |
|
||||
|
||||
### 프론트엔드 전용 (`frontend/`)
|
||||
프론트엔드 개발자 대상 문서입니다.
|
||||
|
||||
| 폴더 | 설명 | 예시 |
|
||||
|------|------|------|
|
||||
| **frontend/api-specs/** | API 연동 명세 | 문서 API 연동 가이드 |
|
||||
| **frontend/integration/** | 프론트-백엔드 연동 | 연동 패턴, 주의사항 |
|
||||
|
||||
### 기획팀 (`requests/`)
|
||||
기획 요청 및 확인 문서입니다.
|
||||
|
||||
| 폴더 | 설명 | 예시 |
|
||||
|------|------|------|
|
||||
| **requests/** | 기획 확인 요청 | 기획서 검토 요청, 워크플로우 공유 |
|
||||
|
||||
---
|
||||
|
||||
## 폴더 구조
|
||||
|
||||
```
|
||||
docs/
|
||||
├── features/ # [공유] 기능별 상세 명세
|
||||
│ ├── quotes/ # 견적 시스템
|
||||
│ ├── sales/ # 영업/수주
|
||||
│ ├── documents/ # 문서관리
|
||||
│ ├── finance/ # 재무/회계
|
||||
│ ├── hr/ # 인사관리
|
||||
│ ├── crm/ # 고객관리
|
||||
│ ├── esign/ # 전자서명
|
||||
│ ├── equipment/ # 설비관리
|
||||
│ ├── boards/ # 게시판
|
||||
│ ├── ai/ # AI 기능
|
||||
│ └── ...
|
||||
│
|
||||
├── rules/ # [공유] 비즈니스 규칙
|
||||
│ ├── item-policy.md
|
||||
│ ├── pricing-policy.md
|
||||
│ ├── numbering-rules.md
|
||||
│ └── ...
|
||||
│
|
||||
├── projects/ # [공유] 프로젝트별 자료
|
||||
│ ├── mes/
|
||||
│ ├── 5130-migration/
|
||||
│ ├── e-sign/
|
||||
│ └── ...
|
||||
│
|
||||
├── system/ # [공유] 시스템 현황
|
||||
│ ├── overview.md
|
||||
│ ├── database/
|
||||
│ ├── docker-setup.md
|
||||
│ └── ...
|
||||
│
|
||||
├── resources.md # [공유] 외부 자료 링크 (노션)
|
||||
│
|
||||
├── dev/ # [개발팀] 개발 전용
|
||||
│ ├── standards/ # 개발 표준
|
||||
│ ├── guides/ # 구현 가이드
|
||||
│ ├── quickstart/ # 빠른 시작
|
||||
│ ├── changes/ # 변경 이력
|
||||
│ ├── deploys/ # 배포/운영
|
||||
│ ├── data/ # 데이터 분석
|
||||
│ ├── history/ # 과거 이력
|
||||
│ └── dev_plans/ # 개발 계획 (개인 작업용)
|
||||
│
|
||||
├── frontend/ # [프론트엔드] 프론트 전용
|
||||
│ ├── api-specs/ # API 연동 명세
|
||||
│ └── integration/ # 연동 가이드
|
||||
│
|
||||
├── requests/ # [기획팀] 기획 요청
|
||||
│
|
||||
├── README.md # 이 문서 (사람용 안내)
|
||||
├── INDEX.md # Claude Code용 문서 인덱스
|
||||
└── TODO.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 문서 작성 규칙
|
||||
|
||||
### 파일 이름
|
||||
- 영문 소문자, 하이픈(`-`) 구분: `item-policy.md`
|
||||
- 변경 이력: `YYYYMMDD_설명.md` (예: `20260305_login_fix.md`)
|
||||
- 한글 파일명 허용 (가이드 등 내부 문서)
|
||||
|
||||
### 문서 구조
|
||||
- 모든 MD 파일은 `# 제목`으로 시작
|
||||
- 폴더에 파일이 3개 이상이면 `README.md`로 목차 제공
|
||||
- 이미지/대용량 파일은 노션에 업로드하고 `resources.md`에 링크 추가
|
||||
|
||||
### 폴더 관리
|
||||
- **공유 폴더**: 전 팀이 수정 가능, 변경 시 관련 팀에 공유
|
||||
- **dev/**: 개발팀만 수정
|
||||
- **frontend/**: 프론트엔드 팀만 수정 (API 명세는 개발팀이 제공)
|
||||
- **requests/**: 기획팀이 작성, 개발팀이 확인
|
||||
- **dev/dev_plans/**: 개인 작업용, 완료 후 archive/ 이동 또는 삭제
|
||||
@@ -197,10 +197,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.08); padding-top: 10pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.7);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.7);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3);">무료 데모 및 상담</p>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 600; color: #10B981;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -209,17 +209,19 @@
|
||||
<div style="margin-top: auto; background: rgba(16,185,129,0.08); border: 1pt solid rgba(16,185,129,0.2); border-radius: 8pt; padding: 12pt 14pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: center;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 10pt; font-weight: 800; color: #ffffff;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; color: rgba(255,255,255,0.45); margin-top: 3pt;">귀사에 최적화된 맞춤 데모를 제공합니다</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.4); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #10B981;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.4); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 6pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2);">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2);">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -110,8 +110,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.08); padding-top: 12pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.7);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.7);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.35);">뒷면에서 상세 기능과 가격을 확인하세요</p>
|
||||
|
||||
@@ -248,10 +248,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.06); padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.65);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.25); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.65);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.25); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.3);">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 600; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -224,17 +224,19 @@
|
||||
<div style="margin-top: auto; background: rgba(14,165,233,0.08); border: 1.5pt solid rgba(14,165,233,0.2); border-radius: 8pt; padding: 10pt 14pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: center;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 10pt; font-weight: 800; color: #ffffff;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.4); margin-top: 2pt;">대표님 전용 대시보드를 직접 체험해 보세요</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.35); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.35); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 5pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.18);">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.18);">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -160,8 +160,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.06); padding-top: 10pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.65);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.25); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 700; color: rgba(255,255,255,0.65);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.25); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 7pt; color: rgba(255,255,255,0.3);">뒷면에서 상세 기능을 확인하세요</p>
|
||||
|
||||
@@ -392,10 +392,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.06); padding-top: 7pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: rgba(255,255,255,0.6);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: rgba(255,255,255,0.6);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.25);">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -354,18 +354,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#0EA5E9" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #ffffff;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.35); margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.15);">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.15);">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -250,8 +250,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(255,255,255,0.06); padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.6);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.6);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.25);">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -392,10 +392,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid #E2E8F0; padding-top: 7pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #475569;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #CBD5E1; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #475569;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #CBD5E1; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8;">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -354,18 +354,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#0EA5E9" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #0F172A;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8; margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8; margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #0EA5E9;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8; margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #CBD5E1;">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #CBD5E1;">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -248,8 +248,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid #E2E8F0; padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #475569;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #CBD5E1; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #475569;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #CBD5E1; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8;">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -306,10 +306,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(251,191,36,0.1); padding-top: 7pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: rgba(255,255,255,0.6);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: rgba(255,255,255,0.6);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.25);">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #FBBF24;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -292,18 +292,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#FBBF24" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #ffffff;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.25); margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #FBBF24;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.25); margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.15);">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.15);">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -204,8 +204,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid rgba(251,191,36,0.1); padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.6);">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: rgba(255,255,255,0.6);">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.2); margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.25);">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -359,10 +359,12 @@
|
||||
<div style="margin-top: auto; background: #EFF6FF; border-radius: 5pt; padding: 7pt 10pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #1E293B;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #1E293B;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #94A3B8;">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #2563EB;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -316,18 +316,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#FFFFFF" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #FFFFFF;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.6); margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.5); margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #FFFFFF;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.5); margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #94A3B8;">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #94A3B8;">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
@@ -217,8 +217,8 @@
|
||||
<div style="margin-top: auto; background: #EFF6FF; border-radius: 5pt; padding: 8pt 12pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #1E293B;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #1E293B;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8;">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -363,10 +363,12 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid #D6D3D1; padding-top: 7pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #57534E;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #A8A29E; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 700; color: #57534E;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #A8A29E; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #A8A29E;">무료 데모 신청</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #0D9488;">contact@codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -354,18 +354,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#0D9488" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #292524;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #A8A29E; margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #A8A29E; margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #0D9488;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #A8A29E; margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #A8A29E;">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #A8A29E;">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -266,8 +266,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid #D6D3D1; padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #57534E;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #A8A29E; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #57534E;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #A8A29E; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #A8A29E;">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -218,18 +218,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#F97316" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 800; color: #FFFFFF;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.5); margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; font-weight: 700; color: #F97316;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="margin-top: 5pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #94A3B8;">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #94A3B8;">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
@@ -301,18 +301,20 @@
|
||||
<path d="M11 6 L11 11 L15 13" fill="none" stroke="#F97316" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 9pt; font-weight: 800; color: #FFFFFF;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: rgba(255,255,255,0.5); margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #F97316;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: rgba(255,255,255,0.3); margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 회사명 -->
|
||||
<div style="padding: 5pt 0; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #94A3B8;">SAM — Smart Automation Management</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #94A3B8;">(주)코드브릿지엑스 | SAM - Smart Automation Management</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -268,8 +268,8 @@
|
||||
<div style="margin-top: auto; border-top: 1pt solid #E2E8F0; padding-top: 8pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #475569;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7.5pt; font-weight: 700; color: #475569;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<div style="text-align: right;">
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; color: #94A3B8;">뒷면에서 상세 기능을 확인하세요 ▶</p>
|
||||
|
||||
@@ -250,15 +250,17 @@
|
||||
<div style="margin-top: auto; background: #F8FAFC; border: 1pt solid #F1F5F9; border-radius: 5pt; padding: 8pt 10pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: center;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 8pt; font-weight: 800; color: #0F172A;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #64748B; margin-top: 1pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
<div style="text-align: right; border-left: 2pt solid #6366F1; padding-left: 8pt;">
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #CBD5E1; margin-top: 1pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; font-weight: 700; color: #6366F1;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #CBD5E1; margin-top: 1pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div style="margin-top: 4pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 4.5pt; color: #CBD5E1;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 4.5pt; color: #CBD5E1;">(주)코드브릿지엑스</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -211,17 +211,19 @@
|
||||
<div style="margin-top: auto; background: #F8FAFC; border: 1pt solid #F1F5F9; border-radius: 6pt; padding: 12pt 14pt;">
|
||||
<div style="display: flex; justify-content: space-between; align-items: center;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 10pt; font-weight: 800; color: #0F172A;">무료 데모를 신청하세요</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #64748B; margin-top: 2pt;">대표님 전용 대시보드를 직접 체험</p>
|
||||
</div>
|
||||
<div style="text-align: right; border-left: 2pt solid #6366F1; padding-left: 10pt;">
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #CBD5E1; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 6.5pt; font-weight: 700; color: #6366F1;">contact@codebridge-x.com</p>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #CBD5E1; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Footer -->
|
||||
<div style="margin-top: 6pt; text-align: center;">
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #CBD5E1;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 5pt; color: #CBD5E1;">(주)코드브릿지엑스</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -172,8 +172,8 @@
|
||||
<!-- Footer -->
|
||||
<div style="margin-top: auto; display: flex; justify-content: space-between; align-items: flex-end;">
|
||||
<div>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #0F172A;">SAM</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #CBD5E1; margin-top: 2pt;">www.sam.it.kr</p>
|
||||
<p style="white-space: nowrap; font-size: 7pt; font-weight: 600; color: #0F172A;">(주)코드브릿지엑스</p>
|
||||
<p style="white-space: nowrap; font-size: 6pt; color: #CBD5E1; margin-top: 2pt;">www.codebridge-x.com</p>
|
||||
</div>
|
||||
<p style="white-space: nowrap; font-size: 5.5pt; color: #CBD5E1;">뒷면에서 상세 기능을 확인하세요</p>
|
||||
</div>
|
||||
|
||||
119
changes/20260303_gemini_model_upgrade.md
Normal file
@@ -0,0 +1,119 @@
|
||||
# Gemini 모델 업그레이드: 2.0-flash → 2.5-flash
|
||||
|
||||
**날짜:** 2026-03-03
|
||||
**작업자:** Claude Code
|
||||
|
||||
---
|
||||
|
||||
## 변경 개요
|
||||
|
||||
Google이 2026년 6월 1일부로 Gemini 2.0 Flash 모델 서비스를 종료한다는 통보를 받아, SAM 시스템 전체의 Gemini 모델을 `gemini-2.0-flash` → `gemini-2.5-flash`로 마이그레이션했다.
|
||||
|
||||
---
|
||||
|
||||
## 변경 사유
|
||||
|
||||
- Google의 공식 메일 통보: Gemini 2.0 Flash / 2.0 Flash-Lite → 2026-06-01 강제 종료
|
||||
- 마이그레이션 경로: `gemini-2.0-flash` → `gemini-2.5-flash`
|
||||
- API 키, Base URL 변경 없음 (모델명만 변경)
|
||||
|
||||
---
|
||||
|
||||
## 수정된 파일
|
||||
|
||||
### API 프로젝트 (`/home/aweso/sam/api`)
|
||||
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `.env` | `GEMINI_MODEL=gemini-2.0-flash` → `gemini-2.5-flash` |
|
||||
| `config/services.php` | fallback 기본값 `gemini-2.0-flash` → `gemini-2.5-flash` |
|
||||
| `app/Services/AiReportService.php` | fallback 기본값 변경 |
|
||||
|
||||
### MNG 프로젝트 (`/home/aweso/sam/mng`)
|
||||
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `.env` | `GEMINI_MODEL=gemini-2.0-flash` → `gemini-2.5-flash` |
|
||||
| `config/services.php` | fallback 기본값 변경 |
|
||||
| `app/Models/System/AiConfig.php` | `DEFAULT_MODELS['gemini']` 상수 + `getActiveGemini()` fallback 변경 |
|
||||
| `app/Services/NotionService.php` | fallback 기본값 변경 |
|
||||
| `resources/views/system/ai-config/index.blade.php` | UI placeholder, 기본값, JS defaultModels 변경 |
|
||||
| `resources/views/google-cloud/ai-guide/index.blade.php` | 서비스 현황 테이블 모델명 7곳 변경 |
|
||||
| `resources/views/academy/env-management.blade.php` | 환경변수 예시 테이블 변경 |
|
||||
|
||||
### 문서 (`/home/aweso/sam/docs`)
|
||||
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `guides/ai-config-settings.md` | 기본 모델명 업데이트, 최종 업데이트 날짜 변경 |
|
||||
| `guides/ai-management.md` | **신규** — AI 관리 종합 가이드 (아키텍처, 버전 이력, 온보딩) |
|
||||
| `guides/ai-model-update-workflow.md` | **신규** — 모델 업데이트 표준 절차 (7단계 워크플로우) |
|
||||
| `changes/20260303_gemini_model_upgrade.md` | **신규** — 이 변경 이력 문서 |
|
||||
|
||||
### 수정하지 않은 파일 (의도적)
|
||||
|
||||
| 파일 | 이유 |
|
||||
|------|------|
|
||||
| `api/database/migrations/2026_01_27_*.php` | 이미 실행된 마이그레이션 — 변경 시 DB 무결성 문제 |
|
||||
| `api/database/migrations/2026_02_07_*.php` | 동일 |
|
||||
| `api/database/migrations/2026_02_09_*.php` | 동일 |
|
||||
| `mng/views/google-cloud/cloud-api-pricing/index.blade.php` | `2.0 → 2.5` 마이그레이션 안내 UI — 이전 모델명이 의도적 잔존 |
|
||||
|
||||
---
|
||||
|
||||
## 서버 .env 수정 필요 (배포 후)
|
||||
|
||||
| 환경 | 파일 | 변수 | 담당 |
|
||||
|------|------|------|------|
|
||||
| 개발서버 | `/home/webservice/api/.env` | `GEMINI_MODEL=gemini-2.5-flash` | SSH 접속 수정 |
|
||||
| 개발서버 | `/home/webservice/mng/.env` | `GEMINI_MODEL=gemini-2.5-flash` | SSH 접속 수정 |
|
||||
| 운영서버 | `/home/webservice/api/.env` | `GEMINI_MODEL=gemini-2.5-flash` | 개발팀장 직접 |
|
||||
| 운영서버 | `/home/webservice/mng/.env` | `GEMINI_MODEL=gemini-2.5-flash` | 개발팀장 직접 |
|
||||
|
||||
수정 후 반드시 실행:
|
||||
```bash
|
||||
php artisan config:clear
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## DB 단가 설정 필요
|
||||
|
||||
MNG `/system/ai-token-usage` → 단가 설정에서:
|
||||
- 기존 `gemini-2.0-flash` 단가 → 비활성화
|
||||
- 신규 `gemini-2.5-flash` 단가 추가:
|
||||
- `input_price_per_million`: 0.15
|
||||
- `output_price_per_million`: 0.60
|
||||
- `exchange_rate`: 현재 환율
|
||||
|
||||
---
|
||||
|
||||
## 테스트 체크리스트
|
||||
|
||||
- [x] 로컬 .env 수정 완료
|
||||
- [x] 코드 fallback 전체 변경 완료
|
||||
- [ ] 로컬 연결 테스트 (MNG `/system/ai-config`)
|
||||
- [ ] 개발서버 .env 수정 + config:clear
|
||||
- [ ] 개발서버 연결 테스트
|
||||
- [ ] 운영서버 .env 수정 + config:clear
|
||||
- [ ] DB 단가 설정 (gemini-2.5-flash)
|
||||
- [ ] 토큰 사용량 로그 확인 (새 모델명)
|
||||
|
||||
---
|
||||
|
||||
## 롤백 절차
|
||||
|
||||
문제 발생 시 `.env`만 되돌리면 즉시 복구:
|
||||
```bash
|
||||
# 모든 환경의 .env에서
|
||||
GEMINI_MODEL=gemini-2.0-flash
|
||||
php artisan config:clear
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 관련 문서
|
||||
|
||||
- [AI 관리 종합 가이드](../guides/ai-management.md)
|
||||
- [모델 업데이트 워크플로우](../guides/ai-model-update-workflow.md)
|
||||
- [AI 설정 기술문서](../guides/ai-config-settings.md)
|
||||
165
changes/20260304_eaccount_infinite_loop_fix.md
Normal file
@@ -0,0 +1,165 @@
|
||||
# 계좌 입출금내역 부분 월 조회 시 무한루프 크래시 수정
|
||||
|
||||
**날짜:** 2026-03-04
|
||||
**작업자:** Claude Code
|
||||
|
||||
---
|
||||
|
||||
## 변경 개요
|
||||
|
||||
계좌 입출금내역 페이지에서 **날짜를 수동 입력**하여 조회 시 500 에러가 발생하는 문제를 수정했다.
|
||||
편의 버튼(이번달, 지난달 등)은 항상 전체 월(1일~말일)을 사용하여 문제가 없었으나,
|
||||
수동으로 날짜를 입력하면 **부분 월**(예: 12/01~12/18)이 되어 무한루프가 발생했다.
|
||||
|
||||
---
|
||||
|
||||
## 근본 원인
|
||||
|
||||
### `splitDateRangeMonthly()` 함수의 cursor 이동 버그
|
||||
|
||||
긴 기간 조회 시 바로빌 SOAP API의 한계로 인해 기간을 **월별 청크**로 분할하는 함수에서,
|
||||
endDate가 **월 중간**일 때 cursor가 **같은 달 1일로 되돌아가** 무한루프가 발생했다.
|
||||
|
||||
```php
|
||||
// ❌ 버그 코드 — endDate가 월 중간이면 무한루프
|
||||
$cursor = $chunkEnd->copy()->addDay()->startOfMonth();
|
||||
|
||||
// 예시: endDate = 20251218
|
||||
// chunkEnd = 20251218
|
||||
// → addDay() = 20251219
|
||||
// → startOfMonth() = 20251201 ← 같은 달 1일로 되돌아감!
|
||||
// → while($cursor <= $end) 조건 여전히 true → 무한 반복
|
||||
```
|
||||
|
||||
```php
|
||||
// ✅ 수정 코드 — chunkStart 기준으로 다음 월로 이동
|
||||
$cursor = $chunkStart->copy()->addMonth()->startOfMonth();
|
||||
|
||||
// 예시: startDate = 20251201
|
||||
// chunkStart = 20251201
|
||||
// → addMonth() = 20260101
|
||||
// → startOfMonth() = 20260101 ← 다음 달로 정상 이동
|
||||
// → while($cursor <= $end) 조건 false → 루프 종료
|
||||
```
|
||||
|
||||
### 재현 조건
|
||||
|
||||
| 조건 | 결과 |
|
||||
|------|------|
|
||||
| 전체 월 (12/01~12/31) | 정상 — `addDay()` = 01/01 → `startOfMonth()` = 01/01 |
|
||||
| 부분 월 (12/01~12/18) | **무한루프** — `addDay()` = 12/19 → `startOfMonth()` = 12/01 |
|
||||
| 다중 월 (12/01~02/18) | **무한루프** — 마지막 월이 부분 월이면 동일 증상 |
|
||||
|
||||
### 증상
|
||||
|
||||
- PHP 프로세스가 메모리 한도(256M/512M)에 도달하여 **Fatal Error로 크래시**
|
||||
- Laravel 로그에 에러 기록 없음 (try-catch 밖에서 프로세스가 종료)
|
||||
- 프론트엔드에 `서버 응답 오류 (500):` (빈 응답 본문)
|
||||
|
||||
---
|
||||
|
||||
## 수정된 파일
|
||||
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `app/Http/Controllers/Barobill/EaccountController.php` | `splitDateRangeMonthly()` cursor 이동 로직 수정 |
|
||||
|
||||
---
|
||||
|
||||
## 검증 결과
|
||||
|
||||
tinker에서 수정 전후 비교 테스트:
|
||||
|
||||
```
|
||||
=== 수정 전 (버그): 20251201~20251218 ===
|
||||
→ 같은 청크 무한 반복 (10회 제한으로 강제 중단)
|
||||
|
||||
=== 수정 후: 20251201~20251218 ===
|
||||
→ [{start: 20251201, end: 20251218}] ← 1개 청크, 정상
|
||||
|
||||
=== 수정 후: 20251201~20260218 (다중 월) ===
|
||||
→ [{20251201~20251231}, {20260101~20260131}, {20260201~20260218}] ← 3개 청크, 정상
|
||||
|
||||
=== 수정 후: 20251215~20251231 ===
|
||||
→ [{start: 20251215, end: 20251231}] ← 1개 청크, 정상
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 동일 패턴 코드베이스 점검 결과
|
||||
|
||||
`sam/mng` 전체를 검색하여 유사 패턴을 점검했다:
|
||||
|
||||
| 파일 | 함수 | 패턴 | 위험도 |
|
||||
|------|------|------|--------|
|
||||
| `EaccountController.php` | `splitDateRangeMonthly()` | 월별 청크 분할 | ✅ 수정 완료 |
|
||||
| `DashboardStatService.php` | `generateDateRange()` | `addDay()` 단순 증가 | 안전 |
|
||||
| `InspectionCycle.php` | `getHolidayDates()` | `addDay()` 단순 증가 | 안전 |
|
||||
| `CorporateCardController.php` | `getNextBusinessDay()` | `addDay()` 단순 증가 | 안전 |
|
||||
| `PartitionManagementService.php` | `addPartitions()` | `for` 루프 (고정 횟수) | 안전 |
|
||||
|
||||
> **결론**: `EaccountController` 외에 동일 버그 패턴 없음.
|
||||
> 다른 코드들은 모두 `addDay()` 단순 증가 패턴을 사용하여 무한루프 위험 없음.
|
||||
|
||||
---
|
||||
|
||||
## 교훈 및 방지 규칙
|
||||
|
||||
### R1. 날짜 cursor 이동 시 `chunkEnd` 기반 이동 금지
|
||||
|
||||
```php
|
||||
// ❌ 위험: chunkEnd가 월 중간이면 startOfMonth()가 같은 달로 되돌림
|
||||
$cursor = $chunkEnd->copy()->addDay()->startOfMonth();
|
||||
|
||||
// ✅ 안전: chunkStart 기준으로 항상 다음 월로 이동
|
||||
$cursor = $chunkStart->copy()->addMonth()->startOfMonth();
|
||||
```
|
||||
|
||||
### R2. 날짜 루프에 안전장치(max iterations) 추가 권장
|
||||
|
||||
```php
|
||||
$maxIterations = 120; // 10년 = 120개월
|
||||
$iterations = 0;
|
||||
|
||||
while ($cursor->lte($end) && $iterations < $maxIterations) {
|
||||
// ... 청크 처리 ...
|
||||
$iterations++;
|
||||
}
|
||||
|
||||
if ($iterations >= $maxIterations) {
|
||||
Log::error('날짜 분할 루프 안전장치 작동', compact('startDate', 'endDate'));
|
||||
}
|
||||
```
|
||||
|
||||
### R3. 부분 월 테스트 필수
|
||||
|
||||
날짜 범위를 분할하는 코드 작성/수정 시 반드시 다음 케이스를 테스트:
|
||||
|
||||
- [ ] 전체 월 (01일~말일)
|
||||
- [ ] 부분 월 — 시작 (01일~중간)
|
||||
- [ ] 부분 월 — 끝 (중간~말일)
|
||||
- [ ] 다중 월 (마지막 월이 부분 월)
|
||||
- [ ] 같은 날 (시작일 = 종료일)
|
||||
|
||||
---
|
||||
|
||||
## 부수 개선 사항
|
||||
|
||||
이 문제 조사 과정에서 추가로 발견/수정된 항목:
|
||||
|
||||
| 항목 | 내용 |
|
||||
|------|------|
|
||||
| WSDL 캐싱 | `WSDL_CACHE_NONE` → `WSDL_CACHE_BOTH` (4개 바로빌 컨트롤러 전체) |
|
||||
| 소켓 타임아웃 | `default_socket_timeout` 60→120초 연장 |
|
||||
| Shutdown handler | PHP Fatal Error 감지 시 Laravel 로그에 기록 |
|
||||
| SOAP 호출 로깅 | 호출 시작/완료 시간 + 소요시간(ms) 기록 |
|
||||
|
||||
---
|
||||
|
||||
## 관련 문서
|
||||
|
||||
- `app/Http/Controllers/Barobill/EaccountController.php` — 바로빌 계좌 입출금내역
|
||||
|
||||
---
|
||||
|
||||
**최종 업데이트**: 2026-03-04
|
||||
69
changes/20260306_purchase_request_payment_method.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# 품의서 지급방법 UI 개선
|
||||
|
||||
**날짜:** 2026-03-06
|
||||
**작업자:** Claude Code
|
||||
|
||||
## 변경 개요
|
||||
|
||||
품의서 2종(구매품의서, 비용정산품의서)에 지급방법 선택 기능을 추가/개선하였다.
|
||||
|
||||
## 변경 내용
|
||||
|
||||
### 1. 구매품의서 (pr_purchase) - 지급방법 추가
|
||||
|
||||
- 납품 정보(납품업체/납품예정일/납품장소) 아래에 **지급방법 radio** 추가
|
||||
- 옵션: `법인카드` / `계좌이체`
|
||||
- **일괄 선택** 방식 (전체 구매건에 하나의 지급방법)
|
||||
|
||||
### 2. 비용정산품의서 (pr_settlement) - 지급방법 행별 변경
|
||||
|
||||
- 기존: 테이블 아래에 일괄 radio (법인카드/개인선지출)
|
||||
- 변경: 각 내역행에 **지급방법 select** 컬럼 추가
|
||||
- 테이블 하단에 **지급방법별 합계표** 추가 (법인카드 합계 / 개인선지출 합계)
|
||||
- 이유: 하나의 정산서에 법인카드/개인선지출 내역이 혼재할 수 있음
|
||||
|
||||
### 3. 지출품의서 (pr_expense) - 라벨 변경
|
||||
|
||||
- `사용일자` -> `지출일자` 라벨 변경 (폼 + 조회 화면)
|
||||
|
||||
## 수정된 파일
|
||||
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `mng/resources/views/approvals/partials/_purchase-request-form.blade.php` | 구매품의서 지급방법 radio 추가, 비용정산품의서 행별 select + 합계표, 지출일자 라벨 변경 |
|
||||
| `mng/resources/views/approvals/partials/_purchase-request-show.blade.php` | 구매품의서/비용정산품의서 조회 화면 동기화 |
|
||||
|
||||
## Alpine.js 데이터 변경
|
||||
|
||||
### 구매품의서
|
||||
|
||||
```javascript
|
||||
// formData에 추가
|
||||
payment_method: initialData?.payment_method || '',
|
||||
|
||||
// getFormData()에 포함
|
||||
{ ...base, ..., payment_method: this.formData.payment_method }
|
||||
```
|
||||
|
||||
### 비용정산품의서
|
||||
|
||||
```javascript
|
||||
// makeItem()에 추가
|
||||
payment_method: data?.payment_method || '',
|
||||
|
||||
// computed 속성 추가
|
||||
get corporateCardTotal() { /* corporate_card 행만 합산 */ },
|
||||
get personalAdvanceTotal() { /* personal_advance 행만 합산 */ },
|
||||
|
||||
// getFormData() 변경
|
||||
// 기존: payment_method: this.formData.payment_method (일괄)
|
||||
// 변경: 각 item.payment_method (행별) + corporate_card_total, personal_advance_total
|
||||
```
|
||||
|
||||
## 관련 문서
|
||||
|
||||
- [결재 양식 기술 명세](../features/approvals/form-types.md) - 섹션 12, 14 업데이트
|
||||
|
||||
---
|
||||
|
||||
**최종 업데이트**: 2026-03-06
|
||||
42
contracts/CHANGELOG.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# 계약서 개정이력
|
||||
|
||||
> **작성일**: 2026-02-22
|
||||
> **관리 대상**: 전자계약 DOCX 4종
|
||||
|
||||
---
|
||||
|
||||
## v4.1 (2026-02-22)
|
||||
|
||||
**작성자**: 개발팀
|
||||
**대상**: 고객사 서비스 이용계약서
|
||||
|
||||
- 제4조에 사용량 기반 추가 과금 조항(4.5) 추가
|
||||
- 파일 저장 공간: 기본 100GB 초과 시 100GB당 100,000원/월
|
||||
- AI 토큰: 월 100만 토큰 기본, 초과 시 1,000토큰 단위 실비 과금
|
||||
- 제4조에 바로빌 부가 서비스 요금 조항(4.6) 추가
|
||||
- 계좌조회, 카드내역, 세금계산서 발행 요금 명시
|
||||
- 홈택스 매입/매출 조회는 회사 부담 명시
|
||||
|
||||
---
|
||||
|
||||
## v4.0 (2026-02-22)
|
||||
|
||||
**작성자**: 개발팀
|
||||
|
||||
- 계약서 버전 관리 시스템 도입
|
||||
- DOCX → Markdown 미러링 체계 구축
|
||||
- 4개 전자계약 문서에 개정이력 테이블 삽입
|
||||
- 동기화 검증 스크립트 구축
|
||||
|
||||
### 대상 문서
|
||||
|
||||
| 파일 | 문서명 |
|
||||
|------|--------|
|
||||
| `01_고객_서비스이용계약서_v4_0_전자서명용.docx` | 고객사 서비스 이용계약서 |
|
||||
| `비밀유지서약서.docx` | 비밀유지서약서 (NDA) |
|
||||
| `영업파트너 위촉계약서.docx` | 영업파트너 위촉계약서 |
|
||||
| `영업파트너 위촉계약서(단체용).docx` | 영업파트너 위촉계약서 (단체용) |
|
||||
|
||||
---
|
||||
|
||||
**최종 업데이트**: 2026-02-22 (v4.1)
|
||||
BIN
contracts/docx/01_고객_서비스이용계약서_v4_0_전자서명용.docx
Normal file
BIN
contracts/docx/비밀유지서약서.docx
Executable file
BIN
contracts/docx/영업파트너 위촉계약서(단체용).docx
Executable file
BIN
contracts/docx/영업파트너 위촉계약서.docx
Executable file
458
contracts/markdown/01-service-agreement.md
Normal file
@@ -0,0 +1,458 @@
|
||||
---
|
||||
title: "고객사 서비스 이용계약서"
|
||||
version: "v4.2"
|
||||
date: "2026-02-24"
|
||||
docx_file: "01_고객_서비스이용계약서_v4_0_전자서명용.docx"
|
||||
---
|
||||
|
||||
# 고객사 서비스 이용계약서
|
||||
|
||||
Customer Service Agreement
|
||||
|
||||
계약번호:
|
||||
계약일:
|
||||
|
||||
본 계약은 주식회사 코드브릿지엑스(이하 “회사”)와 간에 SAM 서비스 제공과 관련하여 다음과 같이 계약을 체결합니다.
|
||||
|
||||
## 제1조 (계약의 목적)
|
||||
|
||||
본 계약은 회사가 고객에게 SAM(Smart MES/ERP Solution) 서비스를 제공함에 있어 필요한 사항을 규정하고, 양측의 권리와 의무를 명확히 함을 목적으로 합니다.
|
||||
|
||||
## 제2조 (용어의 정의)
|
||||
|
||||
- **서비스**: 회사가 제공하는 SAM 클라우드 기반 MES/ERP 솔루션
|
||||
- **SaaS**: Software as a Service (서비스형 소프트웨어)
|
||||
- **서비스 게시**: 개발 완료 후 고객이 서비스에 접근 가능하도록 제공하는 것
|
||||
- **액세스 제공**: 고객에게 서비스 사용 권한을 부여하는 것
|
||||
- **검수 기간**: 서비스 게시 전 고객이 완성도를 확인하는 기간 (최대 1개월)
|
||||
- **하자**: 계약서에 명시된 기능의 오류, 미구현, 성능 미달 등
|
||||
- **하자담보 책임**: 서비스 게시 후 1년간 하자를 무상으로 수정하는 의무
|
||||
|
||||
## 제3조 (서비스 내용)
|
||||
|
||||
### 3.1 서비스 범위
|
||||
|
||||
회사는 다음의 서비스를 제공합니다:
|
||||
- **맞춤형 개발**:
|
||||
- 고객 요구사항에 맞춘 SAM 시스템 개발
|
||||
- 개발 범위: [별첨 기획서 참조]
|
||||
- 개발 기간: 계약일로부터 [ 3 ]개월
|
||||
- **클라우드 제공** (SaaS):
|
||||
- 연중무휴 24시간 접근 가능
|
||||
- 자동 백업 및 보안
|
||||
- **기술 지원**:
|
||||
- 고객센터 운영 (평일 09:00~18:00)
|
||||
- 이메일 지원 (24시간)
|
||||
- 긴급 장애 대응
|
||||
- **하자담보 책임** (1년):
|
||||
- 서비스 게시일로부터 1년간 무상 수정
|
||||
- 버그, 미구현 기능, 성능 개선 등
|
||||
|
||||
### 3.2 제공 방식
|
||||
|
||||
- 회사는 서비스를 **SaaS 방식**으로 제공합니다.
|
||||
- 고객은 서비스에 대한 **사용 권한**만을 부여받으며, 소유권은 회사에 귀속됩니다.
|
||||
- 소스코드는 제공되지 않습니다.
|
||||
|
||||
## 제4조 (비용 및 납부)
|
||||
|
||||
### 4.1 개발비
|
||||
|
||||
| 구분 | 금액 (부가세 별도) | 지급 시기 | 비고 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1차 개발비 | 총 개발비의 50% | 계약 체결 시 | 착수금 |
|
||||
| 2차 개발비 | 총 개발비의 50% | 서비스 게시일로부터 3일 이내 | 잔금 |
|
||||
| 총 개발비 | [ ]원 | | |
|
||||
|
||||
### 4.2 월 구독료
|
||||
|
||||
| 구분 | 금액 (부가세 별도) | 지급 시기 | 비고 |
|
||||
| --- | --- | --- | --- |
|
||||
| 월 구독료 | 원 ~ | 매월 말일 | 후불제, 사용량 기준 청구 |
|
||||
|
||||
> ⚠️ 중요: - 월 구독료는 원이며, 영업 협상 및 개발 범위에 따라 증액될 수 있습니다.
|
||||
|
||||
- 계약 시 확정된 구독료: [ ]원/월
|
||||
|
||||
### 4.3 납부 방법
|
||||
|
||||
- **개발비**:
|
||||
- 계좌이체 (세금계산서 발행)
|
||||
- 입금 계좌: 기업은행 170-175519-04-011 (주)코드브릿지엑스
|
||||
- **구독료**:
|
||||
- CMS 자동이체 (권장)
|
||||
- 또는 세금계산서 발행 후 계좌이체
|
||||
|
||||
### 4.4 잔금 지급 기한 [법률 검토 반영]
|
||||
|
||||
- **지급 기한**: 서비스 게시일로부터 **3일 이내**
|
||||
- **사전 준비**: 회사는 영업 단계부터 납품 일정을 공유하여 고객이 미리 준비할 수 있도록 합니다.
|
||||
- **미납 시 조치**: 제13조 참조
|
||||
|
||||
### 4.5 사용량 기반 추가 과금
|
||||
|
||||
기본 제공 한도 초과 시 다음과 같이 실비 과금됩니다.
|
||||
|
||||
| 항목 | 기본 제공 | 추가 과금 기준 |
|
||||
| --- | --- | --- |
|
||||
| 파일 저장 공간 | 100GB | 100GB당 100,000원/월 (부가세 별도) |
|
||||
| AI 토큰 | 월 100만 토큰 | 1,000토큰 단위 실비 과금 |
|
||||
|
||||
- **파일 저장 공간: **기본 100GB를 초과하는 경우 100GB 단위로 월 100,000원(부가세 별도)이 추가 과금됩니다.
|
||||
- **AI 토큰: **월 100만 토큰 기본 제공되며, 초과 사용 시 1,000토큰 단위로 실비 과금됩니다.
|
||||
- 미사용 잔여 토큰은 이월되지 않습니다. (매월 1일 갱신)
|
||||
- 기본 제공량 80%, 100% 소진 시 자동 알림이 발송됩니다.
|
||||
|
||||
### 4.6 바로빌 부가 서비스 요금
|
||||
|
||||
고객이 선택적으로 이용하는 바로빌 연동 서비스의 요금은 다음과 같습니다.
|
||||
|
||||
| 서비스 | 과금 방식 | 기본 제공 | 추가 과금 |
|
||||
| --- | --- | --- | --- |
|
||||
| 계좌조회 | 월정액 10,000원 | 1계좌 | 추가 1계좌당 10,000원 |
|
||||
| 카드내역 | 월정액 10,000원 | 5장 | 추가 1장당 5,000원 |
|
||||
| 세금계산서 발행 | 건별 | 100건 | 추가 50건당 5,000원 |
|
||||
|
||||
- **바로빌 서비스 요금은 고객이 부담하며, 월 구독료와 별도로 청구됩니다.**
|
||||
- 홈택스 매입/매출 조회 서비스(월 30,000원)는 회사가 부담합니다.
|
||||
- 상기 금액은 부가세 별도입니다.
|
||||
|
||||
## 제5조 (마일스톤 및 진행 일정)
|
||||
|
||||
### 5.1 개발 단계 (5단계 통일)
|
||||
|
||||
| 단계 | 주요 활동 | 진행률 | 기간 | 납부 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| M1 | 요구사항 분석 및 기획 | 20% | [ 2 ]주 | 1차 개발비 (착수금 50%) |
|
||||
| M2 | 설계 및 개발 착수 | 50% | [ 2 ]주 | - |
|
||||
| M3 | 개발 진행 (50% 완료) | 60% | [ 2 ]주 | - |
|
||||
| M4 | 개발 완료 및 테스트 | 80% | [ 2 ]주 | - |
|
||||
| M5 | 검수 및 서비스 게시 | 100% | 최대 2주 | 2차 개발비 (잔금 50%) |
|
||||
|
||||
> ⚠️ 중요: - 5단계 마일스톤으로 통일 관리 - M5 검수 완료 후 서비스 게시 - 서비스 게시일로부터 3일 이내 잔금 납부
|
||||
|
||||
### 5.2 일정 조정
|
||||
|
||||
- 개발 일정은 고객의 협조에 따라 변동될 수 있습니다.
|
||||
- 고객 귀책 사유로 인한 지연은 회사의 책임이 아닙니다.
|
||||
- 불가항력으로 인한 지연 시 양측 협의하여 일정을 조정합니다.
|
||||
|
||||
## 제6조 (서비스 게시 및 검수)
|
||||
|
||||
### 6.1 서비스 게시
|
||||
|
||||
- 회사는 개발 완료 후 고객에게 **서비스 게시**를 통지합니다.
|
||||
- **서비스 게시일**은 고객이 서비스에 접근 가능한 날짜를 의미합니다.
|
||||
- 서비스 게시일부터 구독료가 발생합니다.
|
||||
|
||||
### 6.2 검수 기간
|
||||
|
||||
- 고객은 개발 완료 후 **최대 2주간 검수 기간**을 가집니다.
|
||||
- 검수 기간은 서비스 게시 **전**에 이루어집니다.
|
||||
- 검수 기간 중 발견된 하자는 회사가 무상으로 수정합니다.
|
||||
|
||||
### 6.3 검수 완료
|
||||
|
||||
- 고객이 서면으로 검수 완료를 통지하거나,
|
||||
- 검수 기간 2주 종료 시점에 특별한 이의가 없으면 자동 승인으로 간주합니다.
|
||||
- 검수 완료 후 서비스 게시일이 확정되고, 하자담보 책임 정책이 적용됩니다.
|
||||
|
||||
## 제7조 (하자담보 책임)
|
||||
|
||||
### 7.1 책임 기간
|
||||
|
||||
서비스 게시일로부터 1년 (소프트웨어산업진흥법 제16조, 민법 제667조)
|
||||
|
||||
### 7.2 하자담보 범위 (무상 처리)
|
||||
|
||||
| 항목 | 내용 | 예시 |
|
||||
| --- | --- | --- |
|
||||
| 버그 수정 | 소프트웨어 오류 | 계산 오류, 기능 미작동 |
|
||||
| 미구현 기능 | 계약서에 명시된 기능 누락 | 약속된 기능 미구현 |
|
||||
| 성능 개선 | 명시된 성능 기준 미달 | 속도 저하, 응답 지연 |
|
||||
| UI/UX 수정 | 사용성 문제 | 버튼 미작동, 화면 깨짐 |
|
||||
| 데이터 오류 | 데이터 손실 또는 오류 | 데이터 삭제, 중복 생성 |
|
||||
| 보안 패치 | 보안 취약점 수정 | 해킹 방지, 암호화 |
|
||||
|
||||
### 7.3 제외 사항 (별도 비용)
|
||||
|
||||
| 항목 | 내용 | 예시 |
|
||||
| --- | --- | --- |
|
||||
| 신규 기능 개발 | 계약서에 없던 새 기능 | 새로운 모듈, 기능 확장 |
|
||||
| 구조 변경 | 시스템 아키텍처 변경 | DB 구조, 프레임워크 교체 |
|
||||
| 추가 모듈 | 새로운 모듈 개발 | 회계 모듈, 재고 모듈 |
|
||||
| 기획 변경 | 초기 기획과 다른 요구사항 | 화면 구성, 프로세스 변경 |
|
||||
| 교육/컨설팅 | 사용자 교육, 업무 컨설팅 | 직원 교육, 프로세스 개선 |
|
||||
|
||||
### 7.4 하자 처리 절차
|
||||
|
||||
| 단계 | 내용 | 기간 |
|
||||
| --- | --- | --- |
|
||||
| 1. 하자 신고 | 고객이 이메일로 하자 신고 | - |
|
||||
| 2. 하자 확인 | 회사가 하자 여부 판정 | 3영업일 |
|
||||
| 3. 수정 작업 | 하자 인정 시 무상 수정 | 7영업일 |
|
||||
| 4. 검수 완료 | 고객이 수정 사항 확인 | - |
|
||||
|
||||
> ⚠️ 긴급 하자 (서비스 중단)는 24시간 이내 조치합니다.
|
||||
|
||||
### 7.5 책임 면제 사유
|
||||
|
||||
다음의 경우 하자담보 책임이 면제됩니다:
|
||||
- **고객 귀책 사유**:
|
||||
- 고객의 임의 수정 또는 변경
|
||||
- 승인되지 않은 제3자 개입
|
||||
- 사용 환경 미준수
|
||||
- **불가항력**:
|
||||
- 천재지변 (지진, 태풍 등)
|
||||
- 전쟁, 테러, 전염병
|
||||
- 정부 규제 또는 법령 변경
|
||||
- **기간 만료**:
|
||||
- 서비스 게시일로부터 1년 경과
|
||||
|
||||
## 제8조 (계약 해제 및 환불)
|
||||
|
||||
### 8.1 환불 정책 개요
|
||||
|
||||
고객의 임의 해제 권리와 회사의 투입 비용 보전의 균형을 고려하여 수립되었습니다.
|
||||
|
||||
### 8.2 단계별 환불
|
||||
|
||||
### Phase 1: 상담(인터뷰) 시작 전
|
||||
|
||||
- **환불율**: 100% (전액 환불)
|
||||
- **조건**: 계약 후 상담(인터뷰) 배정 전
|
||||
- **위약금**: 없음
|
||||
- **임의 해제 가능**
|
||||
|
||||
### Phase 2: 상담(인터뷰) 시작 후, 개발 착수 전
|
||||
|
||||
| 진행 상황 | 환불율 | 공제 내역 |
|
||||
| --- | --- | --- |
|
||||
| M1: 기획안 작성 중 (50% 미만) | 80% | 상담매니저 및 기획/개발자 투입 비용 20% 공제 |
|
||||
| M2: 기획안 완료 (50% 이상) | 50% | 상담매니저 및 기획/개발자 투입 비용 50% 공제 |
|
||||
|
||||
### Phase 3: 개발 진행 중 (5단계 마일스톤 기준)
|
||||
|
||||
| 마일스톤 | 진행률 | 청구 금액(개발비 대비) | 비고 |
|
||||
| --- | --- | --- | --- |
|
||||
| M3: 개발 진행 중 (50%) | 70% | 70% | 30% 환불 |
|
||||
| M4: 개발 완료 및 테스트 | 90% | 90% | 10% 환불 |
|
||||
| M5: 서비스 개시 완료 | 100% | 100% | 환불 불가 |
|
||||
|
||||
> ⚠️ 중요: 5단계 마일스톤으로 통일 관리
|
||||
|
||||
### Phase 4: 서비스 게시 후
|
||||
|
||||
- **환불율**: 0% (환불 불가)
|
||||
- **개발비**: 전액 확정, 환불 불가
|
||||
- **구독료**: 매월 말일 후불제이므로 사용한 만큼만 청구 (환불 개념 없음)
|
||||
- **대신 제공**: 하자담보 책임 (1년) + 유지보수 (구독 기간 전체)
|
||||
|
||||
### 8.3 환불 불가 사유
|
||||
|
||||
- **고객 귀책 사유**:
|
||||
- 협조 지연으로 인한 개발 지연
|
||||
- 요구사항 변경으로 인한 추가 개발
|
||||
- 승인 거부 또는 회피
|
||||
- **약관 위반**:
|
||||
- 허위 정보 제공
|
||||
- 부정 사용 또는 재판매
|
||||
- 회사 명예 훼손
|
||||
|
||||
### 8.4 할인 계약 해지 시 추가 조건
|
||||
|
||||
본 계약이 정상가 대비 할인 조건으로 체결된 경우, 다음 조건이 추가 적용된다.
|
||||
|
||||
- 발주자 귀책 해지 시 정상가(할인 전 금액) 기준으로 정산한다.
|
||||
|
||||
## 제9조 (구독 및 해지)
|
||||
|
||||
### 9.1 구독 시작
|
||||
|
||||
- **시작일**: 서비스 게시일 (검수 완료 후)
|
||||
- **결제일**: 매월 말일
|
||||
- **청구 방식**: 후불제 (해당 월 사용량 기준)
|
||||
- **일할 계산**: (사용 일수 / 해당 월 일수) × 구독료
|
||||
|
||||
> ⚠️ 중요: - 계약 시 확정된 구독료 금액은 [ ]원/월입니다.
|
||||
|
||||
- 매월 말일에 해당 월 사용일수만큼만 후불 청구됩니다.
|
||||
|
||||
### 9.2 구독 해지
|
||||
|
||||
- 고객은 언제든지 구독을 해지할 수 있습니다. (위약금 없음)
|
||||
- 해지 신청 후 30일간 데이터 백업 기간 제공
|
||||
- 해지일로부터 30일 후 모든 데이터 완전 삭제
|
||||
|
||||
## 제10조 (유지보수 정책)
|
||||
|
||||
### 10.1 유지보수 개요
|
||||
|
||||
- **적용 대상**: 구독료를 정상 납부하는 고객
|
||||
- **적용 기간**: 구독 기간 전체 (하자담보 책임 1년 이후에도 구독 중이면 계속 제공)
|
||||
- **비용**: 월 구독료(500,000원)에 포함
|
||||
|
||||
### 10.2 하자담보 책임과의 차이
|
||||
|
||||
| 구분 | 하자담보 책임 (제7조) | 유지보수 (제9조의2) |
|
||||
| --- | --- | --- |
|
||||
| 기간 | 서비스 게시일로부터 1년 | 구독 기간 전체 |
|
||||
| 근거 | 법적 의무 (소프트웨어산업진흥법) | 계약 조건 |
|
||||
| 비용 | 무상 | 구독료에 포함 |
|
||||
| 범위 | 하자(버그, 미구현 등) | 하자 + 일반 유지보수 |
|
||||
|
||||
### 10.3 유지보수 범위 (구독료에 포함)
|
||||
|
||||
> ✅ 무상 제공: - 모든 버그 수정 및 오류 처리 - 보안 패치 및 업데이트 - 성능 최적화 - 긴급 장애 대응 (24시간 이내) - 데이터 백업 및 복구 - 기술 지원 (고객센터, 이메일) - 플랫폼 업데이트 (프레임워크, 브라우저 호환성)
|
||||
|
||||
> ❌ 별도 비용: - 신규 기능 개발 - 커스터마이징 및 추가 개발 - 기획 변경 (화면 구성, 프로세스 변경) - 외부 시스템 연동 - 추가 교육 및 컨설팅
|
||||
|
||||
### 10.4 서비스 레벨 (SLA)
|
||||
|
||||
| 심각도 | 상황 | 응답 시간 | 해결 목표 |
|
||||
| --- | --- | --- | --- |
|
||||
| 긴급 (P0) | 서비스 완전 중단 | 1시간 | 24시간 |
|
||||
| 높음 (P1) | 주요 기능 장애 | 4시간 | 3영업일 |
|
||||
| 보통 (P2) | 일반 버그 | 1영업일 | 7영업일 |
|
||||
| 낮음 (P3) | 문의/안내 | 1영업일 | 3영업일 |
|
||||
|
||||
### 10.5 정기 유지보수
|
||||
|
||||
- **월간**: 보안 패치, 백업 점검 (매월 첫째 주 일요일 새벽)
|
||||
- **분기**: 성능 최적화 (분기 말 일요일 새벽)
|
||||
- **반기**: 시스템 점검 (6월/12월 일요일 새벽)
|
||||
|
||||
> ⚠️ 모든 정기 점검은 최소 7일 전 사전 공지됩니다.
|
||||
|
||||
### 10.6 유지보수 신청
|
||||
|
||||
- **고객센터**: 02-6347-0005 (평일 09:00~18:00 )
|
||||
- **이메일**: support@codebridge-x.com (24시간)
|
||||
- **시스템 내**: SAM 시스템 내 고객지원 메뉴
|
||||
|
||||
### 10.7 유지보수 종료
|
||||
|
||||
다음의 경우 유지보수 서비스가 종료됩니다: 1. 구독 해지 시 2. 구독료 3개월 연속 미납 시 3. 중대한 약관 위반 시
|
||||
|
||||
## 제11조 (고객의 의무)
|
||||
|
||||
고객은 다음 사항을 준수해야 합니다:
|
||||
- **정확한 정보 제공**: 허위 정보 제공 금지
|
||||
- **협조 의무**: 개발에 필요한 자료 및 정보 제공
|
||||
- **부정 사용 금지**: 서비스의 재판매, 재배포 금지
|
||||
- **지적재산권 존중**: 무단 복제, 역설계 금지
|
||||
|
||||
## 제12조 (회사의 의무)
|
||||
|
||||
회사는 다음 사항을 준수합니다:
|
||||
- **서비스 제공**: 계약서에 명시된 서비스 제공
|
||||
- **하자담보 책임**: 1년간 하자 무상 수정
|
||||
- **개인정보 보호**: 개인정보보호법 준수
|
||||
- **기술 지원**: 고객센터 운영 및 기술 지원
|
||||
|
||||
## 제13조 (미입금 시 법적 조치)
|
||||
|
||||
### 13.1 개발비 미입금 절차
|
||||
|
||||
| 단계 | 시점 | 조치 내용 |
|
||||
| --- | --- | --- |
|
||||
| 1차 독촉 | 기한 경과 후 3일 | 이메일 및 SMS 발송 |
|
||||
| 내용증명 | 기한 경과 후 7일 | 우편 발송, 7일 내 입금 요청 |
|
||||
| 추심등 | 기한 경과 후 14일 | 신용정보사 연체 등록, 법률대리인 위임 |
|
||||
| 법적 조치 | 기한 경과 후 30일 | 지급명령 신청 또는 소송 제기 |
|
||||
|
||||
### 13.2 구독료 미입금 절차
|
||||
|
||||
| 단계 | 시점 | 조치 내용 |
|
||||
| --- | --- | --- |
|
||||
| 1차 실패 | 익일 | 재출금 |
|
||||
| 2차 실패 | 기한 경과 후 3일 | 재출금 |
|
||||
| 3차 실패 | 미수금 처리 | 서비스 접근 제한, 1차 독촉 |
|
||||
| 내용증명 | 기한 경과 후 7일 | 우편 발송, 7일 내 입금 요청 |
|
||||
| 서비스 중단 | 기한 경과 후 14일 | 로그인 불가, 데이터 격리 |
|
||||
| 강제 해지 | 기한 경과 후 30일 | 계약 해지, 법적 조치 검토 |
|
||||
|
||||
## 제14조 (개인정보 보호)
|
||||
|
||||
- 회사는 「개인정보 보호법」을 준수합니다.
|
||||
- 고객의 개인정보는 서비스 제공 목적으로만 사용됩니다.
|
||||
- 제3자에게 제공하지 않습니다. (법령 제외)
|
||||
- 계약 종료 시 개인정보는 즉시 삭제됩니다. (법정 보관 의무 제외)
|
||||
|
||||
## 제15조 (지적재산권)
|
||||
|
||||
- **소유권**: 서비스에 대한 모든 지적재산권은 회사에 귀속됩니다.
|
||||
- **사용 권한**: 고객은 서비스 사용 권한만을 부여받습니다.
|
||||
- **금지 사항**: 복제, 배포, 역설계, 재판매 금지
|
||||
|
||||
## 제16조 (손해배상)
|
||||
|
||||
- 회사 또는 고객이 본 계약을 위반하여 상대방에게 손해를 입힌 경우 배상 책임이 있습니다.
|
||||
- 다만, 불가항력으로 인한 손해는 배상 책임에서 제외됩니다.
|
||||
|
||||
## 제17조 (불가항력)
|
||||
|
||||
다음의 사유로 서비스 제공이 불가능한 경우 회사는 책임을 지지 않습니다:
|
||||
- 천재지변 (지진, 태풍, 홍수 등)
|
||||
- 전쟁, 테러, 전염병
|
||||
- 정부 규제 또는 법령 변경
|
||||
- 제3자의 불법 행위 (해킹 등)
|
||||
|
||||
## 제18조 (분쟁 해결)
|
||||
|
||||
- 본 계약과 관련한 분쟁은 상호 협의하여 해결합니다.
|
||||
- 협의가 이루어지지 않을 경우, **서울중앙지방법원**을 관할 법원으로 합니다.
|
||||
|
||||
## 제19조 (계약의 효력)
|
||||
|
||||
- 본 계약은 계약일로부터 효력이 발생합니다.
|
||||
- 본 계약은 구독 해지 시까지 유효합니다.
|
||||
|
||||
## 제20조 (기타)
|
||||
|
||||
- 본 계약서는 2부 작성하여 회사와 고객이 각 1부씩 보관합니다.
|
||||
- 본 계약의 해석 및 적용은 대한민국 법률을 준거법으로 합니다.
|
||||
|
||||
## 계약 당사자
|
||||
|
||||
### [회사]
|
||||
|
||||
상호: 주식회사 코드브릿지엑스
|
||||
대표자: 이의찬
|
||||
사업자등록번호: 664-86-03713
|
||||
주소: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
이메일: contact@codebridge-x.com
|
||||
전화: 02-6347-0005
|
||||
서명:
|
||||
날짜:
|
||||
|
||||
### [고객]
|
||||
|
||||
상호:
|
||||
대표자:
|
||||
사업자등록번호:
|
||||
주소:
|
||||
이메일:
|
||||
전화:
|
||||
서명:
|
||||
날짜:
|
||||
|
||||
## 별첨
|
||||
|
||||
### 별첨 1: 기획서
|
||||
|
||||
[별도 첨부]
|
||||
|
||||
### 별첨 2: 개발 일정표
|
||||
|
||||
[별도 첨부]
|
||||
|
||||
### 별첨 3: 기능 명세서
|
||||
|
||||
[별도 첨부]
|
||||
|
||||
주식회사 코드브릿지엑스
|
||||
이메일: contact@codebridge-x.com
|
||||
전화: 02-6347-0005
|
||||
주소: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
|
||||
199
contracts/markdown/02-nda.md
Normal file
@@ -0,0 +1,199 @@
|
||||
---
|
||||
title: "비밀유지서약서 (NDA)"
|
||||
version: "v4.0"
|
||||
date: "2026-02-22"
|
||||
docx_file: "비밀유지서약서.docx"
|
||||
---
|
||||
|
||||
# 비밀유지서약서 (NDA)
|
||||
|
||||
- **작성일**:
|
||||
|
||||
- **서약인 정보**
|
||||
- **구분**:
|
||||
|
||||
- **인적 사항:**
|
||||
상호(성명): _______________
|
||||
대표자(본인): _______________
|
||||
사업자등록번호(주민등록번호): ____________________
|
||||
주소: ______________________________________________________________________
|
||||
연락처: _______________
|
||||
이메일: _______________
|
||||
|
||||
## 제1조 (목적)
|
||||
|
||||
- 본 서약서는 주식회사 코드브릿지(이하 “회사”)와의 업무 관계에서 알게 된 기밀 정보를
|
||||
- 보호하기 위해 작성되었습니다.
|
||||
|
||||
## 제2조 (기밀 정보의 정의)
|
||||
|
||||
- 다음 각 호의 정보는 회사의 기밀 정보로 간주됩니다:
|
||||
|
||||
### 2.1 고객 정보
|
||||
|
||||
- 고객사 명단 (법인명, 대표자명, 연락처)
|
||||
- 고객사 담당자 정보 (성명, 부서, 연락처, 이메일)
|
||||
- 계약 내역 (가입비, 할인율, 구독료, 특약 사항)
|
||||
- 고객사의 사업 정보 (매출, 직원 수, 거래처 등)
|
||||
- 고객사가 회사에 요구한 개발 내역 및 기획 문서
|
||||
|
||||
### 2.2 영업 정보
|
||||
|
||||
- 가격 정책 (정가, 할인 정책, 최소 가입비)
|
||||
- 수수료 정책 (비율, 지급 기준, 상계 방식)
|
||||
- 영업 전략 및 마케팅 계획
|
||||
- 잠재 고객 리스트
|
||||
- 계약 체결 노하우 및 제안서 템플릿
|
||||
|
||||
### 2.3 기술 정보
|
||||
|
||||
- SAM 시스템의 소스코드
|
||||
- 데이터베이스 구조 및 설계 문서
|
||||
- 개발 프로세스 및 방법론
|
||||
- 서버 인프라 구성 및 보안 정책
|
||||
- API 키, 접속 정보, 관리자 권한
|
||||
|
||||
### 2.4 경영 정보
|
||||
|
||||
- 회사의 재무 정보 (매출, 이익, 원가)
|
||||
- 조직도 및 인사 정보
|
||||
- 사업 계획 및 전략
|
||||
- 투자 유치 및 M&A 관련 정보
|
||||
|
||||
### 2.5 기타
|
||||
|
||||
- 회사가 **“기밀(Confidential)”** 또는 **“대외비”**로 표시한 모든 문서 및 정보
|
||||
|
||||
## 제3조 (기밀 유지 의무)
|
||||
|
||||
### 3.1 기본 의무
|
||||
|
||||
- 본인은 업무 수행 중 알게 된 모든 기밀 정보를:
|
||||
- **외부에 누설하지 않습니다**
|
||||
- **업무 목적 외에 사용하지 않습니다**
|
||||
- **무단으로 복사, 복제, 전송하지 않습니다**
|
||||
- **제3자에게 제공하거나 공개하지 않습니다**
|
||||
|
||||
### 3.2 정보 관리
|
||||
|
||||
- 기밀 문서는 안전한 장소에 보관
|
||||
- 이메일, 메신저 등 전송 시 암호화
|
||||
- 업무 종료 시 모든 기밀 자료 반환 또는 파기
|
||||
- 개인 디바이스에 기밀 정보 저장 금지
|
||||
|
||||
### 3.3 제3자 접근 차단
|
||||
|
||||
- 가족, 친구 등 타인이 기밀 정보에 접근하지 못하도록 조치
|
||||
- 공공장소(카페, 도서관 등)에서 기밀 정보 취급 금지
|
||||
- 비밀번호 및 접속 정보 타인 공유 금지
|
||||
|
||||
## 제4조 (예외 사항)
|
||||
|
||||
- 다음의 정보는 기밀 정보에서 제외됩니다:
|
||||
- 본인이 알기 전에 이미 공개된 정보
|
||||
- 본인의 귀책사유 없이 공개된 정보
|
||||
- 제3자로부터 적법하게 취득한 정보
|
||||
- 본인이 독자적으로 개발한 정보
|
||||
- 법원, 정부기관의 법적 요구에 따라 공개해야 하는 정보 (단, 회사에 사전 통지 필수)
|
||||
|
||||
## 제5조 (의무 기간)
|
||||
|
||||
### 5.1 기간
|
||||
|
||||
- 본 서약서의 기밀 유지 의무는:
|
||||
- **계약 체결일로부터 효력 발생**
|
||||
- **계약 종료 후 2년간 유지**
|
||||
|
||||
### 5.2 영구 보호
|
||||
|
||||
- 단, 다음 정보는 **영구적으로** 보호됩니다:
|
||||
- 고객사 개인정보
|
||||
- 회사의 영업 비밀 (부정경쟁방지법상 영업 비밀)
|
||||
- 기술 정보 (특허, 저작권 대상)
|
||||
|
||||
## 제6조 (위반 시 책임)
|
||||
|
||||
### 6.1 민사 책임
|
||||
|
||||
- 본인이 본 서약을 위반하여 회사 또는 고객에게 손해를 입힌 경우:
|
||||
- **실손해**** 배상**: 실제 발생한 손해 전액
|
||||
- **징벌적 손해배상**: 실손해의 최대 3배 (악의적 유출 시)
|
||||
- **법률 비용**: 소송 비용, 변호사 비용 등
|
||||
|
||||
### 6.2 형사 책임
|
||||
|
||||
- 다음의 경우 형사 고발 대상이 됩니다:
|
||||
- **부정경쟁방지법** 위반 (영업 비밀 침해)
|
||||
- **개인정보보호법** 위반 (고객 정보 유출)
|
||||
- **정보통신망법** 위반 (기술 정보 침해)
|
||||
- **형법** 위반 (업무상 배임)
|
||||
- **※ 형사 처벌: 5년 이하 징역 또는 5천만원 이하 벌금**
|
||||
|
||||
### 6.3 계약 해지
|
||||
|
||||
- 회사는 본 서약 위반 시 즉시 계약을 해지할 수 있으며, 이미 지급한 수수료 또는
|
||||
- 대금을 환수할 수 있습니다.
|
||||
|
||||
## 제7조 (자료 반환)
|
||||
|
||||
### 7.1 반환 대상
|
||||
|
||||
- 계약 종료 또는 요청 시 다음을 즉시 반환해야 합니다:
|
||||
- 회사로부터 제공받은 모든 문서 (종이, 파일)
|
||||
- 고객사 계약서 및 개인정보
|
||||
- 가격표, 제안서, 템플릿 등 영업 자료
|
||||
- USB, 하드디스크 등 저장 매체
|
||||
|
||||
### 7.2 파기 확인
|
||||
|
||||
- 반환 불가능한 파일(이메일, 클라우드 등)은 즉시 삭제하고, **삭제 확인서**를 회사에
|
||||
- 제출해야 합니다.
|
||||
|
||||
## 제8조 (경업 금지)
|
||||
|
||||
### 8.1 경업 금지 기간
|
||||
|
||||
- 계약 종료 후 **6개월간** 다음 행위를 금지합니다:
|
||||
- 회사의 고객에게 경쟁 제품 판매
|
||||
- 회사의 기밀 정보를 이용한 유사 사업
|
||||
- 회사 직원 또는 영업파트너를 스카우트
|
||||
|
||||
### 8.2 예외
|
||||
|
||||
- 단순히 경쟁사 제품을 판매하는 것은 허용되나, 회사의 기밀 정보를 활용해서는
|
||||
- 안 됩니다.
|
||||
|
||||
## 제9조 (분쟁 해결)
|
||||
|
||||
### 9.1 관할 법원
|
||||
|
||||
- 본 서약과 관련된 분쟁은 회사 본사 소재지 관할 법원으로 합니다.
|
||||
|
||||
### 9.2 준거법
|
||||
|
||||
- 본 서약은 대한민국 법률에 따라 해석됩니다.
|
||||
|
||||
- **서약 확인**
|
||||
- 본인은 위 내용을 충분히 이해하였으며, 이를 성실히 준수할 것을 서약합니다.
|
||||
- **서약일**: ___________________
|
||||
- **서약인**
|
||||
상호(성명): _______________
|
||||
대표자(본인): _______________
|
||||
주민등록번호(또는 사업자등록번호): _______________
|
||||
- **서명 또는 인**: _______________
|
||||
|
||||
- **수령인 (주식회사 ****코드브릿지엑스****)**
|
||||
- 대표이사: 이의찬
|
||||
- **확인****일**: ___________________
|
||||
- **서명 또는 인**: _______________
|
||||
|
||||
- **참고: 관련 법률**
|
||||
- **부정경쟁방지법 제2조 (영업비밀)**
|
||||
- “영업비밀”이란 공공연히 알려져 있지 아니하고 독립된 경제적 가치를 가지는 것으로서,
|
||||
- 비밀로 관리된 생산방법, 판매방법, 그 밖에 영업활동에 유용한 기술상 또는 경영상의
|
||||
- 정보를 말한다.
|
||||
- **부정경쟁방지법 제18조 (벌칙)**
|
||||
- 영업비밀을 외국에서 사용하거나 외국에서 사용되게 할 목적으로 취득·사용 또는 제3자에게 누설한 자는 **15년 이하의 징역** 또는 **15억원 이하의 벌금**에 처한다.
|
||||
|
||||
- **※ 본 서약서는 2부를 작성하여 회사와 서약인이 각 1부씩 보관합니다.**
|
||||
- **※ 서약 위반 시 민·형사상 책임을 질 수 있습니다.**
|
||||
276
contracts/markdown/03-partner-agreement.md
Normal file
@@ -0,0 +1,276 @@
|
||||
---
|
||||
title: "영업파트너 위촉계약서"
|
||||
version: "v4.0"
|
||||
date: "2026-02-22"
|
||||
docx_file: "영업파트너 위촉계약서.docx"
|
||||
---
|
||||
|
||||
# < 영업파트너 위촉계약서 >
|
||||
|
||||
# Sales Partner Engagement Agreement
|
||||
|
||||
- 본 계약은 주식회사 코드브릿지엑스(이하 “회사”)와 (이하 “파트너)간에 SAM 서비스 영업 활동과 관련하여 다음과 같이 위촉계약을 체결합니다.
|
||||
|
||||
## 제1조 (계약의 목적)
|
||||
|
||||
- 본 계약은 회사와 파트너 간의 영업파트너 위촉 관계를 규정하고, 상호 권리와 의무를
|
||||
- 명확히 함을 목적으로 합니다.
|
||||
|
||||
## 제2조 (용어의 정의)
|
||||
|
||||
- **판매자**: 고객을 발굴하고 계약 체결을 주도하는 영업파트너
|
||||
- **관리자**: 판매자를 관리하고 지원하는 상급 영업파트너
|
||||
- **개발비**: 고객이 SAM 서비스 개발을 위해 지급하는 비용
|
||||
- **수수료**: 파트너가 영업 활동의 대가로 받는 보상
|
||||
- **서비스 게시**: 개발 완료 후 고객이 서비스에 접근 가능하도록 제공하는 것
|
||||
|
||||
## 제3조 (파트너의 역할 및 업무)
|
||||
|
||||
### 3.1 판매자의 역할
|
||||
|
||||
- 잠재 고객 발굴 및 초기 접촉
|
||||
- SAM 서비스 소개 및 제안
|
||||
- 고객과의 계약 체결 지원
|
||||
- 계약 후 고객 관리 및 사후 지원
|
||||
|
||||
### 3.2 관리자의 역할
|
||||
|
||||
- 판매자 모집 및 관리
|
||||
- 판매자 교육 및 지원
|
||||
- 영업 전략 수립 및 실행
|
||||
- 회사와 판매자 간 소통 중재
|
||||
|
||||
### 3.3 공통 의무
|
||||
|
||||
- 회사의 브랜드 이미지 유지
|
||||
- 정확한 정보 제공
|
||||
- 윤리적 영업 활동 준수
|
||||
- 비밀 유지 의무
|
||||
|
||||
## 제4조 (수수료 정책)
|
||||
|
||||
### 4.1 수수료 비율
|
||||
|
||||
| 역할 | 수수료 비율 | 산정 기준 |
|
||||
| --- | --- | --- |
|
||||
| 판매자 | 개발비의 20% | 1차,2차 입금액 기준 |
|
||||
| 관리자 | 개발비의 5% | 1차,2차 입금액 기준 |
|
||||
|
||||
### 4.2 수수료 산정 예시
|
||||
|
||||
- **총 개발비 80,000,000원 계약 시**
|
||||
|
||||
| 단계 | 고객 입금 | 판매자 수수료 (20%) | 관리자 수수료 (5%) |
|
||||
| --- | --- | --- | --- |
|
||||
| 1차 착수금 (50%) | 40,000,000원 | 8,000,000원 | 2,000,000원 |
|
||||
| 2차 잔금 (50%) | 40,000,000원 | 8,000,000원 | 2,000,000원 |
|
||||
| 총계 | 80,000,000원 | 16,000,000원 | 4,000,000원 |
|
||||
|
||||
- **⚠️ 중요**: 개발비만 수수료 산정 대상이며, 구독료는 수수료 대상이 아닙니다.
|
||||
|
||||
### 4.3 지급 시기
|
||||
|
||||
- **지급일**: 고객 입금일 **익월 10일**
|
||||
- **지급 방식**: 계좌 이체
|
||||
- **세금**: 3.3% 원천징수 (사업소득)
|
||||
|
||||
### 4.4 수수료 지급 조건
|
||||
|
||||
- 고객이 개발비를 실제로 입금한 경우에만 지급
|
||||
- 계약 해지 또는 환불 시 수수료 미지급 또는 환수
|
||||
- 파트너가 계약 위반 시 수수료 지급 보류
|
||||
|
||||
## 제5조 (수수료 정책 변경)
|
||||
|
||||
### 5.1 사전 고지 의무
|
||||
|
||||
- 회사는 수수료 정책을 변경할 경우 **최소 1개월 전** 서면 또는 이메일로 파트너에게 고지합니다.
|
||||
- 수수료 정책을 완전히 폐지하는 경우에도 동일하게 1개월 전 고지합니다.
|
||||
- 고지 기간 중 체결된 계약은 기존 수수료 정책을 적용합니다.
|
||||
|
||||
### 5.2 변경 효력
|
||||
|
||||
- 변경된 수수료 정책은 고지일로부터 **1개월 후** 새로 체결되는 계약부터 적용됩니다.
|
||||
- 고지 기간 만료 전에 체결된 계약은 기존 정책을 따릅니다.
|
||||
- 진행 중인 계약은 최초 약정 조건을 유지합니다.
|
||||
|
||||
### 5.3 변경 예시
|
||||
|
||||
#### 예시 1: 수수료율 변경
|
||||
|
||||
- 고지일: 2026년 2월 1일
|
||||
- 변경 내용: 판매자 수수료 20% → 18%
|
||||
- 적용일: 2026년 3월 1일 이후 체결 계약부터
|
||||
|
||||
#### 예시 2: 수수료 정책 폐지
|
||||
|
||||
- 고지일: 2026년 2월 1일
|
||||
- 변경 내용: 수수료 정책 완전 폐지
|
||||
- 적용일: 2026년 3월 1일 이후 체결 계약부터
|
||||
|
||||
## 제6조 (계약 기간)
|
||||
|
||||
- 본 계약은 계약일로부터 **1년간** 유효합니다.
|
||||
- 양측이 계약 만료 **30일 전**까지 서면으로 해지 의사를 통지하지 않으면 자동으로 **1년 연장**됩니다.
|
||||
- 자동 연장은 동일한 조건으로 반복됩니다.
|
||||
|
||||
## 제7조 (계약 해지)
|
||||
|
||||
### 7.1 일반 해지 (양방향)
|
||||
|
||||
- **통지 기간**: 양측은 **30일 전** 서면 통지로 계약을 해지할 수 있습니다.
|
||||
- **통지 방법**: 이메일 또는 등기우편
|
||||
- **효력 발생**: 통지일로부터 30일 후
|
||||
- **미지급 수수료**: 해지일 이전에 발생한 수수료는 정산하여 지급
|
||||
- **예시**:
|
||||
- 통지일: 2026년 2월 1일
|
||||
- 해지일: 2026년 3월 1일
|
||||
- 2월 중 발생한 수수료는 3월 10일 정상 지급
|
||||
|
||||
### 7.2 즉시 해지 사유
|
||||
|
||||
- 회사는 다음의 경우 **즉시 계약을 해지**할 수 있습니다:
|
||||
- **(1) 품위 유지 결격사유 발생 [신설]**
|
||||
- 음주운전으로 적발된 경우
|
||||
- 형사 범죄로 기소 또는 구속된 경우
|
||||
- 사회적 물의를 일으킨 경우
|
||||
- 기타 파트너로서의 품위를 훼손한 경우
|
||||
- **(2) 계약 위반**
|
||||
- 허위 정보 제공 또는 사기 행위
|
||||
- 회사 명예 훼손 또는 영업 방해
|
||||
- 비밀 유지 의무 위반
|
||||
- 중대한 업무 태만
|
||||
- **(3) 부정 행위**
|
||||
- 고객으로부터 금품 수수
|
||||
- 계약서 위조 또는 변조
|
||||
- 회사 자산 횡령 또는 유용
|
||||
|
||||
### 7.3 즉시 해지 시 조치
|
||||
|
||||
- 미지급 수수료는 지급하지 않습니다.
|
||||
- 이미 지급한 수수료는 환수하지 않습니다. (단, 사기 행위는 예외)
|
||||
- 진행 중인 계약은 회사가 직접 관리합니다.
|
||||
|
||||
## 제8조 (비밀 유지)
|
||||
|
||||
### 8.1 비밀 정보
|
||||
|
||||
- 다음 정보는 비밀로 유지되어야 합니다:
|
||||
- 회사의 영업 전략 및 계획
|
||||
- 고객 정보 (회사명, 담당자, 연락처 등)
|
||||
- 수수료 정책 및 계약 조건
|
||||
- 기술 정보 및 노하우
|
||||
- 회사 내부 자료
|
||||
|
||||
### 8.2 비밀 유지 의무
|
||||
|
||||
- 파트너는 업무 중 알게 된 비밀 정보를 외부에 누설하지 않습니다.
|
||||
- 비밀 유지 의무는 계약 종료 후에도 **3년간** 유효합니다.
|
||||
- 위반 시 손해배상 책임이 있습니다.
|
||||
|
||||
## 제9조 (지적재산권)
|
||||
|
||||
- SAM 서비스에 대한 모든 지적재산권은 회사에 귀속됩니다.
|
||||
- 파트너는 회사의 사전 서면 동의 없이 회사의 상표, 로고, 브랜드를 무단으로 사용할 수 없습니다.
|
||||
- 영업 활동에 필요한 자료는 회사가 제공합니다.
|
||||
|
||||
## 제10조 (세금 및 원천징수)
|
||||
|
||||
### 10.1 사업소득
|
||||
|
||||
- 파트너 수수료는 **사업소득**으로 간주됩니다.
|
||||
|
||||
### 10.2 원천징수
|
||||
|
||||
| 항목 | 비율 | 비고 |
|
||||
| --- | --- | --- |
|
||||
| 소득세 | 3.0% | |
|
||||
| 지방소득세 | 0.3% | 소득세의 10% |
|
||||
| 합계 | 3.3% | |
|
||||
|
||||
### 10.3 지급명세서
|
||||
|
||||
- 회사는 매월 수수료를 지급한 후에 파트너에게 **지급명세서**를 발급합니다.
|
||||
|
||||
## 제11조 (손해배상)
|
||||
|
||||
### 11.1 파트너의 귀책 사유
|
||||
|
||||
- 파트너가 다음의 행위로 회사에 손해를 입힌 경우 배상 책임이 있습니다:
|
||||
- 허위 정보 제공으로 계약 취소
|
||||
- 고객과의 분쟁으로 회사 명예 훼손
|
||||
- 비밀 유지 의무 위반
|
||||
- 부정 행위
|
||||
|
||||
### 11.2 회사의 귀책 사유
|
||||
|
||||
- 회사가 정당한 사유 없이 수수료를 지급하지 않을 경우, 연체 이자를 더하여 지급합니다.
|
||||
|
||||
## 제12조 (분쟁 해결)
|
||||
|
||||
- 본 계약과 관련한 분쟁은 상호 협의하여 해결합니다.
|
||||
- 협의가 이루어지지 않을 경우, **서울중앙지방법원**을 관할 법원으로 합니다.
|
||||
|
||||
## 제13조 (기타 사항)
|
||||
|
||||
### 13.1 계약서 교부
|
||||
|
||||
- 본 계약서는 2부 작성하여 회사와 파트너가 각 1부씩 보관합니다.
|
||||
|
||||
### 13.2 통지
|
||||
|
||||
- 모든 통지는 다음의 연락처로 발송됩니다:
|
||||
- **회사**:
|
||||
- 이메일: admin@codebridge-x.com
|
||||
- 전화: 02-6347-0005
|
||||
- **파트너**:
|
||||
- 이메일:
|
||||
- 전화:
|
||||
|
||||
### 13.3 준거법
|
||||
|
||||
- 본 계약은 대한민국 법률에 따라 해석되고 적용됩니다.
|
||||
|
||||
- **계약 당사자**
|
||||
- **[회사]**
|
||||
- **상호**: 주식회사 코드브릿지엑스
|
||||
- **대표자**: 이의찬 (인)
|
||||
- **사업자등록번호**: 664-86-03713
|
||||
- **주소**: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
- **이메일**: admin@codebridge-x.com
|
||||
- **전화**: 02-6347-0005
|
||||
- **날짜**:
|
||||
|
||||
- **[파트너]**
|
||||
- **상호/성명**:
|
||||
- **대표자/본인**: (서명)
|
||||
- **사업자등록번호**:
|
||||
- **주소**:
|
||||
- **이메일**:
|
||||
- **전화**:
|
||||
- **날짜**:
|
||||
|
||||
- **별첨**
|
||||
|
||||
#### 별첨 1: 수수료 정산표
|
||||
|
||||
| 계약번호 | 고객사 | 입금일 | 입금액 | 수수료율 | 수수료 | 지급일 |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| | | | | | | |
|
||||
|
||||
#### 별첨 2: 영업 활동 보고서
|
||||
|
||||
| 날짜 | 활동내용 | 고객사 | 진행 상황 |
|
||||
| --- | --- | --- | --- |
|
||||
| | | | |
|
||||
|
||||
- 첨부 서류
|
||||
- 사업자등록증 사본 (사업자인 경우)
|
||||
- 주민등록등본 사본 (개인인 경우)
|
||||
- 통장 사본 (수수료 입금용)
|
||||
- 비밀유지서약서
|
||||
|
||||
- **주식회사 코드브릿지엑스**
|
||||
- 이메일: admin@codebridge-x.com
|
||||
- 전화: 02-6347-0005
|
||||
- 주소: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
267
contracts/markdown/04-partner-agreement-group.md
Normal file
@@ -0,0 +1,267 @@
|
||||
---
|
||||
title: "영업파트너 위촉계약서 (단체용)"
|
||||
version: "v4.0"
|
||||
date: "2026-02-22"
|
||||
docx_file: "영업파트너 위촉계약서(단체용).docx"
|
||||
---
|
||||
|
||||
# < 영업파트너 위촉계약서 >
|
||||
|
||||
# Sales Partner Engagement Agreement
|
||||
|
||||
- 본 계약은 주식회사 코드브릿지엑스(이하 “회사”)와 (이하 “파트너)간에 SAM 서비스 영업 활동과 관련하여 다음과 같이 위촉계약을 체결합니다.
|
||||
|
||||
## 제1조 (계약의 목적)
|
||||
|
||||
- 본 계약은 회사와 파트너 간의 영업파트너 위촉 관계를 규정하고, 상호 권리와 의무를
|
||||
- 명확히 함을 목적으로 합니다.
|
||||
|
||||
## 제2조 (용어의 정의)
|
||||
|
||||
- **판매자**: 고객을 발굴하고 계약 체결을 주도하는 영업파트너
|
||||
- **개발비**: 고객이 SAM 서비스 개발을 위해 지급하는 비용
|
||||
- **수수료**: 파트너가 영업 활동의 대가로 받는 보상
|
||||
- **서비스 게시**: 개발 완료 후 고객이 서비스에 접근 가능하도록 제공하는 것
|
||||
|
||||
## 제3조 (파트너의 역할 및 업무)
|
||||
|
||||
### 3.1 판매자의 역할
|
||||
|
||||
- 잠재 고객 발굴 및 초기 접촉
|
||||
- SAM 서비스 소개 및 제안
|
||||
- 고객과의 계약 체결 지원
|
||||
- 계약 후 고객 관리 및 사후 지원
|
||||
|
||||
### 3.2 공통 의무
|
||||
|
||||
- 회사의 브랜드 이미지 유지
|
||||
- 정확한 정보 제공
|
||||
- 윤리적 영업 활동 준수
|
||||
- 비밀 유지 의무
|
||||
|
||||
## 제4조 (수수료 정책)
|
||||
|
||||
### 4.1 수수료 비율
|
||||
|
||||
| 역할 | 수수료 비율 | 산정 기준 |
|
||||
| --- | --- | --- |
|
||||
| 판매자 | 개발비의 30% | 1차,2차 입금액 기준 |
|
||||
|
||||
### 4.2 수수료 산정 예시
|
||||
|
||||
- **총 개발비 80,000,000원 계약 시**
|
||||
|
||||
| 단계 | 고객 입금 | 판매자 수수료 (30%) |
|
||||
| --- | --- | --- |
|
||||
| 1차 착수금 (50%) | 40,000,000원 | 12,000,000원 |
|
||||
| 2차 잔금 (50%) | 40,000,000원 | 12,000,000원 |
|
||||
| 총계 | 80,000,000원 | 24,000,000원 |
|
||||
|
||||
- **⚠️ 중요**: 개발비만 수수료 산정 대상이며, 구독료는 수수료 대상이 아닙니다.
|
||||
|
||||
### 4.3 지급 시기
|
||||
|
||||
- **지급일**: 고객 입금일 **익월 10일**
|
||||
- **지급 방식**: 계좌 이체
|
||||
- **세금**: 사업소득일 경우 3.3% 원천징수
|
||||
|
||||
### 4.4 수수료 지급 조건
|
||||
|
||||
- 고객이 개발비를 실제로 입금한 경우에만 지급
|
||||
- 계약 해지 또는 환불 시 수수료 미지급 또는 환수
|
||||
- 파트너가 계약 위반 시 수수료 지급 보류
|
||||
|
||||
## 제5조 (수수료 정책 변경)
|
||||
|
||||
### 5.1 사전 고지 의무
|
||||
|
||||
- 회사는 수수료 정책을 변경할 경우 **최소 1개월 전** 서면 또는 이메일로 파트너에게 고지합니다.
|
||||
- 수수료 정책을 완전히 폐지하는 경우에도 동일하게 1개월 전 고지합니다.
|
||||
- 고지 기간 중 체결된 계약은 기존 수수료 정책을 적용합니다.
|
||||
|
||||
### 5.2 변경 효력
|
||||
|
||||
- 변경된 수수료 정책은 고지일로부터 **1개월 후** 새로 체결되는 계약부터 적용됩니다.
|
||||
- 고지 기간 만료 전에 체결된 계약은 기존 정책을 따릅니다.
|
||||
- 진행 중인 계약은 최초 약정 조건을 유지합니다.
|
||||
|
||||
### 5.3 변경 예시
|
||||
|
||||
#### 예시 1: 수수료율 변경
|
||||
|
||||
- 고지일: 2026년 2월 1일
|
||||
- 변경 내용: 판매자 수수료 20% → 18%
|
||||
- 적용일: 2026년 3월 1일 이후 체결 계약부터
|
||||
|
||||
#### 예시 2: 수수료 정책 폐지
|
||||
|
||||
- 고지일: 2026년 2월 1일
|
||||
- 변경 내용: 수수료 정책 완전 폐지
|
||||
- 적용일: 2026년 3월 1일 이후 체결 계약부터
|
||||
|
||||
## 제6조 (계약 기간)
|
||||
|
||||
- 본 계약은 계약일로부터 **1년간** 유효합니다.
|
||||
- 양측이 계약 만료 **30일 전**까지 서면으로 해지 의사를 통지하지 않으면 자동으로 **1년 연장**됩니다.
|
||||
- 자동 연장은 동일한 조건으로 반복됩니다.
|
||||
|
||||
## 제7조 (계약 해지)
|
||||
|
||||
### 7.1 일반 해지 (양방향)
|
||||
|
||||
- **통지 기간**: 양측은 **30일 전** 서면 통지로 계약을 해지할 수 있습니다.
|
||||
- **통지 방법**: 이메일 또는 등기우편
|
||||
- **효력 발생**: 통지일로부터 30일 후
|
||||
- **미지급 수수료**: 해지일 이전에 발생한 수수료는 정산하여 지급
|
||||
- **예시**:
|
||||
- 통지일: 2026년 2월 1일
|
||||
- 해지일: 2026년 3월 1일
|
||||
- 2월 중 발생한 수수료는 3월 10일 정상 지급
|
||||
|
||||
### 7.2 즉시 해지 사유
|
||||
|
||||
- 회사는 다음의 경우 **즉시 계약을 해지**할 수 있습니다:
|
||||
- **(1) 품위 유지 결격사유 발생 [신설]**
|
||||
- 음주운전으로 적발된 경우
|
||||
- 형사 범죄로 기소 또는 구속된 경우
|
||||
- 사회적 물의를 일으킨 경우
|
||||
- 기타 파트너로서의 품위를 훼손한 경우
|
||||
- **(2) 계약 위반**
|
||||
- 허위 정보 제공 또는 사기 행위
|
||||
- 회사 명예 훼손 또는 영업 방해
|
||||
- 비밀 유지 의무 위반
|
||||
- 중대한 업무 태만
|
||||
- **(3) 부정 행위**
|
||||
- 고객으로부터 금품 수수
|
||||
- 계약서 위조 또는 변조
|
||||
- 회사 자산 횡령 또는 유용
|
||||
|
||||
### 7.3 즉시 해지 시 조치
|
||||
|
||||
- 미지급 수수료는 지급하지 않습니다.
|
||||
- 이미 지급한 수수료는 환수하지 않습니다. (단, 사기 행위는 예외)
|
||||
- 진행 중인 계약은 회사가 직접 관리합니다.
|
||||
|
||||
## 제8조 (비밀 유지)
|
||||
|
||||
### 8.1 비밀 정보
|
||||
|
||||
- 다음 정보는 비밀로 유지되어야 합니다:
|
||||
- 회사의 영업 전략 및 계획
|
||||
- 고객 정보 (회사명, 담당자, 연락처 등)
|
||||
- 수수료 정책 및 계약 조건
|
||||
- 기술 정보 및 노하우
|
||||
- 회사 내부 자료
|
||||
|
||||
### 8.2 비밀 유지 의무
|
||||
|
||||
- 파트너는 업무 중 알게 된 비밀 정보를 외부에 누설하지 않습니다.
|
||||
- 비밀 유지 의무는 계약 종료 후에도 **3년간** 유효합니다.
|
||||
- 위반 시 손해배상 책임이 있습니다.
|
||||
|
||||
## 제9조 (지적재산권)
|
||||
|
||||
- SAM 서비스에 대한 모든 지적재산권은 회사에 귀속됩니다.
|
||||
- 파트너는 회사의 사전 서면 동의 없이 회사의 상표, 로고, 브랜드를 무단으로 사용할 수 없습니다.
|
||||
- 영업 활동에 필요한 자료는 회사가 제공합니다.
|
||||
|
||||
## 제10조 (세금 및 원천징수)
|
||||
|
||||
### 10.1 사업소득
|
||||
|
||||
- 파트너 수수료는 **사업소득**으로 간주됩니다.
|
||||
|
||||
### 10.2 원천징수
|
||||
|
||||
| 항목 | 비율 | 비고 |
|
||||
| --- | --- | --- |
|
||||
| 소득세 | 3.0% | |
|
||||
| 지방소득세 | 0.3% | 소득세의 10% |
|
||||
| 합계 | 3.3% | |
|
||||
|
||||
### 10.3 지급명세서
|
||||
|
||||
- 회사는 매월 수수료를 지급한 후에 파트너에게 **지급명세서**를 발급합니다.
|
||||
|
||||
## 제11조 (손해배상)
|
||||
|
||||
### 11.1 파트너의 귀책 사유
|
||||
|
||||
- 파트너가 다음의 행위로 회사에 손해를 입힌 경우 배상 책임이 있습니다:
|
||||
- 허위 정보 제공으로 계약 취소
|
||||
- 고객과의 분쟁으로 회사 명예 훼손
|
||||
- 비밀 유지 의무 위반
|
||||
- 부정 행위
|
||||
|
||||
### 11.2 회사의 귀책 사유
|
||||
|
||||
- 회사가 정당한 사유 없이 수수료를 지급하지 않을 경우, 연체 이자를 더하여 지급합니다.
|
||||
|
||||
## 제12조 (분쟁 해결)
|
||||
|
||||
- 본 계약과 관련한 분쟁은 상호 협의하여 해결합니다.
|
||||
- 협의가 이루어지지 않을 경우, **서울중앙지방법원**을 관할 법원으로 합니다.
|
||||
|
||||
## 제13조 (기타 사항)
|
||||
|
||||
### 13.1 계약서 교부
|
||||
|
||||
- 본 계약서는 2부 작성하여 회사와 파트너가 각 1부씩 보관합니다.
|
||||
|
||||
### 13.2 통지
|
||||
|
||||
- 모든 통지는 다음의 연락처로 발송됩니다:
|
||||
- **회사**:
|
||||
- 이메일: admin@codebridge-x.com
|
||||
- 전화: 02-6347-0005
|
||||
- **파트너**:
|
||||
- 이메일:
|
||||
- 전화:
|
||||
|
||||
### 13.3 준거법
|
||||
|
||||
- 본 계약은 대한민국 법률에 따라 해석되고 적용됩니다.
|
||||
|
||||
- **계약 당사자**
|
||||
- **[회사]**
|
||||
- **상호**: 주식회사 코드브릿지엑스
|
||||
- **대표자**: 이의찬 (인)
|
||||
- **사업자등록번호**: 664-86-03713
|
||||
- **주소**: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
- **이메일**: admin@codebridge-x.com
|
||||
- **전화**: 02-6347-0005
|
||||
- **날짜**:
|
||||
|
||||
- **[파트너]**
|
||||
- **상호/성명**:
|
||||
- **대표자/본인**: (서명)
|
||||
- **사업자등록번호**:
|
||||
- **주소**:
|
||||
- **이메일**:
|
||||
- **전화**:
|
||||
- **날짜**:
|
||||
|
||||
- **별첨**
|
||||
|
||||
#### 별첨 1: 수수료 정산표
|
||||
|
||||
| 계약번호 | 고객사 | 입금일 | 입금액 | 수수료율 | 수수료 | 지급일 |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| | | | | | | |
|
||||
|
||||
#### 별첨 2: 영업 활동 보고서
|
||||
|
||||
| 날짜 | 활동내용 | 고객사 | 진행 상황 |
|
||||
| --- | --- | --- | --- |
|
||||
| | | | |
|
||||
|
||||
- 첨부 서류
|
||||
- 사업자등록증 사본 (사업자인 경우)
|
||||
- 주민등록등본 사본 (개인인 경우)
|
||||
- 통장 사본 (수수료 입금용)
|
||||
- 비밀유지서약서
|
||||
|
||||
- **주식회사 코드브릿지엑스**
|
||||
- 이메일: admin@codebridge-x.com
|
||||
- 전화: 02-6347-0005
|
||||
- 주소: 서울특별시 강서구 양천로 583, 우림블루나인 B동 1602호
|
||||
58
contracts/revisions.json
Normal file
@@ -0,0 +1,58 @@
|
||||
{
|
||||
"documents": {
|
||||
"01-service-agreement": {
|
||||
"title": "고객사 서비스 이용계약서",
|
||||
"docx_file": "01_고객_서비스이용계약서_v4_0_전자서명용.docx",
|
||||
"revisions": [
|
||||
{
|
||||
"version": "v4.0",
|
||||
"date": "2026-02-22",
|
||||
"author": "개발팀",
|
||||
"description": "버전 관리 시스템 도입, 개정이력 추적 시작"
|
||||
},
|
||||
{
|
||||
"version": "v4.1",
|
||||
"date": "2026-02-22",
|
||||
"author": "개발팀",
|
||||
"description": "제4조에 사용량 기반 추가 과금(4.5) 및 바로빌 부가 서비스 요금(4.6) 조항 추가"
|
||||
}
|
||||
]
|
||||
},
|
||||
"02-nda": {
|
||||
"title": "비밀유지서약서 (NDA)",
|
||||
"docx_file": "비밀유지서약서.docx",
|
||||
"revisions": [
|
||||
{
|
||||
"version": "v4.0",
|
||||
"date": "2026-02-22",
|
||||
"author": "개발팀",
|
||||
"description": "버전 관리 시스템 도입, 개정이력 추적 시작"
|
||||
}
|
||||
]
|
||||
},
|
||||
"03-partner-agreement": {
|
||||
"title": "영업파트너 위촉계약서",
|
||||
"docx_file": "영업파트너 위촉계약서.docx",
|
||||
"revisions": [
|
||||
{
|
||||
"version": "v4.0",
|
||||
"date": "2026-02-22",
|
||||
"author": "개발팀",
|
||||
"description": "버전 관리 시스템 도입, 개정이력 추적 시작"
|
||||
}
|
||||
]
|
||||
},
|
||||
"04-partner-agreement-group": {
|
||||
"title": "영업파트너 위촉계약서 (단체용)",
|
||||
"docx_file": "영업파트너 위촉계약서(단체용).docx",
|
||||
"revisions": [
|
||||
{
|
||||
"version": "v4.0",
|
||||
"date": "2026-02-22",
|
||||
"author": "개발팀",
|
||||
"description": "버전 관리 시스템 도입, 개정이력 추적 시작"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
334
contracts/scripts/extract_to_markdown.py
Normal file
@@ -0,0 +1,334 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
DOCX → Markdown 추출 스크립트
|
||||
|
||||
4개 전자계약 DOCX 파일을 Markdown으로 변환한다.
|
||||
- 서비스이용계약서: Heading 스타일 기반 매핑
|
||||
- 나머지 3개: Bold 런 + 패턴 매칭으로 구조 유추
|
||||
"""
|
||||
|
||||
import re
|
||||
import sys
|
||||
from datetime import date
|
||||
from pathlib import Path
|
||||
|
||||
from docx import Document
|
||||
|
||||
# 경로 설정
|
||||
BASE_DIR = Path(__file__).resolve().parent.parent
|
||||
DOCX_DIR = BASE_DIR / "docx"
|
||||
MD_DIR = BASE_DIR / "markdown"
|
||||
|
||||
# DOCX → Markdown 매핑
|
||||
FILE_MAP = {
|
||||
"01_고객_서비스이용계약서_v4_0_전자서명용.docx": {
|
||||
"output": "01-service-agreement.md",
|
||||
"title": "고객사 서비스 이용계약서",
|
||||
"type": "styled",
|
||||
},
|
||||
"비밀유지서약서.docx": {
|
||||
"output": "02-nda.md",
|
||||
"title": "비밀유지서약서 (NDA)",
|
||||
"type": "pattern",
|
||||
},
|
||||
"영업파트너 위촉계약서.docx": {
|
||||
"output": "03-partner-agreement.md",
|
||||
"title": "영업파트너 위촉계약서",
|
||||
"type": "pattern",
|
||||
},
|
||||
"영업파트너 위촉계약서(단체용).docx": {
|
||||
"output": "04-partner-agreement-group.md",
|
||||
"title": "영업파트너 위촉계약서 (단체용)",
|
||||
"type": "pattern",
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def table_to_markdown(table):
|
||||
"""DOCX 테이블을 Markdown 테이블로 변환"""
|
||||
rows = []
|
||||
for row in table.rows:
|
||||
cells = [cell.text.strip().replace("\n", " ") for cell in row.cells]
|
||||
rows.append(cells)
|
||||
|
||||
if not rows:
|
||||
return ""
|
||||
|
||||
lines = []
|
||||
# 헤더
|
||||
lines.append("| " + " | ".join(rows[0]) + " |")
|
||||
lines.append("| " + " | ".join(["---"] * len(rows[0])) + " |")
|
||||
# 본문
|
||||
for row in rows[1:]:
|
||||
# 셀 개수 맞추기
|
||||
while len(row) < len(rows[0]):
|
||||
row.append("")
|
||||
lines.append("| " + " | ".join(row[: len(rows[0])]) + " |")
|
||||
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def get_paragraph_heading_level_styled(para):
|
||||
"""스타일 기반 문서의 헤딩 레벨 판별 (서비스이용계약서)"""
|
||||
style = para.style.name if para.style else ""
|
||||
|
||||
if style == "Heading 1":
|
||||
return 1
|
||||
elif style == "Heading 2":
|
||||
return 2
|
||||
elif style == "Heading 3":
|
||||
return 3
|
||||
|
||||
return 0
|
||||
|
||||
|
||||
def get_paragraph_heading_level_pattern(para):
|
||||
"""패턴 매칭 기반 문서의 헤딩 레벨 판별 (비밀유지서약서, 영업파트너 위촉계약서)"""
|
||||
text = para.text.strip()
|
||||
has_bold = any(r.bold for r in para.runs if r.bold)
|
||||
|
||||
if not text or not has_bold:
|
||||
return 0
|
||||
|
||||
# "제X조" 패턴 → ## (h2)
|
||||
if re.match(r"^<?[ ]*제\d+조", text):
|
||||
return 2
|
||||
|
||||
# "X.X " 패턴 (소제목) → ### (h3)
|
||||
if re.match(r"^\d+\.\d+\s", text):
|
||||
return 3
|
||||
|
||||
# 문서 제목 (첫 번째 bold 텍스트)
|
||||
if re.match(r"^<?\s*(영업파트너|비밀유지서약서|Sales Partner)", text):
|
||||
return 1
|
||||
|
||||
return 0
|
||||
|
||||
|
||||
def is_list_item(para, doc_type):
|
||||
"""리스트 아이템인지 판별"""
|
||||
text = para.text.strip()
|
||||
if not text:
|
||||
return False
|
||||
|
||||
if doc_type == "styled":
|
||||
style = para.style.name if para.style else ""
|
||||
return style == "Compact"
|
||||
|
||||
# pattern 기반: bold가 아닌 일반 텍스트이면서 제X조나 X.X 패턴이 아닌 것
|
||||
has_bold = any(r.bold for r in para.runs if r.bold)
|
||||
if not has_bold and not re.match(r"^(제\d+조|<?|계약 당사자|\[)", text):
|
||||
return True
|
||||
|
||||
return False
|
||||
|
||||
|
||||
def extract_styled_doc(doc, file_info):
|
||||
"""스타일 기반 문서 추출 (서비스이용계약서)"""
|
||||
lines = []
|
||||
table_positions = {}
|
||||
|
||||
# 테이블 위치 매핑: 문단 인덱스 기준으로 테이블이 어디에 삽입되는지 추적
|
||||
body = doc.element.body
|
||||
table_idx = 0
|
||||
para_idx = 0
|
||||
for child in body:
|
||||
tag = child.tag.split("}")[-1] if "}" in child.tag else child.tag
|
||||
if tag == "p":
|
||||
para_idx += 1
|
||||
elif tag == "tbl":
|
||||
table_positions[para_idx] = table_idx
|
||||
table_idx += 1
|
||||
|
||||
para_idx = 0
|
||||
for child in body:
|
||||
tag = child.tag.split("}")[-1] if "}" in child.tag else child.tag
|
||||
|
||||
if tag == "p":
|
||||
para = doc.paragraphs[para_idx]
|
||||
para_idx += 1
|
||||
text = para.text.strip()
|
||||
|
||||
if not text:
|
||||
lines.append("")
|
||||
continue
|
||||
|
||||
style = para.style.name if para.style else ""
|
||||
level = get_paragraph_heading_level_styled(para)
|
||||
|
||||
if level > 0:
|
||||
lines.append("")
|
||||
lines.append(f"{'#' * level} {text}")
|
||||
lines.append("")
|
||||
elif style == "Compact":
|
||||
# Bold 런이 있으면 강조 리스트
|
||||
has_bold = any(r.bold for r in para.runs if r.bold)
|
||||
if has_bold:
|
||||
# Bold 부분과 일반 부분 분리
|
||||
parts = []
|
||||
for run in para.runs:
|
||||
if run.bold:
|
||||
parts.append(f"**{run.text}**")
|
||||
else:
|
||||
parts.append(run.text)
|
||||
combined = "".join(parts)
|
||||
lines.append(f"- {combined}")
|
||||
else:
|
||||
# 들여쓰기된 하위 항목
|
||||
lines.append(f" - {text}")
|
||||
elif style in ("Body Text", "First Paragraph"):
|
||||
# 본문 텍스트
|
||||
if text.startswith("⚠️") or text.startswith("✅") or text.startswith("❌"):
|
||||
lines.append("")
|
||||
lines.append(f"> {text}")
|
||||
lines.append("")
|
||||
else:
|
||||
lines.append(text)
|
||||
else:
|
||||
lines.append(text)
|
||||
|
||||
elif tag == "tbl":
|
||||
if table_idx <= len(doc.tables):
|
||||
current_table_idx = sum(
|
||||
1
|
||||
for c in list(body)[: list(body).index(child)]
|
||||
if (c.tag.split("}")[-1] if "}" in c.tag else c.tag) == "tbl"
|
||||
)
|
||||
if current_table_idx < len(doc.tables):
|
||||
lines.append("")
|
||||
lines.append(table_to_markdown(doc.tables[current_table_idx]))
|
||||
lines.append("")
|
||||
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def extract_pattern_doc(doc, file_info):
|
||||
"""패턴 매칭 기반 문서 추출 (비밀유지서약서, 영업파트너 위촉계약서)"""
|
||||
lines = []
|
||||
|
||||
body = doc.element.body
|
||||
para_idx = 0
|
||||
|
||||
for child in body:
|
||||
tag = child.tag.split("}")[-1] if "}" in child.tag else child.tag
|
||||
|
||||
if tag == "p":
|
||||
para = doc.paragraphs[para_idx]
|
||||
para_idx += 1
|
||||
text = para.text.strip()
|
||||
|
||||
if not text:
|
||||
lines.append("")
|
||||
continue
|
||||
|
||||
level = get_paragraph_heading_level_pattern(para)
|
||||
has_bold = any(r.bold for r in para.runs if r.bold)
|
||||
|
||||
if level > 0:
|
||||
lines.append("")
|
||||
# 제목에서 < > 제거
|
||||
clean_text = re.sub(r"^<\s*|\s*>$", "", text).strip()
|
||||
lines.append(f"{'#' * level} {clean_text}")
|
||||
lines.append("")
|
||||
elif has_bold:
|
||||
# Bold 텍스트는 강조 처리
|
||||
parts = []
|
||||
for run in para.runs:
|
||||
if run.bold:
|
||||
parts.append(f"**{run.text}**")
|
||||
else:
|
||||
parts.append(run.text)
|
||||
combined = "".join(parts)
|
||||
|
||||
# (1), (2) 같은 번호 패턴
|
||||
if re.match(r"^\*\*\(\d+\)", combined):
|
||||
lines.append(f"- {combined}")
|
||||
# "예시 N:", "Phase N:" 같은 패턴
|
||||
elif re.match(r"^\*\*(예시|Phase|별첨)\s", combined):
|
||||
lines.append("")
|
||||
lines.append(f"#### {text}")
|
||||
lines.append("")
|
||||
else:
|
||||
lines.append(f"- {combined}")
|
||||
else:
|
||||
# 일반 텍스트
|
||||
# 빈칸 양식 (___) 유지
|
||||
if "___" in text:
|
||||
lines.append(text)
|
||||
elif re.match(r"^(이메일|전화|주소|상호|대표|사업자|주민|연락처|날짜):", text):
|
||||
lines.append(f"- {text}")
|
||||
else:
|
||||
lines.append(f" - {text}")
|
||||
|
||||
elif tag == "tbl":
|
||||
current_table_idx = sum(
|
||||
1
|
||||
for c in list(body)[: list(body).index(child)]
|
||||
if (c.tag.split("}")[-1] if "}" in c.tag else c.tag) == "tbl"
|
||||
)
|
||||
if current_table_idx < len(doc.tables):
|
||||
lines.append("")
|
||||
lines.append(table_to_markdown(doc.tables[current_table_idx]))
|
||||
lines.append("")
|
||||
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def add_frontmatter(content, file_info, docx_name):
|
||||
"""YAML 프론트매터 추가"""
|
||||
frontmatter = f"""---
|
||||
title: "{file_info['title']}"
|
||||
version: "v4.0"
|
||||
date: "{date.today().isoformat()}"
|
||||
docx_file: "{docx_name}"
|
||||
---
|
||||
"""
|
||||
return frontmatter + "\n" + content
|
||||
|
||||
|
||||
def extract_file(docx_name, file_info):
|
||||
"""단일 DOCX 파일 추출"""
|
||||
docx_path = DOCX_DIR / docx_name
|
||||
if not docx_path.exists():
|
||||
print(f" [SKIP] {docx_name} - 파일 없음")
|
||||
return False
|
||||
|
||||
doc = Document(str(docx_path))
|
||||
|
||||
if file_info["type"] == "styled":
|
||||
content = extract_styled_doc(doc, file_info)
|
||||
else:
|
||||
content = extract_pattern_doc(doc, file_info)
|
||||
|
||||
# 프론트매터 추가
|
||||
content = add_frontmatter(content, file_info, docx_name)
|
||||
|
||||
# 연속 빈 줄 정리 (3줄 이상 → 2줄로)
|
||||
content = re.sub(r"\n{3,}", "\n\n", content)
|
||||
|
||||
# 파일 저장
|
||||
output_path = MD_DIR / file_info["output"]
|
||||
output_path.write_text(content, encoding="utf-8")
|
||||
print(f" [OK] {docx_name} → {file_info['output']}")
|
||||
return True
|
||||
|
||||
|
||||
def main():
|
||||
print("DOCX → Markdown 추출 시작")
|
||||
print(f" DOCX 디렉토리: {DOCX_DIR}")
|
||||
print(f" 출력 디렉토리: {MD_DIR}")
|
||||
print()
|
||||
|
||||
MD_DIR.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
success = 0
|
||||
for docx_name, file_info in FILE_MAP.items():
|
||||
if extract_file(docx_name, file_info):
|
||||
success += 1
|
||||
|
||||
print(f"\n완료: {success}/{len(FILE_MAP)} 파일 변환됨")
|
||||
return 0 if success == len(FILE_MAP) else 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
263
contracts/scripts/sync_check.py
Normal file
@@ -0,0 +1,263 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
DOCX ↔ Markdown 동기화 검증 스크립트
|
||||
|
||||
DOCX에서 텍스트를 추출하고 Markdown 파일의 텍스트와 비교하여
|
||||
불일치 항목을 리포트한다.
|
||||
"""
|
||||
|
||||
import difflib
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
from docx import Document
|
||||
|
||||
BASE_DIR = Path(__file__).resolve().parent.parent
|
||||
DOCX_DIR = BASE_DIR / "docx"
|
||||
MD_DIR = BASE_DIR / "markdown"
|
||||
|
||||
# DOCX → Markdown 파일 매핑
|
||||
FILE_MAP = {
|
||||
"01_고객_서비스이용계약서_v4_0_전자서명용.docx": "01-service-agreement.md",
|
||||
"비밀유지서약서.docx": "02-nda.md",
|
||||
"영업파트너 위촉계약서.docx": "03-partner-agreement.md",
|
||||
"영업파트너 위촉계약서(단체용).docx": "04-partner-agreement-group.md",
|
||||
}
|
||||
|
||||
|
||||
def extract_text_from_docx(docx_path):
|
||||
"""DOCX에서 순수 텍스트만 추출 (개정이력 테이블 제외, 인터리빙 방식)"""
|
||||
doc = Document(str(docx_path))
|
||||
lines = []
|
||||
|
||||
from docx.oxml.ns import qn as _qn
|
||||
|
||||
body = doc.element.body
|
||||
para_idx = 0
|
||||
table_idx = 0
|
||||
skip_revision = False
|
||||
|
||||
for child in body:
|
||||
tag = child.tag.split("}")[-1] if "}" in child.tag else child.tag
|
||||
|
||||
if tag == "p":
|
||||
if para_idx < len(doc.paragraphs):
|
||||
text = doc.paragraphs[para_idx].text.strip()
|
||||
para_idx += 1
|
||||
|
||||
if "개정이력" in text:
|
||||
skip_revision = True
|
||||
continue
|
||||
if text:
|
||||
skip_revision = False
|
||||
lines.append(text)
|
||||
|
||||
elif tag == "tbl":
|
||||
if table_idx < len(doc.tables):
|
||||
table = doc.tables[table_idx]
|
||||
table_idx += 1
|
||||
|
||||
# 개정이력 테이블 건너뛰기
|
||||
if len(table.rows) > 0:
|
||||
first_row_text = [cell.text.strip() for cell in table.rows[0].cells]
|
||||
if "버전" in first_row_text and "날짜" in first_row_text:
|
||||
skip_revision = False
|
||||
continue
|
||||
|
||||
if skip_revision:
|
||||
skip_revision = False
|
||||
continue
|
||||
|
||||
for row in table.rows:
|
||||
cells = [cell.text.strip() for cell in row.cells]
|
||||
# 빈 셀만 있는 행 건너뛰기
|
||||
if not any(cells):
|
||||
continue
|
||||
row_text = " | ".join(cells)
|
||||
if row_text.strip():
|
||||
lines.append(row_text)
|
||||
|
||||
return lines
|
||||
|
||||
|
||||
def extract_text_from_markdown(md_path):
|
||||
"""Markdown에서 순수 텍스트만 추출 (프론트매터, 마크업 제거)"""
|
||||
content = md_path.read_text(encoding="utf-8")
|
||||
lines = []
|
||||
|
||||
in_frontmatter = False
|
||||
in_table = False
|
||||
|
||||
for line in content.split("\n"):
|
||||
stripped = line.strip()
|
||||
|
||||
# YAML 프론트매터 건너뛰기
|
||||
if stripped == "---":
|
||||
in_frontmatter = not in_frontmatter
|
||||
continue
|
||||
if in_frontmatter:
|
||||
continue
|
||||
|
||||
# 빈 줄 건너뛰기
|
||||
if not stripped:
|
||||
in_table = False
|
||||
continue
|
||||
|
||||
# Markdown 마크업 제거
|
||||
text = stripped
|
||||
|
||||
# 헤딩 마크업 제거
|
||||
text = re.sub(r"^#{1,6}\s+", "", text)
|
||||
|
||||
# 리스트 마크업 제거
|
||||
text = re.sub(r"^\s*[-*+]\s+", "", text)
|
||||
|
||||
# Bold/Italic 마크업 제거
|
||||
text = re.sub(r"\*\*(.+?)\*\*", r"\1", text)
|
||||
text = re.sub(r"\*(.+?)\*", r"\1", text)
|
||||
|
||||
# 블록인용 제거
|
||||
text = re.sub(r"^>\s*", "", text)
|
||||
|
||||
# 테이블 구분선 건너뛰기
|
||||
if re.match(r"^\|[\s\-|]+\|$", text):
|
||||
continue
|
||||
|
||||
# 테이블 행
|
||||
if text.startswith("|") and text.endswith("|"):
|
||||
# 파이프 제거하고 셀 텍스트 추출
|
||||
cells = [c.strip() for c in text.strip("|").split("|")]
|
||||
text = " | ".join(cells)
|
||||
|
||||
text = text.strip()
|
||||
if text:
|
||||
lines.append(text)
|
||||
|
||||
return lines
|
||||
|
||||
|
||||
def normalize_text(text):
|
||||
"""비교를 위한 텍스트 정규화"""
|
||||
# 공백 정규화
|
||||
text = re.sub(r"\s+", " ", text).strip()
|
||||
# 특수문자 정규화
|
||||
text = text.replace("\u00a0", " ") # non-breaking space
|
||||
text = text.replace("\u3000", " ") # ideographic space
|
||||
# 언더스코어 빈칸 정규화
|
||||
text = re.sub(r"_{3,}", "___", text)
|
||||
# Bold 마크업(**) 제거 (DOCX 텍스트에 리터럴 ** 포함되는 경우)
|
||||
text = re.sub(r"\*\*(.+?)\*\*", r"\1", text)
|
||||
# 선행 리스트 마커 제거 (DOCX 텍스트가 "- "로 시작하는 경우)
|
||||
text = re.sub(r"^-\s+", "", text)
|
||||
return text
|
||||
|
||||
|
||||
def compare_documents(docx_name, md_name):
|
||||
"""두 문서의 텍스트를 비교"""
|
||||
docx_path = DOCX_DIR / docx_name
|
||||
md_path = MD_DIR / md_name
|
||||
|
||||
if not docx_path.exists():
|
||||
return {"status": "error", "message": f"DOCX 파일 없음: {docx_name}"}
|
||||
if not md_path.exists():
|
||||
return {"status": "error", "message": f"Markdown 파일 없음: {md_name}"}
|
||||
|
||||
docx_lines = [normalize_text(l) for l in extract_text_from_docx(docx_path) if l.strip()]
|
||||
md_lines = [normalize_text(l) for l in extract_text_from_markdown(md_path) if l.strip()]
|
||||
|
||||
# difflib로 비교
|
||||
matcher = difflib.SequenceMatcher(None, docx_lines, md_lines)
|
||||
ratio = matcher.ratio()
|
||||
|
||||
# 차이점 추출
|
||||
diffs = []
|
||||
for tag, i1, i2, j1, j2 in matcher.get_opcodes():
|
||||
if tag == "equal":
|
||||
continue
|
||||
elif tag == "replace":
|
||||
for idx in range(max(i2 - i1, j2 - j1)):
|
||||
docx_text = docx_lines[i1 + idx] if i1 + idx < i2 else "(없음)"
|
||||
md_text = md_lines[j1 + idx] if j1 + idx < j2 else "(없음)"
|
||||
diffs.append({
|
||||
"type": "변경",
|
||||
"docx": docx_text[:80],
|
||||
"markdown": md_text[:80],
|
||||
})
|
||||
elif tag == "delete":
|
||||
for idx in range(i1, i2):
|
||||
diffs.append({
|
||||
"type": "DOCX에만 존재",
|
||||
"docx": docx_lines[idx][:80],
|
||||
"markdown": "-",
|
||||
})
|
||||
elif tag == "insert":
|
||||
for idx in range(j1, j2):
|
||||
diffs.append({
|
||||
"type": "Markdown에만 존재",
|
||||
"docx": "-",
|
||||
"markdown": md_lines[idx][:80],
|
||||
})
|
||||
|
||||
return {
|
||||
"status": "ok",
|
||||
"similarity": round(ratio * 100, 1),
|
||||
"docx_lines": len(docx_lines),
|
||||
"md_lines": len(md_lines),
|
||||
"diff_count": len(diffs),
|
||||
"diffs": diffs[:20], # 상위 20개만
|
||||
}
|
||||
|
||||
|
||||
def main():
|
||||
print("=" * 70)
|
||||
print("DOCX ↔ Markdown 동기화 검증")
|
||||
print("=" * 70)
|
||||
|
||||
all_ok = True
|
||||
|
||||
for docx_name, md_name in FILE_MAP.items():
|
||||
print(f"\n{'─' * 50}")
|
||||
print(f"문서: {docx_name}")
|
||||
print(f" ↔ {md_name}")
|
||||
print(f"{'─' * 50}")
|
||||
|
||||
result = compare_documents(docx_name, md_name)
|
||||
|
||||
if result["status"] == "error":
|
||||
print(f" [ERROR] {result['message']}")
|
||||
all_ok = False
|
||||
continue
|
||||
|
||||
similarity = result["similarity"]
|
||||
status_icon = "OK" if similarity >= 80 else "WARN" if similarity >= 60 else "FAIL"
|
||||
|
||||
print(f" 유사도: {similarity}% [{status_icon}]")
|
||||
print(f" DOCX 라인: {result['docx_lines']}")
|
||||
print(f" Markdown 라인: {result['md_lines']}")
|
||||
print(f" 차이점: {result['diff_count']}개")
|
||||
|
||||
if result["diffs"]:
|
||||
print(f"\n 주요 차이점 (상위 {min(len(result['diffs']), 10)}개):")
|
||||
for i, diff in enumerate(result["diffs"][:10]):
|
||||
print(f" [{diff['type']}]")
|
||||
if diff["docx"] != "-":
|
||||
print(f" DOCX: {diff['docx']}")
|
||||
if diff["markdown"] != "-":
|
||||
print(f" MD: {diff['markdown']}")
|
||||
|
||||
if similarity < 80:
|
||||
all_ok = False
|
||||
|
||||
print(f"\n{'=' * 70}")
|
||||
if all_ok:
|
||||
print("결과: 모든 문서 동기화 상태 양호")
|
||||
else:
|
||||
print("결과: 일부 문서에서 불일치 발견 - 확인 필요")
|
||||
print(f"{'=' * 70}")
|
||||
|
||||
return 0 if all_ok else 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
279
data/interview-master-questions.sql
Normal file
@@ -0,0 +1,279 @@
|
||||
-- ============================================================
|
||||
-- 인터뷰 질문 마스터 데이터 SQL
|
||||
-- 8개 도메인 × 16개 템플릿 × 80개 질문
|
||||
--
|
||||
-- 실행 방법:
|
||||
-- 로컬: docker exec -i sam-mysql-1 mysql -u root -p samdb < docs/data/interview-master-questions.sql
|
||||
-- 개발서버: mysql -u <user> -p samdb < interview-master-questions.sql
|
||||
-- phpMyAdmin: SQL 탭에서 전체 복사 후 실행
|
||||
--
|
||||
-- 주의: 한 번만 실행할 것. 중복 실행 시 데이터가 중복됨.
|
||||
-- ============================================================
|
||||
|
||||
SET NAMES utf8mb4;
|
||||
SET @tenant_id = 1;
|
||||
SET @user_id = 1;
|
||||
SET @now = NOW();
|
||||
|
||||
-- ============================================================
|
||||
-- 대분류: 제조업-방화셔터 (parent_id=null, 루트 카테고리)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, NULL, '제조업-방화셔터', '방화셔터 제조업 인터뷰', NULL, 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @root_manufacturing = LAST_INSERT_ID();
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 1: 제품 분류 체계 (product_classification)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '제품 분류 체계', '제품 카테고리, 모델 코드, 분류 기준 파악', 'product_classification', 3, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_1 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 1.1: 제품 카테고리 구조
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_1, '제품 카테고리 구조', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_1_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_1_1, '귀사의 주요 제품군을 모두 나열해주세요', 'text', NULL, '쉼표 구분으로 제품군 나열', NULL, NULL, 'product_classification', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '각 제품군의 하위 모델명과 코드 체계를 알려주세요', 'table_input', '{"columns":["모델코드","모델명","비고"]}', '코드-이름 매핑 테이블', NULL, NULL, 'product_classification', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '제품을 분류하는 기준은 무엇인가요? (소재, 용도, 크기 등)', 'multi_select', '{"choices":["소재별","용도별","크기별","설치방식별","인증여부별"]}', NULL, NULL, NULL, 'product_classification', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '인증(인정) 제품과 비인증 제품의 구분이 있나요?', 'select', '{"choices":["있음","없음"]}', NULL, NULL, NULL, 'product_classification', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '인증 제품의 경우 구성이 고정되나요?', 'checkbox', NULL, NULL, NULL, '{"question_index":3,"value":"있음"}', 'product_classification', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '카테고리별 제품 수는 대략 몇 개인가요?', 'number', NULL, NULL, '개', NULL, 'product_classification', 0, 6, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '제품 코드 명명 규칙을 설명해주세요 (예: KSS01의 의미)', 'text', NULL, '코드 체계의 각 자릿수 의미', NULL, NULL, 'product_classification', 0, 7, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_1, '기존 시스템(ERP/엑셀)에서 사용하는 제품 분류 방식을 캡처하여 업로드해주세요', 'file_upload', NULL, NULL, NULL, NULL, 'product_classification', 0, 8, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 1.2: 설치 유형별 분류
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_1, '설치 유형별 분류', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_1_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_1_2, '설치 유형(벽면형, 측면형, 혼합형 등)에 따라 견적이 달라지나요?', 'select', '{"choices":["예, 크게 달라짐","약간 달라짐","달라지지 않음"]}', NULL, NULL, NULL, 'product_classification', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_2, '각 설치 유형별로 어떤 부품이 달라지나요?', 'table_input', '{"columns":["설치유형","추가부품","제외부품","비고"]}', NULL, NULL, NULL, 'product_classification', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_1_2, '설치 유형에 따른 추가 비용 항목이 있나요?', 'text', NULL, NULL, NULL, NULL, 'product_classification', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 2: BOM 구조 (bom_structure)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, 'BOM 구조', '완제품-부품 관계, 부품 카테고리, BOM 레벨', 'bom_structure', 4, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_2 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 2.1: 완제품-부품 관계
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_2, '완제품-부품 관계', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_2_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_2_1, '대표 제품 1개의 완제품→부품 구성을 트리로 그려주세요', 'bom_tree', NULL, '최상위 제품부터 하위 부품까지 트리 구조', NULL, NULL, 'bom_structure', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_1, '모든 제품에 공통으로 들어가는 부품은 무엇인가요?', 'multi_select', '{"choices":["가이드레일","케이스","모터","제어기","브라켓","볼트/너트"]}', '직접 입력 가능', NULL, NULL, 'bom_structure', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_1, '제품별로 선택적(옵션)인 부품은 무엇인가요?', 'table_input', '{"columns":["제품명","옵션부품","적용조건"]}', NULL, NULL, NULL, 'bom_structure', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_1, 'BOM이 현재 엑셀로 관리되고 있나요? 파일을 업로드해주세요', 'file_upload', NULL, NULL, NULL, NULL, 'bom_structure', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_1, '하위 부품의 단계(레벨)는 최대 몇 단계인가요?', 'number', NULL, NULL, '단계', NULL, 'bom_structure', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_1, '부품 수량이 고정인 것과 계산이 필요한 것을 구분해주세요', 'table_input', '{"columns":["부품명","고정/계산","고정수량 또는 계산식"]}', NULL, NULL, NULL, 'bom_structure', 0, 6, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 2.2: 부품 카테고리
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_2, '부품 카테고리', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_2_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_2_2, '부품을 카테고리로 분류하면 어떻게 나눠지나요? (본체, 절곡품, 전동부, 부자재 등)', 'text', NULL, '부품 분류 체계', NULL, NULL, 'bom_structure', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_2, '각 카테고리에 속하는 부품 목록을 정리해주세요', 'table_input', '{"columns":["카테고리","부품명","규격"]}', NULL, NULL, NULL, 'bom_structure', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_2, '외주 구매 부품과 자체 제작 부품의 구분이 있나요?', 'select', '{"choices":["있음","없음"]}', NULL, NULL, NULL, 'bom_structure', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_2_2, '부자재(볼트, 너트, 패킹 등)는 별도 관리하나요?', 'checkbox', NULL, NULL, NULL, NULL, 'bom_structure', 0, 4, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 3: 치수/변수 계산 (dimension_formula)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '치수/변수 계산', '오픈 사이즈→제작 사이즈 변환, 파생 변수 계산', 'dimension_formula', 5, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_3 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 3.1: 오픈 사이즈 → 제작 사이즈
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_3, '오픈 사이즈 → 제작 사이즈', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_3_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_3_1, '고객이 입력하는 기본 치수 항목은 무엇인가요? (폭, 높이, 깊이 등)', 'multi_select', '{"choices":["폭(W)","높이(H)","깊이(D)","두께(T)","지름(Ø)"]}', NULL, NULL, NULL, 'dimension_formula', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '오픈 사이즈에서 제작 사이즈로 변환할 때 더하는 마진값은?', 'formula_input', NULL, '예: W1 = W0 + 120, H1 = H0 + 50', 'mm', NULL, 'dimension_formula', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '제품 카테고리별로 마진값이 다른가요?', 'table_input', '{"columns":["제품카테고리","W 마진(mm)","H 마진(mm)","비고"]}', NULL, NULL, NULL, 'dimension_formula', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '면적(㎡) 계산 공식을 알려주세요', 'formula_input', NULL, '예: area = W1 * H1 / 1000000', '㎡', NULL, 'dimension_formula', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '중량(kg) 계산 공식을 알려주세요', 'formula_input', NULL, '예: weight = area * 단위중량(kg/㎡)', 'kg', NULL, 'dimension_formula', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '기타 파생 변수가 있나요? (예: 분할 개수, 절곡 길이 등)', 'table_input', '{"columns":["변수명","계산식","단위","비고"]}', NULL, NULL, NULL, 'dimension_formula', 0, 6, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_1, '치수 계산에 사용하는 엑셀 수식을 캡처해주세요', 'file_upload', NULL, NULL, NULL, NULL, 'dimension_formula', 0, 7, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 3.2: 변수 의존 관계
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_3, '변수 의존 관계', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_3_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_3_2, '변수 간 의존 관계를 설명해주세요 (A는 B와 C로 계산)', 'text', NULL, '계산 순서와 변수 의존성', NULL, NULL, 'dimension_formula', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_2, '계산 순서가 중요한 변수가 있나요?', 'text', NULL, NULL, NULL, NULL, 'dimension_formula', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_3_2, '단위는 mm, m, kg 중 어떤 것을 기본으로 사용하나요?', 'select', '{"choices":["mm","m","cm","혼용"]}', NULL, NULL, NULL, 'dimension_formula', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 4: 부품 구성 상세 (component_config)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '부품 구성 상세', '주요 부품별 규격, 선택 기준, 특수 구성', 'component_config', 6, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_4 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 4.1: 주요 부품별 상세
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_4, '주요 부품별 상세', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_4_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_4_1, '가이드레일의 표준 길이 규격은? (예: 1219, 2438, 3305mm)', 'table_input', '{"columns":["규격코드","길이(mm)","비고"]}', NULL, NULL, NULL, 'component_config', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '가이드레일 길이 조합 규칙은? (어떤 길이를 몇 개 사용?)', 'text', NULL, '높이에 따른 가이드레일 조합 로직', NULL, NULL, 'component_config', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '케이스(하우징) 크기별 규격과 부속품 차이를 설명해주세요', 'table_input', '{"columns":["케이스규격","적용조건","부속품"]}', NULL, NULL, NULL, 'component_config', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '모터 용량 종류와 선택 기준은? (무게별? 면적별?)', 'table_input', '{"columns":["모터용량","적용범위(최소)","적용범위(최대)","단위"]}', '무게/면적 범위별 모터 매핑', NULL, NULL, 'component_config', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '모터 전압 옵션은? (380V, 220V 등)', 'multi_select', '{"choices":["380V","220V","110V","DC 24V"]}', NULL, NULL, NULL, 'component_config', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '제어기 종류와 선택 기준은? (노출형/매립형 등)', 'table_input', '{"columns":["제어기유형","적용조건","비고"]}', NULL, NULL, NULL, 'component_config', 0, 6, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '절곡품(판재 가공) 목록과 각각의 치수 결정 방식은?', 'table_input', '{"columns":["절곡품명","치수결정방식","재질","두께(mm)"]}', NULL, NULL, NULL, 'component_config', 0, 7, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_1, '부자재(볼트, 너트, 패킹 등) 목록과 수량 결정 방식은?', 'table_input', '{"columns":["부자재명","규격","수량결정방식","기본수량"]}', NULL, NULL, NULL, 'component_config', 0, 8, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 4.2: 특수 구성
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_4, '특수 구성', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_4_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_4_2, '연기차단재 등 특수 부품이 있나요? 적용 조건은?', 'text', NULL, NULL, NULL, NULL, 'component_config', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_2, '보강재(샤프트, 파이프, 앵글 등) 사용 조건은?', 'table_input', '{"columns":["보강재명","규격","적용조건","수량"]}', NULL, NULL, NULL, 'component_config', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_4_2, '고객 요청에 따라 추가/제외되는 옵션 부품은?', 'table_input', '{"columns":["옵션부품","추가/제외","추가비용","비고"]}', NULL, NULL, NULL, 'component_config', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 5: 단가 체계 (pricing_structure)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '단가 체계', '단가 관리 방식, 계산 방식, 마진/LOSS율', 'pricing_structure', 7, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_5 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 5.1: 단가 관리 방식
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_5, '단가 관리 방식', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_5_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_5_1, '부품별 단가를 어디서 관리하나요? (엑셀, ERP, 구두 등)', 'select', '{"choices":["엑셀","ERP 시스템","구두/경험","기타"]}', NULL, NULL, NULL, 'pricing_structure', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, '단가표 파일을 업로드해주세요', 'file_upload', NULL, NULL, NULL, NULL, 'pricing_structure', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, '단가 변경 주기는? (월/분기/연 등)', 'select', '{"choices":["수시","월 단위","분기 단위","반기 단위","연 단위"]}', NULL, NULL, NULL, 'pricing_structure', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, '단가에 포함되는 항목은? (재료비만? 가공비 포함?)', 'multi_select', '{"choices":["재료비","가공비","운송비","설치비","마진"]}', NULL, NULL, NULL, 'pricing_structure', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, '고객별/거래처별 차등 단가가 있나요?', 'select', '{"choices":["있음 (등급별)","있음 (거래처별)","없음 (일괄 동일)"]}', NULL, NULL, NULL, 'pricing_structure', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, 'LOSS율(손실률)을 적용하나요? 적용 방식은?', 'formula_input', NULL, '예: 실제수량 = 계산수량 × (1 + LOSS율)', '%', NULL, 'pricing_structure', 0, 6, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_1, '마진율 설정 방식은? (일괄? 품목별?)', 'select', '{"choices":["일괄 마진율","품목별 마진율","카테고리별 마진율","고객별 마진율"]}', NULL, NULL, NULL, 'pricing_structure', 0, 7, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 5.2: 단가 계산 방식
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_5, '단가 계산 방식', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_5_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_5_2, '면적 기반 단가 품목은? (원/㎡)', 'table_input', '{"columns":["품목명","단가(원/㎡)","비고"]}', NULL, '원/㎡', NULL, 'pricing_structure', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_2, '중량 기반 단가 품목은? (원/kg)', 'table_input', '{"columns":["품목명","단가(원/kg)","비고"]}', NULL, '원/kg', NULL, 'pricing_structure', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_2, '수량 기반 단가 품목은? (원/EA)', 'table_input', '{"columns":["품목명","단가(원/EA)","비고"]}', NULL, '원/EA', NULL, 'pricing_structure', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_2, '길이 기반 단가 품목은? (원/m)', 'table_input', '{"columns":["품목명","단가(원/m)","비고"]}', NULL, '원/m', NULL, 'pricing_structure', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_5_2, '기타 특수 단가 계산 방식이 있나요?', 'text', NULL, NULL, NULL, NULL, 'pricing_structure', 0, 5, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 6: 수량 수식 (quantity_formula)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '수량 수식', '부품별 수량 결정 규칙, 계산식, 검증', 'quantity_formula', 8, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_6 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 6.1: 수량 결정 규칙
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_6, '수량 결정 규칙', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_6_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_6_1, '고정 수량 부품 목록 (항상 1개, 2개 등)', 'table_input', '{"columns":["부품명","고정수량","비고"]}', NULL, NULL, NULL, 'quantity_formula', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_1, '치수 기반 수량 계산 부품과 수식', 'formula_input', NULL, '예: 슬랫수량 = CEIL(H1 / 슬랫피치)', NULL, NULL, 'quantity_formula', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_1, '면적 기반 수량 계산 부품과 수식', 'formula_input', NULL, '예: 스크린수량 = area / 기준면적', NULL, NULL, 'quantity_formula', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_1, '중량 기반 수량 계산 부품과 수식', 'formula_input', NULL, NULL, NULL, NULL, 'quantity_formula', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_1, '올림/내림/반올림 규칙이 있는 계산은?', 'table_input', '{"columns":["계산항목","올림/내림/반올림","소수점자릿수"]}', NULL, NULL, NULL, 'quantity_formula', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_1, '여유 수량(LOSS) 적용 품목과 비율은?', 'table_input', '{"columns":["품목명","LOSS율(%)","비고"]}', NULL, NULL, NULL, 'quantity_formula', 0, 6, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 6.2: 수식 검증
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_6, '수식 검증', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_6_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_6_2, '실제 견적서에서 수량 계산 예시를 보여주세요 (W=3000, H=2500일 때)', 'table_input', '{"columns":["부품명","수식","계산결과","단위"]}', NULL, NULL, NULL, 'quantity_formula', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_2, '수식에 사용하는 함수가 있나요? (SUM, CEIL, ROUND 등)', 'multi_select', '{"choices":["CEIL (올림)","FLOOR (내림)","ROUND (반올림)","MAX","MIN","IF 조건문","SUM"]}', NULL, NULL, NULL, 'quantity_formula', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_6_2, '조건에 따라 수식이 달라지는 경우가 있나요?', 'text', NULL, '예: 폭이 3000 초과이면 분할 계산', NULL, NULL, 'quantity_formula', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 7: 조건부 로직 (conditional_logic)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '조건부 로직', '범위/매핑 기반 부품 자동 선택 규칙', 'conditional_logic', 9, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_7 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 7.1: 범위 기반 선택
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_7, '범위 기반 선택', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_7_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_7_1, '무게 범위별 모터 용량 선택표를 작성해주세요', 'price_table', '{"columns":["범위 시작(kg)","범위 끝(kg)","모터용량","비고"]}', NULL, NULL, NULL, 'conditional_logic', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_7_1, '크기 범위별 부품 자동 선택 규칙이 있나요?', 'table_input', '{"columns":["조건(변수)","범위","선택부품","비고"]}', NULL, NULL, NULL, 'conditional_logic', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_7_1, '브라켓 크기 결정 기준은?', 'table_input', '{"columns":["조건","범위","브라켓 규격"]}', NULL, NULL, NULL, 'conditional_logic', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 7.2: 매핑 기반 선택
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_7, '매핑 기반 선택', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_7_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_7_2, '제품 모델 → 기본 부품 세트 매핑표', 'table_input', '{"columns":["제품모델","기본부품1","기본부품2","기본부품3"]}', NULL, NULL, NULL, 'conditional_logic', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_7_2, '설치 유형 → 추가 부품 매핑표', 'table_input', '{"columns":["설치유형","추가부품","수량","비고"]}', NULL, NULL, NULL, 'conditional_logic', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_7_2, '제어기 유형 → 부속품 매핑표', 'table_input', '{"columns":["제어기유형","부속품1","부속품2","부속품3"]}', NULL, NULL, NULL, 'conditional_logic', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_7_2, '기타 조건부 자동 선택 규칙', 'text', NULL, '위 항목에 해당하지 않는 조건-결과 매핑', NULL, NULL, 'conditional_logic', 0, 4, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- Domain 8: 견적서 양식 (quote_format)
|
||||
-- ============================================================
|
||||
INSERT INTO interview_categories (tenant_id, interview_project_id, parent_id, name, description, domain, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, NULL, @root_manufacturing, '견적서 양식', '출력 양식, 항목 그룹, 소계/합계 구조', 'quote_format', 10, 1, @user_id, @user_id, @now, @now);
|
||||
SET @cat_8 = LAST_INSERT_ID();
|
||||
|
||||
-- 템플릿 8.1: 출력 양식
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_8, '출력 양식', 1, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_8_1 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_8_1, '현재 사용 중인 견적서 양식을 업로드해주세요', 'file_upload', NULL, NULL, NULL, NULL, 'quote_format', 1, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '견적서에 표시되는 항목 그룹은? (재료비, 노무비, 설치비 등)', 'multi_select', '{"choices":["재료비","노무비","경비","설치비","운반비","이윤","부가세"]}', NULL, NULL, NULL, 'quote_format', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '소계/합계 계산 구조를 설명해주세요', 'text', NULL, '항목 그룹별 소계와 최종 합계의 관계', NULL, NULL, 'quote_format', 0, 3, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '할인 적용 방식은? (일괄? 항목별?)', 'select', '{"choices":["일괄 할인","항목별 할인","할인 없음","협의 할인"]}', NULL, NULL, NULL, 'quote_format', 0, 4, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '부가세 표시 방식은? (별도? 포함?)', 'select', '{"choices":["별도 표시","포함 표시","선택 가능"]}', NULL, NULL, NULL, 'quote_format', 0, 5, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '견적서에 표시하지 않는 내부 관리 항목은?', 'text', NULL, NULL, NULL, NULL, 'quote_format', 0, 6, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_1, '견적 번호 체계를 알려주세요', 'text', NULL, '예: Q-2026-001 형식', NULL, NULL, 'quote_format', 0, 7, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- 템플릿 8.2: 특수 요구사항
|
||||
INSERT INTO interview_templates (tenant_id, interview_category_id, name, sort_order, is_active, created_by, updated_by, created_at, updated_at)
|
||||
VALUES (@tenant_id, @cat_8, '특수 요구사항', 2, 1, @user_id, @user_id, @now, @now);
|
||||
SET @tpl_8_2 = LAST_INSERT_ID();
|
||||
|
||||
INSERT INTO interview_questions (tenant_id, interview_template_id, question_text, question_type, options, ai_hint, expected_format, depends_on, domain, is_required, sort_order, is_active, created_by, updated_by, created_at, updated_at) VALUES
|
||||
(@tenant_id, @tpl_8_2, '산출내역서(세부 내역)를 별도로 제공하나요?', 'checkbox', NULL, NULL, NULL, NULL, 'quote_format', 0, 1, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_2, '위치별(층/부호) 개별 산출이 필요한가요?', 'checkbox', NULL, NULL, NULL, NULL, 'quote_format', 0, 2, 1, @user_id, @user_id, @now, @now),
|
||||
(@tenant_id, @tpl_8_2, '일괄 산출(여러 위치 합산)을 사용하나요?', 'checkbox', NULL, NULL, NULL, NULL, 'quote_format', 0, 3, 1, @user_id, @user_id, @now, @now);
|
||||
|
||||
-- ============================================================
|
||||
-- 완료 확인
|
||||
-- ============================================================
|
||||
SELECT
|
||||
(SELECT COUNT(*) FROM interview_categories WHERE interview_project_id IS NULL AND domain IS NOT NULL) AS master_categories,
|
||||
(SELECT COUNT(*) FROM interview_templates t JOIN interview_categories c ON t.interview_category_id = c.id WHERE c.interview_project_id IS NULL AND c.domain IS NOT NULL) AS master_templates,
|
||||
(SELECT COUNT(*) FROM interview_questions q JOIN interview_templates t ON q.interview_template_id = t.id JOIN interview_categories c ON t.interview_category_id = c.id WHERE c.interview_project_id IS NULL AND c.domain IS NOT NULL) AS master_questions;
|
||||
@@ -90,5 +90,5 @@ CANCELLED → DRAFT (복구 가능)
|
||||
- Swagger UI에서 API 테스트 가능: http://api.sam.kr/api-docs/index.html
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/order-management-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/order-management-plan.md`
|
||||
- 참고 패턴: `app/Services/WorkOrderService.php`, `app/Http/Controllers/Api/V1/WorkOrderController.php`
|
||||
@@ -75,4 +75,4 @@ public function revokeAccount(int $id): TenantUserProfile
|
||||
- 기존 사원 데이터에 영향 없음
|
||||
|
||||
## 🔗 관련 문서
|
||||
- docs/plans/employee-user-linkage-plan.md
|
||||
- docs/dev_plans/employee-user-linkage-plan.md
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2025-12-30 14:30
|
||||
**작업자:** Claude Code
|
||||
**관련 문서:** docs/plans/react-fcm-push-notification-plan.md
|
||||
**관련 문서:** docs/dev_plans/react-fcm-push-notification-plan.md
|
||||
|
||||
## 📋 변경 개요
|
||||
|
||||
@@ -94,7 +94,7 @@ Route::post('/calculate/bom', [QuoteController::class, 'calculateBom'])->name('v
|
||||
- 기존 API에 영향 없음 (신규 엔드포인트 추가)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/quote-calculation-api-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/quote-calculation-api-plan.md`
|
||||
- FormulaEvaluatorService: `api/app/Services/Quote/FormulaEvaluatorService.php`
|
||||
|
||||
## 📊 API 사용 예시
|
||||
@@ -13,7 +13,7 @@
|
||||
| 파일 | 변경 내용 |
|
||||
|------|----------|
|
||||
| `react/src/components/business/construction/handover-report/actions.ts` | Mock → API 완전 변환 |
|
||||
| `docs/plans/sub/handover-report-plan.md` | 진행 상태 업데이트 |
|
||||
| `docs/dev_plans/sub/handover-report-plan.md` | 진행 상태 업데이트 |
|
||||
|
||||
## 🔧 상세 변경 사항
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-22
|
||||
**작업자:** Claude Code
|
||||
**계획 문서:** docs/plans/card-management-section-plan.md
|
||||
**계획 문서:** docs/dev_plans/card-management-section-plan.md
|
||||
**Phase:** 1.1 카드 거래 대시보드 API 개발
|
||||
|
||||
## 📋 변경 개요
|
||||
@@ -71,5 +71,5 @@ Route::get('/dashboard', [CardTransactionController::class, 'dashboard'])
|
||||
특이사항 없음 (DB 스키마 변경 없음)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/card-management-section-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/card-management-section-plan.md`
|
||||
- 기존 API 문서: `api/app/Swagger/v1/CardTransactionApi.php`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-22
|
||||
**작업자:** Claude Code
|
||||
**계획 문서:** docs/plans/card-management-section-plan.md
|
||||
**계획 문서:** docs/dev_plans/card-management-section-plan.md
|
||||
**Phase:** 1.2 가지급금 대시보드 API 개발
|
||||
|
||||
## 📋 변경 개요
|
||||
@@ -78,6 +78,6 @@ Route::get('/dashboard', [LoanController::class, 'dashboard'])
|
||||
특이사항 없음 (DB 스키마 변경 없음)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/card-management-section-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/card-management-section-plan.md`
|
||||
- Phase 1.1 변경: `docs/changes/20260122_card_transaction_dashboard_api.md`
|
||||
- 기존 API 문서: `api/app/Swagger/v1/LoanApi.php`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-22
|
||||
**작업자:** Claude Code
|
||||
**계획 문서:** docs/plans/card-management-section-plan.md
|
||||
**계획 문서:** docs/dev_plans/card-management-section-plan.md
|
||||
**Phase:** 1.3 세금 시뮬레이션 API 개발
|
||||
|
||||
## 📋 변경 개요
|
||||
@@ -98,7 +98,7 @@ Route::get('/tax-simulation', [LoanController::class, 'taxSimulation'])
|
||||
특이사항 없음 (DB 스키마 변경 없음)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/card-management-section-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/card-management-section-plan.md`
|
||||
- Phase 1.1 변경: `docs/changes/20260122_card_transaction_dashboard_api.md`
|
||||
- Phase 1.2 변경: `docs/changes/20260122_loan_dashboard_api.md`
|
||||
- 기존 API 문서: `api/app/Swagger/v1/LoanApi.php`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-26
|
||||
**작업자:** Claude Code
|
||||
**관련 계획:** docs/plans/quote-management-url-migration-plan.md (Step 1.3, 1.4)
|
||||
**관련 계획:** docs/dev_plans/quote-management-url-migration-plan.md (Step 1.3, 1.4)
|
||||
|
||||
## 📋 변경 개요
|
||||
V2 견적 상세/수정 테스트 페이지(test/[id])에서 Mock 데이터를 실제 API 연동으로 변경
|
||||
@@ -135,7 +135,7 @@ const handleSave = useCallback(async (data: QuoteFormDataV2, saveType: "temporar
|
||||
- [ ] Step 2.3: 기존 V1 페이지 처리 결정
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/quote-management-url-migration-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/quote-management-url-migration-plan.md`
|
||||
- Step 1.1 변경 내역: `docs/changes/20260126_quote_v2_transform_functions.md`
|
||||
- Step 1.2 변경 내역: `docs/changes/20260126_quote_v2_test_new_api.md`
|
||||
- V2 컴포넌트: `react/src/components/quotes/QuoteRegistrationV2.tsx`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-26
|
||||
**작업자:** Claude Code
|
||||
**관련 계획:** docs/plans/quote-management-url-migration-plan.md (Step 1.2)
|
||||
**관련 계획:** docs/dev_plans/quote-management-url-migration-plan.md (Step 1.2)
|
||||
|
||||
## 📋 변경 개요
|
||||
V2 견적 등록 테스트 페이지(test-new)에서 Mock 저장을 실제 API 연동으로 변경
|
||||
@@ -76,6 +76,6 @@ const handleSave = useCallback(async (data: QuoteFormDataV2, saveType: 'temporar
|
||||
- [ ] test/[id] 수정 API 연동 (updateQuote)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/quote-management-url-migration-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/quote-management-url-migration-plan.md`
|
||||
- Step 1.1 변경 내역: `docs/changes/20260126_quote_v2_transform_functions.md`
|
||||
- V2 컴포넌트: `react/src/components/quotes/QuoteRegistrationV2.tsx`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-26
|
||||
**작업자:** Claude Code
|
||||
**관련 계획:** docs/plans/quote-management-url-migration-plan.md (Step 1.1)
|
||||
**관련 계획:** docs/dev_plans/quote-management-url-migration-plan.md (Step 1.1)
|
||||
|
||||
## 📋 변경 개요
|
||||
V2 견적 컴포넌트(QuoteRegistrationV2)에서 사용할 데이터 변환 함수 구현
|
||||
@@ -82,5 +82,5 @@ API 응답을 V2 폼 데이터로 변환
|
||||
- [ ] test/[id] 수정 API 연동 (updateQuote)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/quote-management-url-migration-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/quote-management-url-migration-plan.md`
|
||||
- V2 컴포넌트: `react/src/components/quotes/QuoteRegistrationV2.tsx`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-26
|
||||
**작업자:** Claude Code
|
||||
**관련 계획:** docs/plans/quote-management-url-migration-plan.md (Phase 1 버그 수정)
|
||||
**관련 계획:** docs/dev_plans/quote-management-url-migration-plan.md (Phase 1 버그 수정)
|
||||
|
||||
## 📋 변경 개요
|
||||
V2 견적 등록 컴포넌트에서 작성자 필드가 "드미트리"로 하드코딩된 버그 수정
|
||||
@@ -72,5 +72,5 @@ useEffect(() => {
|
||||
3. **edit/view 모드**: initialData의 writer 값 유지 (덮어쓰지 않음)
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/quote-management-url-migration-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/quote-management-url-migration-plan.md`
|
||||
- AuthContext: `react/src/contexts/AuthContext.tsx`
|
||||
@@ -98,7 +98,7 @@
|
||||
|
||||
## 🔗 관련 문서
|
||||
|
||||
- 계획 문서: `docs/plans/document-management-system-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/document-management-system-plan.md`
|
||||
- 다음 작업: Phase 1.2 - 모델 생성 (Document, DocumentApproval, DocumentData, DocumentAttachment)
|
||||
|
||||
## ⚠️ 배포 시 주의사항
|
||||
@@ -56,4 +56,4 @@
|
||||
## 🔗 관련 문서
|
||||
- Phase 1.1: 마이그레이션 (`20260128_document_management_phase1_1.md`)
|
||||
- Phase 1.2: 모델 생성 (별도 문서 없음, 커밋 참조)
|
||||
- 계획 문서: `docs/plans/document-management-system-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/document-management-system-plan.md`
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-28
|
||||
**작업자:** Claude Code
|
||||
**관련 문서:** docs/plans/kd-items-migration-plan.md
|
||||
**관련 문서:** docs/dev_plans/kd-items-migration-plan.md
|
||||
|
||||
## 📋 변경 개요
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-01-28
|
||||
**작업자:** Claude Code
|
||||
**관련 문서:** docs/plans/kd-items-migration-plan.md
|
||||
**관련 문서:** docs/dev_plans/kd-items-migration-plan.md
|
||||
|
||||
## 📋 변경 개요
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| `api/database/seeders/Kyungdong/KyungdongItemSeeder.php` | Phase 3.1, 3.2 메서드 추가 |
|
||||
| `docs/plans/kd-items-migration-plan.md` | Phase 3 완료 상태 업데이트 |
|
||||
| `docs/dev_plans/kd-items-migration-plan.md` | Phase 3 완료 상태 업데이트 |
|
||||
|
||||
## 🔧 상세 변경 사항
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**날짜:** 2026-02-05
|
||||
**작업자:** Claude Code
|
||||
**관련 계획:** docs/plans/incoming-inspection-templates-plan.md
|
||||
**관련 계획:** docs/dev_plans/incoming-inspection-templates-plan.md
|
||||
|
||||
## 📋 변경 개요
|
||||
5130 레거시 수입검사 양식 전환 작업 - Phase 1 완료
|
||||
@@ -18,7 +18,7 @@
|
||||
- `document_template_columns` - 84건 INSERT (7개 컬럼 × 12개 템플릿 19-30)
|
||||
|
||||
### 문서 변경
|
||||
- `docs/plans/incoming-inspection-templates-plan.md` - 진행 상태 업데이트
|
||||
- `docs/dev_plans/incoming-inspection-templates-plan.md` - 진행 상태 업데이트
|
||||
|
||||
## 🔧 상세 변경 사항
|
||||
|
||||
@@ -102,5 +102,5 @@
|
||||
4. React resolve API 테스트
|
||||
|
||||
## 🔗 관련 문서
|
||||
- 계획 문서: `docs/plans/incoming-inspection-templates-plan.md`
|
||||
- 계획 문서: `docs/dev_plans/incoming-inspection-templates-plan.md`
|
||||
- 레거시 참조: `5130/instock/i_SUSplate.php`
|
||||
@@ -209,4 +209,4 @@ BOM 산출 로직에서 단가를 가져오는 5130 테이블:
|
||||
| `api/app/Services/Quote/QuoteCalculationService.php` | 자동산출 실행 |
|
||||
| `api/app/Models/Items/Item.php` | Items 모델 |
|
||||
| `docs/features/quotes/README.md` | 견적 시스템 문서 |
|
||||
| `docs/plans/bom-item-mapping-plan.md` | 후속 작업 계획 |
|
||||
| `docs/dev_plans/bom-item-mapping-plan.md` | 후속 작업 계획 |
|
||||
|
Before Width: | Height: | Size: 134 KiB After Width: | Height: | Size: 134 KiB |
|
Before Width: | Height: | Size: 180 KiB After Width: | Height: | Size: 180 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
|
Before Width: | Height: | Size: 178 KiB After Width: | Height: | Size: 178 KiB |
|
Before Width: | Height: | Size: 182 KiB After Width: | Height: | Size: 182 KiB |
|
Before Width: | Height: | Size: 134 KiB After Width: | Height: | Size: 134 KiB |
|
Before Width: | Height: | Size: 138 KiB After Width: | Height: | Size: 138 KiB |
|
Before Width: | Height: | Size: 304 KiB After Width: | Height: | Size: 304 KiB |
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 130 KiB After Width: | Height: | Size: 130 KiB |
|
Before Width: | Height: | Size: 142 KiB After Width: | Height: | Size: 142 KiB |
|
Before Width: | Height: | Size: 228 KiB After Width: | Height: | Size: 228 KiB |