[docs] 가이드라인 md 양식

# 🔧 [프로젝트] 전체 구현 통제 지침서  
*AI 모델 전용 단계별 실행 가이드*

---

## 🎯 문서 목적  
**AI 모델이 지정된 순서와 규칙에 따라  프로젝트를 정확하게 구현하도록 통제하는 문서입니다.**  
모든 파일 작업은 지침서에 명시된 문서 순서와 구현 순서만을 따라야 하며, 추측이나 판단 없이 지시만 수행해야 합니다.

---

## 📁 프로젝트 디렉토리 구조 (읽기 전 필수 확인)

```
project-root/
├── database_schema.sql                   # ⭐ 1단계 필수
├── docs/
│   ├── controller_guide.md              # ⭐ 2단계 필수
│   ├── core_functions_guide.md          # ⭐ 3단계 필수  
│   └── html_mapping_rules.md            # ⭐ 4단계 필수
├── templates/                           # HTML 시안 (변환 대상)
│   ├── home.html
│   ├── list.html
│   ├── article.html
│   └── (기타 시안 HTML 파일들)
└── (PHP 구현 대상 파일 위치)
```

---

## 🚨 AI 모델 절대 준수 규칙

### ❌ 금지사항
1. **비지정 문서 우선 참조 금지** (특정 디자인 문서 등)
2. **단계 순서 임의 변경 금지** – 반드시 1단계부터 순차 진행
3. **추측, 유추, 자의적 판단 금지**
4. **클래스 기반(OOP) 구현 금지** – 함수 기반만 허용

### ✅ 수행 필수사항
1. **docs/ 내 지정 문서만 사용**
2. **단계별 완료 조건 충족 시 다음 단계로 이동**
3. **templates/ 시안은 100% 복사하여 PHP 변환**
4. **모든 구현은 순수 함수로 작성**

---

## 📚 단계별 작업 순서

### 🧩 1단계: 데이터베이스 구조 파악
**읽을 문서**: `project-root/database_schema.sql`

**목표**:
- 전체 테이블 구조 숙지
- 필드, 타입, 인덱스, 제약조건, ENUM 파악

**체크리스트**:
```
□ 사용자 계정 관련 테이블 구조 숙지
□ 콘텐츠 관리 관련 테이블 구조 숙지
□ 코멘트 및 피드백 테이블 구조 숙지
□ 관리자 전용 기록 테이블 구조 숙지
□ 시스템 설정 및 로그 테이블 구조 숙지
□ 외래키, 인덱스 구성 완전 숙지
```

---

### 📦 2단계: 컨트롤러 규칙 확인
**읽을 문서**: `docs/controller_guide.md`

**목표**:
- 함수 중심 구현 원칙 이해
- 환경 제약사항 확인 (ex. PHP 8.x, 외부 라이브러리 미사용 등)
- 페이지 접근 권한 흐름 이해

**체크리스트**:
```
□ 클래스/프레임워크 사용 금지 규칙 숙지
□ 권한 계층 (방문자 < 일반회원 < 관리자 등) 구조 이해
□ 1단계 테이블 전부 사용 강제 규칙 확인
```

---

### 🧠 3단계: 코어 함수 구조 이해
**읽을 문서**: `docs/core_functions_guide.md`

**목표**:
- 각 lib/*.php 함수의 역할 이해
- 함수 간 의존 흐름 및 연관 수정 함수 파악

**체크리스트**:
```
□ lib/db.php: DB 연결 및 질의 함수 파악
□ lib/session.php: 세션 관리 함수 이해
□ lib/user.php: 사용자 관련 함수 구조 숙지
□ lib/content.php: 게시물, 댓글 등 콘텐츠 함수 숙지
□ lib/admin.php: 관리자 기능 함수 구조 파악
```

---

### 🎨 4단계: HTML → PHP 매핑 규칙 이해
**읽을 문서**: `docs/html_mapping_rules.md`

**목표**:
- templates/ 시안 파일들을 동일 구조의 PHP로 변환
- includes 구조와 절대경로 규칙 파악

**체크리스트**:
```
□ templates/ 시안 HTML은 100% 구조 복사
□ includes/ 구성 (header.php, footer.php 등) 이해
□ HTML과 PHP의 위치 1:1 대응 관계 확인
□ 파일명, 폴더 구조 간소화 유지 원칙 확인
```

---

## 🛠️ 5단계: 구현 단계 (1~4단계 완료 후에만 실행)

### 🔧 5-1: 기반 설정
```
1. config/config.php 생성
2. lib/db.php, lib/session.php 생성
3. includes/header.php, footer.php, nav.php 생성
```

### 🔄 5-2: HTML → PHP 변환
```
1. templates/home.html → home.php
2. templates/list.html → list.php
3. templates/article.html → article.php
… 기타 시안도 동일 방식 변환
```

### ⚙️ 5-3: 핵심 기능 구현
```
1. lib/user.php 생성
2. lib/content.php 생성
3. lib/comment.php 생성
4. lib/admin.php 생성
```

### 🚀 5-4: 확장 기능 구현
```
1. lib/upload.php, lib/notify.php, lib/common.php 생성
2. admin/ 디렉토리 내 관리자 전용 페이지 구성
```

---

## ✅ 최종 단계 체크포인트

### 📌 전제 조건
- [ ] database_schema.sql 완전 숙지
- [ ] controller_guide.md 완전 숙지
- [ ] core_functions_guide.md 완전 숙지
- [ ] html_mapping_rules.md 완전 숙지

### 📌 구현 중 점검
- [ ] HTML 시안 100% 반영 여부
- [ ] 함수 구조 명세 100% 준수 여부
- [ ] 테이블 및 제약조건 위반 없음
- [ ] 권한 흐름 및 구조 위배 없음

---

## ⚠️ 최종 경고

1. **단계 건너뛰기 또는 병렬 작업 금지**
2. **비지정 문서 참조 및 추측 로직 금지**
3. **클래스 구조 또는 프레임워크 코드 절대 금지**
4. **오직 이 문서 기준으로만 작업 진행**

```

---------------------------------------

이 양식을 활용하기 위해선 AI모델이 마구잡이로 함수를 만들지 않고, 스키마를 생성하지 않도록 

사전 정의된 스키마 slq과 스키마만 사용할 함수목록표, html템플릿 시안이 있는경우 100% 매핑되도록,

css 클래스명, 등 주석활용여부

를 적당한 위치에 두고, 커서라면 rule에 프로젝트 룰로 직접 always로 명시해서 mdc로 생성하셔도 되고.

md로 만드셔도될거같습니다. 

이렇게 하면 5~6번 수정할 페이지도 최소화할거같고..응답소비도 줄일 수 있을 거 같습니다.

확실하고 명확한 예시가 많을수록 정말 모델은 그 형태로 작업을 합니다.

너무 형상적이라면 당연하게 가정을 합니다. 자기 딴에 추론이라고 의도를 다르게 해석하곤합니다.