diff --git a/codepolicy/index.php b/codepolicy/index.php index ca93b5b..0c8e1d4 100644 --- a/codepolicy/index.php +++ b/codepolicy/index.php @@ -1,7 +1,8 @@ @@ -9,7 +10,7 @@ - SAM Code Development Policy + SAM Code Development Policy & AI Memory Kit @@ -17,23 +18,20 @@
- -
- Last Updated: 2025-12-19 + +
+
AI-Optimized Development Protocol

SAM Code Development Policy

-

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

+

견적, 수주, 생산, 출하, 품질 등 MES 핵심 개발을 위한 표준 가이드라인 및
AI 컨텍스트 관리(기억상실증 방지) 패키지

- +

📋 개요

-

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

+

이 문서는 SAM 시스템의 모든 기능 개발에 공통으로 적용되는 정책을 정의합니다.

+

각 기능별 개발 문서(MASTER_PLAN.md)는 이 문서를 참조합니다. 특히 AI 어시스턴트(Claude)가 세션 간의 컨텍스트를 잃지 않고, 일관된 품질의 코드를 생산하기 위한 기술적/정책적 장치를 포함하고 있습니다.

- +
- + +

🧠 AI 컨텍스트 관리 및 기억상실증 방지

+
+
+
+

AI 기억 유지 도구 (Memory Kit)

+
+

Core 구조적 장치

+
    +
  • CLAUDE.md: 프로젝트 기술 스택, 코딩 스타일, 개발 원칙 (루트 상시 배치)
    • +
  • PROGRESS.md: 현재 수행 중인 태스크, 완료 항목, 다음 단계(Next Step)
    • +
  • MASTER_PLAN.md: 특정 기능의 전체 아키텍처와 도메인 지식 기록
    • +
+
+
+

Skill 자동 복구 프로세스

+
    +
  • 세션 시작 루틴: AI 부팅 시 PROGRESS.md 로드
    • +
  • 체크포인트 커밋: 주요 로직 변경 후 상태 업데이트 강제 지시
    • +
  • 컨텍스트 요약(Compaction): 결정 사항을 요약하여 별도 파일 기록
    • +
+
+

출처: Anthropic Claude Code Context Management Guidelines & GitHub Open Projects

+
+ +
+

외부 메모리 솔루션 제안

+
+ + + + + + + + + + + + + + + + + + + + + +
솔루션기능 및 효과
MCPModel Context Protocol을 통한 장기 기억 저장
Super Claude Kit작업 상태 추적 및 레지스트리 관리
claunch프로젝트별 세션 관리 및 컨텍스트 로드
+
+
+
+
+ + +
+
+

🚨 필수 준수 규칙

-
-

1. 테이블 정책

+

1. 테이블 정책

❌ 절대 금지

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

✅ 필수 사항

+

✅ 필수

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

2. 프로젝트 스택

-
+

2. 프로젝트 기술 스택

+
@@ -374,18 +366,18 @@ - - + + - - + + - - + + @@ -399,130 +391,359 @@ -
-

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

+
+

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

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

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

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

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

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

✅ 필수 확인 우선순위

+
    +
  1. 모델 파일 (app/Models/*.php)
    2. +
  2. 마이그레이션 (database/migrations/*.php)
    3. +
  3. 기존 컨트롤러/서비스 사용 패턴
    4. +
  4. 불확실하면 → 반드시 질문
    5. +
- +
- -

🗄️ DB 테이블 상세 정책

+ +

🗄️ DB 테이블 및 설계 정책

-

테이블 설계 정책 (Hybrid EAV)

-
+

SAM 테이블 설계 정책 (Hybrid EAV)

+
-

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

+

🔴 필수 컬럼 (Stored Directly)

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

🟢 가변 컬럼 (options JSON 통합)

+
+

🟢 가변 컬럼 (options JSON)

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

⚠️ Enum 지양 정책

+

⚠️ 컬럼 타입 정책 (Enum 지양)

+
    +
  • ❌ 지양: DB enum 타입, PHP Enum 하드코딩
    • +
  • ✅ 권장: string/varchar + common_codes 테이블 관리
    • +
  • 💡 예외: is_* boolean 필드 (true/false 명확한 경우)
    • + 
-// ❌ 지양: DB Enum (변경 시 마이그레이션 복잡)
-$table->enum('status',['pending','approved','rejected']);
-
-// ✅ 권장: string + 코드 테이블 (common_codes)
+// ✅ 권장: string + 코드 테이블
 $table->string('status', 20)->default('pending');
-
-// ✅ 허용: boolean (명확한 2가지 상태)
+// ✅ 허용: is_* boolean
 $table->boolean('is_active')->default(true);
- +
-

🔄 Phase 진행 및 커밋 정책

+

🔄 Phase 진행 및 워크플로우

-

Phase 워크플로우

+

테이블 작업 프로세스

-
Step 1: 5130 리서치
원본 데이터 구조 분석
+
Step 1
5130 테이블 분석
↓
-
Step 2: SAM 매핑
기존 확인 및 신규 설계
+
Step 2
SAM 테이블 매핑 문서화
↓
-
Step 3: 필수/가변 분류
JSON 통합 필드 식별
+
Step 3
컬럼 분류 (필수 🔴 / 가변 🟢)
↓
-
Step 4: 사용자 승인
설계 확정 후 구현 시작
+
Step 4
사용자 승인 및 마이그레이션 생성
-

세션 및 커밋 원칙

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

    정책 충돌 해결 및 커밋

    +
      +
    • 최신 우선: 문서 간 충돌 시 최신 날짜 우선
      • +
    • 상위 우선: 상위 문서(CLAUDE.md) 우선
      • +
    • 롤백 포인트: 각 Phase 완료 시 Git 태그 생성
      • +
    • 커밋 메시지: 반드시 한글로 작성
- + +
+
+ +

🚀 Triple-Agent 협업 워크플로우

+
+

SAM 프로젝트는 Antigravity(실행), Claude Code(감리), TestSprite(검사)의 3단계 교차 검증을 통해 품질을 보증합니다.

+ +
+ +
+
+

Antigravity

+ The Doer +
+
    +
  • 설계 및 구현: 초기 마스터 플랜 수립 및 고속 코드 작성
    • +
  • UI/UX 가이드: 프리미엄 디자인 시스템(Glassmorphism) 적용
    • +
  • 컨텐츠 생성: 이미지, 텍스트 등 에셋 생성 주도
    • +
+
+ + +
+
+

Claude Code

+ The Auditor +
+
    +
  • 인프라 및 감리: 파일 구조, 터미널 명령, Git 관리
    • +
  • 계획 검증: Antigravity의 계획을 회사 정책 기반으로 검토
    • +
  • 보안 및 권한: API 명세 및 멀티테넌트 로직 체크
    • +
+
+ + +
+
+

TestSprite

+ The QA +
+
    +
  • E2E 브라우저 테스트: 사용자 관점의 프론트엔드 검증
    • +
  • Visual Regression: UI 깨짐 및 CSS 일치성 확인
    • +
  • 이슈 자동 수정: 발견된 버그의 자동 수정 제안 및 확인
    • +
+
+
+ + +
+

실전 협업 프로세스 (Execution Cycle)

+
+
mngLaravel 12 + Plain Blade + Tailwind + Filament❌ Alpine.js 금지Laravel 12 + Plain Blade + Tailwind❌ Alpine.js 금지
apiLaravel 12 REST API + SwaggerMulti-tenant 필수Laravel 12 + SwaggerMulti-tenant 필수
5130PHP + jQuery + Legacy JS분석 및 참조용PHP + jQuery분석 대상 (참조용)
react
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
단계활동주체참고 파일 (Artifacts)
1. 분석/설계요구사항 분석 및 아키텍처 수립AntigravityMASTER_PLAN.md
2. 정책 검증회사 정책 준수 여부 및 구조적 무결성 검토Claude CodeCLAUDE.md
3. 코드 구현검증된 계획 기반 고속 구현 (Phase별 진행)AntigravityPROGRESS.md
4. QA 명세테스트 시나리오 및 PSD(Product Spec) 생성Claude CodeQA_SPEC.md
5. 최종 검증브라우저 테스트 및 자동 버그 수정TestSpriteQA_REPORT.pnl
+
+
+
+ + +
+
+ +

📁 핵심 참고 파일 및 템플릿

+
+
+
+

필수 관리 문서 (Single Source of Truth)

+
+
+ + /docs/MASTER_PLAN.md + : 프로젝트의 북극성. 전체 기능 설계도. +
+
+ + /docs/PROGRESS.md + : 실시간 태스크 추적 및 컨텍스트 복구용. +
+
+ + /docs/QA_SPEC.md + : TestSprite 전용 제품 사양서(PSD). +
+
+
+
+

AI 가이드라인 파일 (Context Manager)

+
+
+ + /CLAUDE.md + : 프로젝트 고유 코딩 스타일 지침서. +
+
+ + /.claudecode/settings.json + : Claude Code의 인프라 설정. +
+
+ + /.agent/workflows/ + : 반복 작업 자동화 스크립트. +
+
+
+
+
+ + + + + +
+
+ +

⚡ Quick Start: 워크플로우 즉각 적용

+
+
+
+
+

1단계: 세션 부팅 (Context Load)

+

새 대화 시작 시 AI에게 다음 명령을 전달하여 컨텍스트를 동기화합니다.

+ 
+"PROGRESS.md와 CLAUDE.md를 읽고 현재 진행 중인 
+프로젝트의 상태와 코딩 규칙을 파악해줘."
+
+
+
+

2단계: 계획 수립 (Antigravity)

+

작업 시작 전 아키텍처를 설계하고 승인을 받습니다.

+ 
+"MASTER_PLAN_TEMPLATE.md를 기반으로 이번 
+기능의 상세 설계안을 작성해줘."
+
+
+
+
+
+

3단계: 정책 검증 (Claude Code)

+

계획이 회사 정책에 부합하는지 감리를 요청합니다.

+ 
+"이 설계안이 SAM DB 정책(Hybrid EAV)과 
+보안 가이드라인을 준수하는지 검토해줘."
+
+
+
+

4단계: QA 실행 (TestSprite)

+

구현 완료 후 브라우저 기반 자동 테스트를 수행합니다.

+ 
+"QA_SPEC.md를 기반으로 TestSprite를 실행하여 
+시나리오별 동작과 UI를 검증해줘."
+
+
+
+
+
+ +

📝 변경 이력

-
+
+ - + + + + + + + + + + + + + +
날짜버전 변경 내용작성자담당
2025-12-19v1.0 초기 공통 정책 문서 작성 (MES 통합 가이드) Claude
2025-12-31v1.1AI 기억상실증 방지 전략 추가Claude
2025-12-31v1.2Triple-Agent(Claude Code+Antigravity+TestSprite) 시너지 워크플로우 통합Antigravity
@@ -531,30 +752,202 @@ $table->boolean('is_active')->default(true);
-

© 2025 SAM MES Development Group. All Rights Reserved.

-

이 문서는 SAM 시스템의 공식 개발 정책을 따릅니다.

+

© 2025 SAM MES Development Group. Powered by Advanced Agentic Coding.

+

이 가이드는 AI 협업 효율을 극대화하기 위해 설계되었습니다.

diff --git a/codepolicy/templates/CLAUDE_TEMPLATE.md b/codepolicy/templates/CLAUDE_TEMPLATE.md new file mode 100644 index 0000000..a40a3a0 --- /dev/null +++ b/codepolicy/templates/CLAUDE_TEMPLATE.md @@ -0,0 +1,22 @@ +# SAM Project Guidelines + +## Core Principles +1. **Anti-Hallucination**: Never guess column names. Check `app/Models/` or migrations. +2. **Hybrid EAV**: Follow `sales/codepolicy/index.php` for table design. +3. **Clean Code**: Maintain Laravel 12 best practices and Next.js 15 standards. + +## Project Structure +- `api/`: Laravel 12 REST API + Swagger +- `mng/`: Filament PHP Admin (Blade/Tailwind) +- `react/`: Next.js 15 Frontend +- `docs/`: Master plans and progress logs + +## Tech Stack Rules +- **Admin**: Use Filament v3. No Alpine.js in standard blade files unless necessary. +- **Styling**: Vanilla CSS + Tailwind. Glassmorphism is the standard UI theme. +- **Testing**: Use TestSprite for visual and E2E QA. + +## Workflow Integration +- Use Antigravity for UI and complex logic planning. +- Use Claude Code for infrastructure, linting, and git operations. +- Always update `PROGRESS.md` before ending a session. diff --git a/codepolicy/templates/MASTER_PLAN_TEMPLATE.md b/codepolicy/templates/MASTER_PLAN_TEMPLATE.md new file mode 100644 index 0000000..471c1d8 --- /dev/null +++ b/codepolicy/templates/MASTER_PLAN_TEMPLATE.md @@ -0,0 +1,34 @@ +# [기능명] Master Plan - v1.0 + +## 1. 개요 (Overview) +- **목적**: [기능의 핵심 목적 작성] +- **대상**: [수혜자 및 관련 모듈] +- **배경**: [기존 5130 시스템 대비 개선 사항] + +## 2. 아키텍처 설계 (Architecture) +### 2.1 DB 설계 (Hybrid EAV) +- **필수 컬럼 (Stored)**: `id`, `tenant_id`, [주요 필드] +- **가변 컬럼 (JSON options)**: `settings`, `metadata`, [확장 필드] + +### 2.2 기술 스택 +- **Backend**: Laravel 12 API (api 프로젝트) +- **Admin**: Filament PHP (mng 프로젝트) +- **Frontend**: Next.js 15 (react 프로젝트) + +## 3. 구현 단계 (Phases) +### Phase 1: DB & 모델링 +- [ ] 마이그레이션 생성 (api) +- [ ] Eloquent 모델 및 관계 설정 + +### Phase 2: 비즈니스 로직 (API) +- [ ] 컨트롤러 구현 +- [ ] API 명세서 업데이트 (Swagger) + +### Phase 3: UI/UX 구현 (mng/react) +- [ ] 관리자 페이지 구성 +- [ ] 사용자 프론트엔드 연동 + +## 4. 검증 포인트 (Verification) +- [Antigravity] 디자인 시스템 준수 여부 +- [Claude Code] 보안 취약점 및 정책 준수 체크 +- [TestSprite] 주요 시나리오 E2E 테스트 diff --git a/codepolicy/templates/PROGRESS_LOG_TEMPLATE.md b/codepolicy/templates/PROGRESS_LOG_TEMPLATE.md new file mode 100644 index 0000000..bc8d2f8 --- /dev/null +++ b/codepolicy/templates/PROGRESS_LOG_TEMPLATE.md @@ -0,0 +1,20 @@ +# Progress Log - [프로젝트명] + +## 🚀 실시간 진행 현황 +- **현재 단계**: Phase [N] 구현 중 +- **진행률**: [NN]% +- **최근 완료**: [최근 완료된 항목] + +## 📝 작업 기록 (Context History) +| 날짜 | 단계 | 내용 | 담당 | 비고 | +| :--- | :--- | :--- | :--- | :--- | +| 202X-XX-XX | Phase 1 | DB 마이그레이션 및 기본 모델 생성 | Claude Code | 완료 | +| 202X-XX-XX | Phase 2 | 리스트 조회 API 및 필터 기능 추가 | Antigravity | 진행 중 | + +## 🧠 컨텍스트 요약 (Amnesia Recovery) +- **핵심 결정 사항**: [중요 아키텍처 결정 내용] +- **다음 세션 시작 지점**: [AI가 다음 세션에서 바로 이어서 해야 할 일] +- **주의 사항**: [구현 중 발견된 특이 사항] + +## 🚩 이슈 및 차단 사항 (Blockers) +- [ ] [현재 해결되지 않은 기술적 이슈] diff --git a/codepolicy/templates/QA_SPEC_TEMPLATE.md b/codepolicy/templates/QA_SPEC_TEMPLATE.md new file mode 100644 index 0000000..9b507b4 --- /dev/null +++ b/codepolicy/templates/QA_SPEC_TEMPLATE.md @@ -0,0 +1,24 @@ +# Product Specification (PSD) for TestSprite QA + +## 1. Feature Description +- **Target URL**: `http://localhost:8000/[path]` +- **Goal**: [테스트를 통해 검증하고자 하는 핵심 사용자 가치] + +## 2. User Scenarios +### Scenario 1: [시나리오 명] +1. **Given**: [사용자의 초기 상태] +2. **When**: [사용자가 수행하는 액션] +3. **Then**: [기대하는 결과 및 화면 변화] + +### Scenario 2: [에지 케이스 시나리오] +... + +## 3. UI Checkpoints +- [ ] 버튼 클릭 시 로딩 애니메이션 표시 여부 +- [ ] 입력 폼 유효성 검사 (Validation) 메시지 확인 +- [ ] 반응형 레이아웃 (모바일/데스크탑) 정렬 상태 + +## 4. Visual Standards +- **Font**: Inter, Outfit 체 사용 여부 +- **Color**: Dark mode (#030712) 배경 및 Glassmorphism 투명도 확인 +- **Icon**: Lucide 아이콘 일관성 diff --git a/etc/shutter.php b/etc/shutter.php new file mode 100644 index 0000000..653641d --- /dev/null +++ b/etc/shutter.php @@ -0,0 +1,990 @@ + + + + + + 자동방화셔터 품질인정제도 가이드 + + + + + + + + + + + +
+ + +
+
+
+
+
+
+
+ + 국토교통부고시 제2021-1009호 적용 +
+

+ 자동방화셔터
+ 품질인정제도 완벽 가이드 +

+

+ 화재 시 연기와 열을 감지하여 자동 폐쇄되는 방화셔터.
+ 2021년 강화된 품질인정제도의 모든 것을 알아보세요. +

+
+ + +
+
+
+ + +
+
+
1
+
+

자동방화셔터란?

+

Fire Shutter Overview

+
+
+ +
+
+
+

+ 🏢 정의 및 역할 +

+

+ 자동방화셔터는 방화구획의 용도로 화재 시 연기 및 열을 감지하여 자동 폐쇄되는 설비입니다. +

+

+ 공항, 체육관, 대형마트 등 넓은 공간에서 내화구조 벽을 설치하기 어려운 경우에 방화구획을 형성하는 핵심 장치입니다. +

+
+
+

+ ⚖️ 법적 근거 +

+
    +
  • + ▸ + 건축법 시행령 제46조 - 방화구획 설치 의무 +
    • +
  • + ▸ + 국토부고시 제2021-1009호 - 방화문 및 자동방화셔터의 인정 및 관리기준 +
    • +
  • + ▸ + KS F 4510 - 중량셔터 성능 기준 +
    • +
+
+
+ + +
+
+
+ ⚠️ +
+
+

2021년 핵심 변화: 일체형 방화셔터 사용 금지

+

+ 셔터 일부에 피난 출입구가 설치된 일체형 방화셔터는 피난로 인지 지연 및 처짐으로 인한 비상문 개폐 불량 문제로 설치가 금지되었습니다. + 반드시 분리형(60분 방화문 3m 이내 별도 설치)으로 설계해야 합니다. +

+
+
+
+
+
+ + +
+
+
2
+
+

방화셔터의 종류

+

Types of Fire Shutters

+
+
+ + +
+ + + +
+ + +
+
+
🔩
+
+

철재 방화셔터 (Steel Fire Shutter)

+

강판 슬랫으로 제작된 전통적인 방화셔터

+
+
+
+
+

구조 및 재질

+
    +
  • ✓ 1.55T 전기도금 아연강판
    • +
  • ✓ 72mm 슬랫 포밍 구조
    • +
  • ✓ 스틸 가이드레일
    • +
  • ✓ 전동/수동 개폐 장치
    • +
+
+
+

적용 환경

+
    +
  • ▸ 외부와 접촉된 방화구획
    • +
  • ▸ 지하주차장 램프
    • +
  • ▸ 가연성 물질 근접 구역
    • +
  • ▸ 바람 영향을 받는 구역
    • +
+
+
+
+ + + + + + +
+ + +
+
+
3
+
+

성능 기준

+

Performance Standards

+
+
+ +
+ +
+
+ 🔥 +
+

내화성능

+

Fire Resistance

+
+

비차열 1시간 이상

+

KS F 2268-1에 따른 내화시험 기준

+
+

+ 화재 시 가열면의 반대쪽으로 화염이 관통하지 않는 성능 +

+
+ + +
+
+ 💨 +
+

차연성능

+

Smoke Leakage

+
+

KS F 4510 기준

+

중량셔터 차연성능 규정 충족

+
+

+ 연기의 누설을 차단하여 피난 시간 확보 +

+
+ + +
+
+ ⚙️ +
+

개폐성능

+

Operation

+
+

전동 + 수동

+

KS F 4510 개폐성능 규정 충족

+
+

+ 정전 시에도 수동으로 개폐 가능해야 함 +

+
+ + +
+
+ 📡 +
+

감지기 연동

+

Detector Integration

+
+
+ 연기/불꽃 감지 + 일부 폐쇄 +
+
+ 열 감지 + 완전 폐쇄 +
+
+

+ 2단계 폐쇄 시스템으로 피난 시간 확보 +

+
+
+ + +
+

품질인정서 유효기간

+
+ +
+

+ 자동방화셔터는 5년 유효기간이 적용되며, 만료 전 갱신 심사 필요 +

+
+
+ + +
+
+
4
+
+

품질인정 절차

+

Recognition Process

+
+
+ +
+
+
+ 🏛️ +
+ 운영 기관: 한국건설기술연구원(KICT) +
+ +
+ +
+ +
+
1
+
+
+

성능 시험 신청

+ +
+
+ + +
+
2
+
+
+

공장 심사

+ +
+
+ + +
+
3
+
+
+

품질인정서 발급

+ +
+
+ + +
+
4
+
+

사후 관리

+ +
+
+
+
+ + + + + +
+ ⏱️ +

+ 예상 소요기간: 성능시험부터 인정서 발급까지 통상 3개월 이상 소요 +

+
+
+
+ + +
+
+
5
+
+

설치 기준

+

Installation Standards

+
+
+ +
+ +
+

+ ✓ 필수 설치 요건 +

+
    +
  • + 01 +
    +

    방화문 인접 설치

    +

    60분+ 또는 60분 방화문으로부터 3m 이내 별도 설치

    +
    +
    • +
  • + 02 +
    +

    감지기 설치

    +

    불꽃감지기 또는 연기감지기 + 열감지기 동시 설치

    +
    +
    • +
  • + 03 +
    +

    2단계 폐쇄 구조

    +

    연기감지 → 일부폐쇄 / 열감지 → 완전폐쇄

    +
    +
    • +
  • + 04 +
    +

    상부 밀착

    +

    셔터 상부는 상층 바닥에 직접 닿도록 설치

    +
    +
    • +
+
+ + +
+

+ ✕ 금지 사항 +

+
    +
  • + ⛔ +
    +

    일체형 방화셔터 설치 금지

    +

    셔터 일부에 피난 출입구가 설치된 구조는 2020년부터 금지

    +
    +
    • +
  • + ⚠️ +
    +

    틈새 방치 금지

    +

    바닥과의 틈새는 연기/열 이동통로가 되지 않도록 방화구획 수준으로 처리

    +
    +
    • +
  • + ⚠️ +
    +

    스크린 셔터 외부 설치 금지

    +

    바람의 영향을 받는 외부 구역에는 스크린 방화셔터 설치 불가

    +
    +
    • +
+
+
+ + +
+

자동방화셔터 구성요소

+
+
+
📦
+

셔터박스

+

Shutter Box

+
+
+
🎚️
+

가이드레일

+

Guide Rail

+
+
+
📏
+

슬랫/커튼

+

Slat/Curtain

+
+
+
⚡
+

개폐기

+

Operator

+
+
+
🔘
+

제어반

+

Control Panel

+
+
+
📡
+

연기감지기

+

Smoke Detector

+
+
+
🌡️
+

열감지기

+

Heat Detector

+
+
+
🚪
+

연동 방화문

+

Fire Door

+
+
+
+
+ + +
+
+
6
+
+

현장 실무 체크리스트

+

Field Checklist

+
+
+ +
+ +
+
+
필수 서류
+ +
+

품질인정서

+

KICT 원장 명의 발급 인정서 원본/사본

+
+

✓ 유효기간 확인 (5년)

+

✓ 제조 공장 주소 일치 여부

+

✓ 인정 규격과 납품 제품 일치 여부

+
+
+ +
+
+
필수 서류
+ +
+

품질관리서

+

제조사 → 감리자 제출 자체 보증서

+
+

✓ "인정 내용과 동일 생산" 문구

+

✓ 제조일자 및 LOT 번호

+

✓ 제조사 직인/서명

+
+
+ +
+
+
현장 확인
+ +
+

설치 상태 점검

+

현장 설치 적합성 육안 확인

+
+

✓ 방화문 3m 이내 설치 여부

+

✓ 상부 바닥 밀착 여부

+

✓ 가이드레일 내화벽체 접촉 여부

+
+
+ +
+
+
현장 확인
+ +
+

작동 시험

+

감지기 연동 및 폐쇄 동작 확인

+
+

✓ 연기감지 → 일부폐쇄 동작

+

✓ 열감지 → 완전폐쇄 동작

+

✓ 수동 개폐 정상 작동

+
+
+
+ + +
+ 위 항목들을 모두 확인해주세요. +
+
+
+
+ + +
+
+
🖥️
+
+

온라인 진위 확인

+

KICT 홈페이지에서 인정 취소/정지 여부 실시간 조회

+
+
+ + KICT 현황 조회 → + +
+
+ +
+ + +
+
+
+
+ 🔥 +
+ 자동방화셔터 품질인정제도 가이드 +
+

참고 법령: 방화문 및 자동방화셔터의 인정 및 관리기준 (국토교통부고시 제2021-1009호)

+

본 페이지는 교육 및 참고 목적으로 제작되었습니다. 정확한 법적 해석은 관련 기관에 문의하세요.

+

© 2025 Fire Shutter Quality Recognition Guide

+
+
+ + + + + \ No newline at end of file diff --git a/policy/SAM_영업정책문서.html b/policy/SAM_영업정책문서.html new file mode 100644 index 0000000..702bbee --- /dev/null +++ b/policy/SAM_영업정책문서.html @@ -0,0 +1,425 @@ + + + + + + SAM Project - 영업 수당 지급 정책 + + + +
+

SAM Project
영업 수당 지급 정책

+
+ 버전: 1.0  |  + 최종 업데이트: 2025년 1월 1일  |  + 기반 자료: 수당지급체계.md +
+
+ +
+

📋목차

+
    +
  • 기본 원칙 및 대상
    • +
  • 주요 상품 및 가격 안내
    • +
  • 수당 지급 비율
    • +
  • 계층 구조 및 수당 시뮬레이션
    • +
  • 6단계 성공 프로세스
    • +
  • 지급 일정 및 운영 정책
    • +
  • 주요 Q&A
    • +
+
+ +

1. 기본 원칙 및 대상

+ +
+

🎯가입비 중심 보상

+

수당은 1회성 가입비에 대해서만 지급됩니다. 이는 고품질의 초기 인프라 구축 및 파트너의 적극적인 유치를 지원하기 위함입니다.

+
+ +
+

📊협업 중심 구조

+

판매자와 관리자뿐만 아니라 기술 지원을 담당하는 메뉴제작 협업자에게도 적절한 보상을 제공하여 유기적인 서비스 제공이 가능하도록 돕습니다.

+
+ +

2. 주요 상품 및 가격 안내

+ +

📦개별 모듈 (Modules)

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

🎁통합 패키지 (Packages)

+ +
+

공사관리 패키지

+

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

+

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

+
+ +
+

공정/정부지원사업

+

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

+

가입비: 8,000만원 | 구독료: 40만원/월

+
+ +

3. 수당 지급 비율

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
구분지급 비율대상 및 정의
판매자 (Seller)20%직접 영업 및 계약 성사 담당자
관리자 (Manager)5%하위 영업 파트너 관리 및 지원
메뉴제작 협업수당별도운영팀에서 난이도별 별도 산정 (실비 보조)
수당 정산 기준가입비 입금 확인 후 익월 지급
+ +

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

+ +
+

🏗️계층 구조

+

+ [판매자 20%] → [관리자 5%] → [메뉴제작 +α]
+     ↓              ↓              ↓
+   영업권         관리권        기술지원 +

+
+ +

💰계산 예시 (총 가입비 1억원 기준)

+ +
+

판매자 수당

+

계산: ₩100,000,000 × 20% = ₩20,000,000

+
+ +
+

관리자 수당

+

계산: ₩100,000,000 × 5% = ₩5,000,000

+
+ +
+

메뉴제작 협업수당

+

운영팀 별도 산정 및 지급

+
+ +
+

총 가입비 수당: 25% + 메뉴제작비

+
+ +

5. 6단계 성공 프로세스

+

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

+ +
+

1️⃣사전 준비 (Prep)

+

고객사 심층 분석 및 경쟁사 동향 파악. '비용 절감'과 '관리 효율' 중 핵심 공략 포인트 설정.

+
+ +
+

2️⃣접근 및 탐색 (Approach)

+

Key-man 식별 및 컨택. 단순 소개가 아닌 '인사이트 공유'를 목적으로 미팅 기회 확보.

+
+ +
+

3️⃣제안 및 솔루션

+

AI 교차 검증 전략(Antigravity/Claude Code)을 통한 압도적인 품질 및 비용 효율 제안.

+
+ +
+

4️⃣계약 체결 (Closing)

+

가입비 확정 및 서비스 범위(SOW) 명시. 수당 산정의 기준이 되는 가입비 완료 유도.

+
+ +
+

5️⃣영업 이관 (Handover)

+

영업팀에서 매니저 시나리오로의 완벽한 정보 전달. 리스크 요인 및 고객 특이사항 공유.

+
+ +
+

6️⃣테스트 및 안정화

+

TestSprite MCP를 통한 자동화 검증으로 '버그 없는 배포'를 실현하여 고객 신뢰 확보.

+
+ +

6. 지급 일정 및 운영 정책

+ +
+

📅수당 지급 시점

+

고객사의 가입비 입금이 완료된 날을 기준으로 수당이 확정되며, 익월 정해진 지급일에 일괄 지급됩니다.

+
+ +
+

🏦회사 운영 마진

+

회사는 가입비의 약 70% ~ 75% 내외를 플랫폼 운영, 서버 유지보수, 마케팅 지원 등을 위한 인프라 비용으로 확보하여 지속 가능한 경영 토대를 구축합니다.

+
+ +

7. 주요 Q&A

+ +
+

Q. 하위 파트너가 없는 경우는 어떻게 되나요?

+

본인의 직접 판매에 대한 20% 수당만 지급됩니다. 관리자 및 교육자 수당은 하위 계층이 형성되었을 때만 발생합니다.

+
+ +
+

Q. 계약이 취소되면 수당을 반환해야 하나요?

+

이미 지급된 가입비 수당은 회수하지 않는 것을 원칙으로 하나, 부정 계약 등의 특수 상황 발생 시 별도 심의가 있을 수 있습니다.

+
+ +
+

Q. 월 구독료에 대한 수당은 없나요?

+

현재 SAM 수당 정책은 신규 파트너십 구축 및 인프라 기여도에 대한 가치를 높게 평가하여 가입비에만 수당을 집중하고 있습니다. 구독료는 서비스의 안정적 유지 및 고도화 비용으로 활용됩니다.

+
+ +
+

📞문의사항

+

본 문서는 SAM 프로젝트의 공식 영업 정책을 담고 있으며, 정책 변경 시 업데이트될 수 있습니다.

+

© 2025 SAM Project Admin. All Rights Reserved.

+
+

본 문서는 투명하고 합리적인 3단계 보상 체계를 통해 파트너의 성장을 지원하기 위해 작성되었습니다.

+
+ + \ No newline at end of file diff --git a/policy/SAM_영업정책문서.md b/policy/SAM_영업정책문서.md new file mode 100644 index 0000000..7029d46 --- /dev/null +++ b/policy/SAM_영업정책문서.md @@ -0,0 +1,147 @@ +# SAM Project - 영업 수당 지급 정책 + +**버전**: 1.0 +**최종 업데이트**: 2025년 1월 1일 +**기반 자료**: `C:\Users\light\sam\sales\salesmanagement\수당지급체계.md` + +--- + +## 📋 목차 + +1. [기본 원칙 및 대상](#1-기본-원칙-및-대상) +2. [주요 상품 및 가격 안내](#2-주요-상품-및-가격-안내) +3. [수당 지급 비율](#3-수당-지급-비율) +4. [계층 구조 및 수당 시뮬레이션](#4-계층-구조-및-수당-시뮬레이션) +5. [6단계 성공 프로세스](#5-6단계-성공-프로세스) +6. [지급 일정 및 운영 정책](#6-지급-일정-및-운영-정책) +7. [주요 Q&A](#7-주요-qa) + +--- + +## 1. 기본 원칙 및 대상 + +### 🎯 가입비 중심 보상 +수당은 1회성 **가입비**에 대해서만 지급됩니다. 이는 고품질의 초기 인프라 구축 및 파트너의 적극적인 유치를 지원하기 위함입니다. + +### 📊 협업 중심 구조 +판매자와 관리자뿐만 아니라 기술 지원을 담당하는 메뉴제작 협업자에게도 적절한 보상을 제공하여 유기적인 서비스 제공이 가능하도록 돕습니다. + +--- + +## 2. 주요 상품 및 가격 안내 + +### 📦 개별 모듈 (Modules) + +| 상품명 | 주요 기능 설명 | 가입비 (VAT 별도) | 구독료 (월) | +|--------|----------------|-------------------|-------------| +| **QR코드 관리** | 설비/장비에 QR 부착하여 실시간 점검 및 이력 관리 | 1,020만원 | 5만원 | +| **사진/출하 관리** | 현장 상황 사진 기록 및 출하 시점 품질 증빙 자동화 | 1,920만원 | 10만원 | +| **검사/토큰 적용** | 공정별 검사 데이터 기록 및 전자 세금계산서 연동 | 1,020만원 | 5만원 | +| **이카운트 연동** | ERP(이카운트) 데이터 동기화 및 거래처 원장 관리 | 1,920만원 | 10만원 | + +### 🎁 통합 패키지 (Packages) + +#### 공사관리 패키지 +- **설명**: 건설 및 공사 현장 관리에 최적화된 올인원 솔루션 +- **가입비**: 4,000만원 +- **구독료**: 20만원/월 + +#### 공정/정부지원사업 +- **설명**: 정부 사업 규격에 맞춘 공정 관리 및 투명한 이력 추적 +- **가입비**: 8,000만원 +- **구독료**: 40만원/월 + +--- + +## 3. 수당 지급 비율 + +| 구분 | 지급 비율 | 대상 및 정의 | +|------|-----------|--------------| +| **판매자 (Seller)** | **20%** | 직접 영업 및 계약 성사 담당자 | +| **관리자 (Manager)** | **5%** | 하위 영업 파트너 관리 및 지원 | +| **메뉴제작 협업수당** | **별도** | 운영팀에서 난이도별 별도 산정 (실비 보조) | + +**수당 정산 기준**: 가입비 입금 확인 후 익월 지급 + +--- + +## 4. 계층 구조 및 수당 시뮬레이션 + +### 🏗️ 계층 구조 +``` +[판매자 20%] → [관리자 5%] → [메뉴제작 +α] + ↓ ↓ ↓ + 영업권 관리권 기술지원 +``` + +### 💰 계산 예시 (총 가입비 1억원 기준) + +#### 판매자 수당 (2,000만원) +- 계산: ₩100,000,000 × 20% = **₩20,000,000** + +#### 관리자 수당 (2,000만원) +- 계산: ₩100,000,000 × 5% = **₩5,000,000** + +#### 메뉴제작 협업수당 +- **운영팀 별도 산정 및 지급** + +**총 가입비 수당**: 25% + 메뉴제작비 + +--- + +## 5. 6단계 성공 프로세스 + +단순한 판매를 넘어, 고객의 성공을 설계하는 표준 영업 프로세스입니다. + +### 1️⃣ 사전 준비 (Prep) +고객사 심층 분석 및 경쟁사 동향 파악. '비용 절감'과 '관리 효율' 중 핵심 공략 포인트 설정. + +### 2️⃣ 접근 및 탐색 (Approach) +Key-man 식별 및 컨택. 단순 소개가 아닌 '인사이트 공유'를 목적으로 미팅 기회 확보. + +### 3️⃣ 제안 및 솔루션 +AI 교차 검증 전략(Antigravity/Claude Code)을 통한 압도적인 품질 및 비용 효율 제안. + +### 4️⃣ 계약 체결 (Closing) +가입비 확정 및 서비스 범위(SOW) 명시. 수당 산정의 기준이 되는 가입비 완료 유도. + +### 5️⃣ 영업 이관 (Handover) +영업팀에서 매니저 시나리오로의 완벽한 정보 전달. 리스크 요인 및 고객 특이사항 공유. + +### 6️⃣ 테스트 및 안정화 +TestSprite MCP를 통한 자동화 검증으로 '버그 없는 배포'를 실현하여 고객 신뢰 확보. + +--- + +## 6. 지급 일정 및 운영 정책 + +### 📅 수당 지급 시점 +고객사의 가입비 입금이 완료된 날을 기준으로 수당이 확정되며, 익월 정해진 지급일에 일괄 지급됩니다. + +### 🏦 회사 운영 마진 +회사는 가입비의 약 **70% ~ 75%** 내외를 플랫폼 운영, 서버 유지보수, 마케팅 지원 등을 위한 인프라 비용으로 확보하여 지속 가능한 경영 토대를 구축합니다. + +--- + +## 7. 주요 Q&A + +### Q. 하위 파트너가 없는 경우는 어떻게 되나요? +본인의 직접 판매에 대한 20% 수당만 지급됩니다. 관리자 및 교육자 수당은 하위 계층이 형성되었을 때만 발생합니다. + +### Q. 계약이 취소되면 수당을 반환해야 하나요? +이미 지급된 가입비 수당은 회수하지 않는 것을 원칙으로 하나, 부정 계약 등의 특수 상황 발생 시 별도 심의가 있을 수 있습니다. + +### Q. 월 구독료에 대한 수당은 없나요? +현재 SAM 수당 정책은 신규 파트너십 구축 및 인프라 기여도에 대한 가치를 높게 평가하여 **가입비**에만 수당을 집중하고 있습니다. 구독료는 서비스의 안정적 유지 및 고도화 비용으로 활용됩니다. + +--- + +## 📞 문의사항 + +본 문서는 SAM 프로젝트의 공식 영업 정책을 담고 있으며, 정책 변경 시 업데이트될 수 있습니다. + +**© 2025 SAM Project Admin. All Rights Reserved.** + +--- + +*본 문서는 투명하고 합리적인 3단계 보상 체계를 통해 파트너의 성장을 지원하기 위해 작성되었습니다.* \ No newline at end of file