From 4ce1e3f8131e839dd2a9c8a2dc428a4438619e90 Mon Sep 17 00:00:00 2001 From: kimbokon Date: Tue, 30 Dec 2025 23:46:08 +0900 Subject: [PATCH] codepolicy addition --- codepolicy/index.php | 560 ++++++++++++++++++++++++++++++++ policy/index.php | 91 +++++- salesmanagement/수당지급체계.md | 33 +- 3 files changed, 671 insertions(+), 13 deletions(-) create mode 100644 codepolicy/index.php diff --git a/codepolicy/index.php b/codepolicy/index.php new file mode 100644 index 0000000..ca93b5b --- /dev/null +++ b/codepolicy/index.php @@ -0,0 +1,560 @@ + + + + + + + SAM Code Development Policy + + + + + + + +
+ +
+ Last Updated: 2025-12-19 +

SAM Code Development Policy

+

SAM 시스템의 견적, 수주, 생산, 출하, 품질 등 모든 MES 기능 개발에 적용되는 핵심 가이드라인 및 공통 정책입니다.

+
+ + +
+
+ +

📋 개요

+
+
+

이 문서는 SAM 시스템의 모든 기능 개발에 공통으로 적용되는 정책을 정의합니다. 각 기능별 개발 문서(MASTER_PLAN.md)는 반드시 이 공통 정책 문서를 참조하며, 정책 준수 여부가 품질 검증의 최우선 순위입니다.

+
+
+ + +
+
+ +

🚨 필수 준수 규칙

+
+
+ +
+

1. 테이블 정책

+
+

❌ 절대 금지

+
    +
  • 새로운 테이블을 임의로 생성 (price_new, order_items_v2 등)
    • +
  • 기존 테이블 구조를 사용자 승인 없이 변경
    • +
  • mng 프로젝트에서 마이그레이션 실행
    • +
+
+
+

✅ 필수 사항

+
    +
  • 기존 테이블을 최우선으로 분석하여 활용
    • +
  • 테이블 추가가 필요한 경우 반드시 사용자 승인 획득
    • +
  • DB 마이그레이션은 오직 api 프로젝트에서만 실행
    • +
+
+
+ + +
+

2. 프로젝트 스택

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
프로젝트기술 스택주의사항
mngLaravel 12 + Plain Blade + Tailwind + Filament❌ Alpine.js 금지
apiLaravel 12 REST API + SwaggerMulti-tenant 필수
5130PHP + jQuery + Legacy JS분석 및 참조용
reactNext.js 15프론트엔드 전담
+
+
+
+ + +
+

3. 코드 컨벤션 (추측 금지 원칙)

+

🔴 핵심: 모든 코드 요소는 실제 확인 후 사용

+
+
+

❌ 절대 금지 - 추측/할루시네이션

+
    +
  • 컬럼명 추측 (tenant.name → 실제는 tenant.company_name)
    • +
  • 관계명 추측 (user.roles → 실제는 user.userRoles)
    • +
  • 경로 및 메서드명 추측 (getName() → getCompanyName() 확인 필요)
    • +
  • 테이블명 확인 (users → sam_users 여부 확인)
    • +
+
+
+

✅ 필수 사항 - 확인 프로세스

+
    +
  • 모델 파일(app/Models/*.php)에서 컬럼/관계 직접 확인
    • +
  • 마이그레이션 파일에서 원본 데이터 구조 대조
    • +
  • 기존 컨트롤러/서비스의 실제 구현 패턴 확인
    • +
  • 불확실한 경우 주저하지 말고 사용자에게 질문
    • +
+
+
+
+
+ + +
+
+ +

🗄️ DB 테이블 상세 정책

+
+
+

테이블 설계 정책 (Hybrid EAV)

+
+
+

🔴 필수 컬럼 (일반 컬럼 생성)

+
    +
  • 조인에 사용되는 필드 (FK: tenant_id, product_id 등)
    • +
  • 인덱싱이 필요한 검색/정렬 필드 (status, created_at)
    • +
  • 고빈도 쿼리 WHERE 조건 필드
    • +
  • 유니크 제약이 필요한 고유 필드 (code, slug)
    • +
+
+
+

🟢 가변 컬럼 (options JSON 통합)

+
    +
  • 순수 비즈니스 로직용 데이터
    • +
  • 설정값, 부가 옵션 정보
    • +
  • 향후 확장 가능성이 높은 데이터
    • +
  • 조인이나 검색 필터로 사용되지 않는 필드
    • +
+
+
+ +
+

⚠️ Enum 지양 정책

+ 
+// ❌ 지양: DB Enum (변경 시 마이그레이션 복잡)
+$table->enum('status',['pending','approved','rejected']);
+
+// ✅ 권장: string + 코드 테이블 (common_codes)
+$table->string('status', 20)->default('pending');
+
+// ✅ 허용: boolean (명확한 2가지 상태)
+$table->boolean('is_active')->default(true);
+
+
+
+
+ + +
+
+ +

🔄 Phase 진행 및 커밋 정책

+
+
+
+

Phase 워크플로우

+
+
Step 1: 5130 리서치
원본 데이터 구조 분석
+
↓
+
Step 2: SAM 매핑
기존 확인 및 신규 설계
+
↓
+
Step 3: 필수/가변 분류
JSON 통합 필드 식별
+
↓
+
Step 4: 사용자 승인
설계 확정 후 구현 시작
+
+
+
+

세션 및 커밋 원칙

+
    +
  • 롤백 포인트: 각 Phase 완료 시 Git 태그 생성 필수
    • +
  • 세션 중단 대응: PROGRESS.md를 통해 컨텍스트 실시간 복구
    • +
  • 커밋 메시지: 반드시 한글로 작성하며 단계별 커밋
    • +
  • 푸시 정책: 커밋 후 푸시 여부는 묻지 않으며 사용자 수동 진행
    • +
+
+
+
+ + +
+
+ +

📝 변경 이력

+
+
+
+ + + + + + + + + + + + + + + +
날짜변경 내용작성자
2025-12-19초기 공통 정책 문서 작성 (MES 통합 가이드)Claude
+
+
+
+
+ + + + + + diff --git a/policy/index.php b/policy/index.php index dd24235..0e4a631 100644 --- a/policy/index.php +++ b/policy/index.php @@ -349,11 +349,84 @@ - +
- 02. Commission Ratios -

수당 지급 비율

+ 02. Product & Pricing +

02. 주요 상품 및 가격 안내

+

기본 기획된 SAM의 핵심 모듈 및 패키지 라인업입니다.

+
+ +
+

개별 모듈 (Modules)

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
상품명주요 기능 설명가입비 (VAT 별도)구독료 (월)
QR코드 관리설비/장비에 QR 부착하여 실시간 점검 및 이력 관리1,020만원5만원
사진/출하 관리현장 상황 사진 기록 및 출하 시점 품질 증빙 자동화1,920만원10만원
검사/토큰 적용공정별 검사 데이터 기록 및 전자 세금계산서 연동1,020만원5만원
이카운트 연동ERP(이카운트) 데이터 동기화 및 거래처 원장 관리1,920만원10만원
+
+
+ +
+

통합 패키지 (Packages)

+
+
+

공사관리 패키지

+

건설 및 공사 현장 관리에 최적화된 올인원 솔루션

+
+ 가입비: 4,000만원
+ 구독료: 20만원/월 +
+
+
+

공정/정부지원사업

+

정부 사업 규격에 맞춘 공정 관리 및 투명한 이력 추적

+
+ 가입비: 8,000만원
+ 구독료: 40만원/월 +
+
+
+
+
+ + +
+
+ 03. Commission Ratios +

03. 수당 지급 비율

@@ -396,8 +469,8 @@
- 03. Hierarchy Details -

계층 구조 및 수당 시뮬레이션

+ 04. Hierarchy Details +

04. 계층 구조 및 수당 시뮬레이션

영업 관리자의 수익은 자신의 활동뿐만 아니라 조직의 활성화에 따라 극대화됩니다.

@@ -443,8 +516,8 @@
- 04. Sales Success Workflow -

6단계 성공 프로세스

+ 05. Sales Success Workflow +

05. 6단계 성공 프로세스

단순한 판매를 넘어, 고객의 성공을 설계하는 표준 영업 프로세스입니다.

@@ -484,8 +557,8 @@
- 05. Schedule & Margin -

지급 일정 및 운영 정책

+ 06. Schedule & Margin +

06. 지급 일정 및 운영 정책

diff --git a/salesmanagement/수당지급체계.md b/salesmanagement/수당지급체계.md index 13f755f..7fda6bc 100644 --- a/salesmanagement/수당지급체계.md +++ b/salesmanagement/수당지급체계.md @@ -19,7 +19,32 @@ --- -## 2. 수당 지급 비율 +## 2. 주요 상품 및 가격 체계 + +### 2.1 개별 모듈 (Modules) +고객의 필요에 따라 특정 기능을 선택하여 도입할 수 있는 단위 상품입니다. + +| 상품명 | 주요 기능 | 가입비 (Join Fee) | 구독료 (Monthly) | +| :--- | :--- | :---: | :---: | +| **QR코드 관리** | 설비관리 및 장비 점검 | 1,020만원 | 5만원 | +| **사진/출하 관리** | 현장 사진 및 출하 증빙 관리 | 1,920만원 | 10만원 | +| **검사/토큰 적용** | 공정 검사 및 전자계산서 연동 | 1,020만원 | 5만원 | +| **이카운트 연동** | ERP(이카운트) 및 거래처 대장 | 1,920만원 | 10만원 | +| **ISO/인정서류** | 인증 서류 관리 및 토큰 적용 | 1,020만원 | 5만원 | +| **재고 관리** | 적정 재고 표기 및 입출고 관리 | 1,920만원 | 10만원 | +| **제조/발주 관리** | 제작 지시 및 외주 발주 관리 | 1,920만원 | 10만원 | + +### 2.2 패키지 상품 (Packages) +연관된 모듈을 통합하여 합리적인 가격으로 제공하는 솔루션 묶음입니다. + +| 패키지명 | 구성 및 특징 | 가입비 (Join Fee) | 구독료 (Monthly) | +| :--- | :--- | :---: | :---: | +| **공사관리 패키지** | 건설 및 공사 현장 특화 모듈 통합 | 4,000만원 | 20만원 | +| **공정/정부지원사업** | 스마트공장 및 지원사업 최적화 솔루션 | 8,000만원 | 40만원 | + +--- + +## 3. 수당 지급 비율 | 구분 | 지급 비율 | 설명 | |------|-----------|------| @@ -29,7 +54,7 @@ --- -## 3. 계층 구조 및 역할 +## 4. 계층 구조 및 역할 ### 3.1 역할 상세 @@ -47,7 +72,7 @@ --- -## 4. 수당 지급 프로세스 +## 5. 수당 지급 프로세스 1. **계약 체결**: 고객사와 서비스 이용 계약 완료 2. **가입비 납부**: 고객사가 가입비 전액을 본사에 납부 @@ -56,7 +81,7 @@ --- -## 5. 회사 마진 및 운영 정책 +## 6. 회사 마진 및 운영 정책 ### 5.1 마진 계산 - 회사 마진 = 가입비 - (판매자 수당 + 관리자 수당 + 메뉴제작 협업수당)