# Infoway 멀티테넌트 SaaS 플랫폼 개발 규칙

## 프로젝트 개요
- **이름**: DLIVE-Zinpack-AI (Infoway)
- **타입**: 멀티테넌트 콘텐츠 관리 시스템
- **구조**: _infoway(비즈니스 로직) + _zinpack(ProcessWire CMS)
- **도메인**: {tenant}.dliveletter.kr

## 기술 스택 제약사항 ⚠️
- **PHP**: 5.3.29 (2014년) - namespace, [], ::class, trait 사용 불가
- **Database**: MariaDB 5.0.96 (2010년)
- **웹서버**: Apache + mod_rewrite
- **CMS**: ProcessWire 2.5
- **필수 보안**: magic_quotes_gpc, addslashes() 사용

## 멀티테넌트 아키텍처 핵심
- **ep_code**: 기업(Enterprise) 고유 코드 (예: ep87579064668809f3d632cc)
- **gp_code**: 그룹 코드 (기본값: "all")
- **서브도메인**: wizwin.dliveletter.kr → ep_code 자동 조회
- **세션 캐싱**: 5분 TTL (subdomain_init.php)
- **완전 격리**: 모든 쿼리에 WHERE ep_code = '$iw[store]' 필수

## 디렉토리 구조
```
infoway/
├── _infoway/              # 비즈니스 로직 시스템
│   ├── bbs/
│   │   ├── admin/        # 관리자 페이지 (304개 파일)
│   │   ├── m/            # 모바일/사용자 페이지 (127개 파일)
│   │   └── super/        # 슈퍼관리자 (71개 파일)
│   ├── include/
│   │   ├── common.php           # 전역 초기화
│   │   ├── config.php           # 설정 및 테이블 정의
│   │   ├── subdomain_init.php   # 서브도메인 자동 초기화
│   │   ├── subdomain_handler.php # 서브도메인 검증 함수
│   │   ├── member_check.php     # 권한 체크
│   │   └── member_super.php     # 슈퍼관리자 권한
│   ├── design/           # CSS/JS/이미지
│   ├── main/             # 테넌트별 콘텐츠
│   ├── scripts/          # 서브도메인 관리 스크립트
│   └── sql/              # SQL 스크립트
└── _zinpack/             # ProcessWire CMS (콘텐츠 표시)
    ├── site/
    └── wire/
```

## 코딩 규칙

### 1. PHP 5.3 호환성 (필수)
```php
// ✅ 올바른 코드
array('key' => 'value');              // 배열 선언
$className = 'MyClass';               // 클래스명 문자열
function() use ($var) { }             // 클로저 (제한적)
mysql_connect();                      // MySQL 연결 (deprecated but required)

// ❌ 사용 금지 (PHP 5.4+)
['key' => 'value'];                   // 짧은 배열 문법
namespace App\Controllers;            // 네임스페이스
ClassName::class;                     // ::class 상수
trait MyTrait { }                     // Trait
```

### 2. 테넌트 격리 (절대 필수) 🚨
```php
// ✅ 올바른 쿼리 (ep_code 필터 포함)
$sql = "SELECT * FROM {$iw['member_table']} 
        WHERE ep_code = '{$iw['store']}'
        AND mb_code = '{$iw['member']}'";

// 그룹 사용 시 gp_code도 추가
if ($iw['group'] != 'all') {
    $sql .= " AND gp_code = '{$iw['group']}'";
}

// ❌ 잘못된 쿼리 (ep_code 누락 - 치명적 오류!)
$sql = "SELECT * FROM {$iw['member_table']} 
        WHERE mb_code = '{$iw['member']}'";  // 다른 테넌트 데이터 노출!
```

### 3. BBS 표준 패턴
```
모듈명_기능_동작.php

파일 구조:
├── {module}_list.php         # 목록 조회
├── {module}_view.php         # 상세 보기
├── {module}_write.php        # 작성 폼
├── {module}_write_ok.php     # 작성 처리
├── {module}_edit.php         # 수정 폼
├── {module}_edit_ok.php      # 수정 처리
└── {module}_delete.php       # 삭제 처리

예시:
- member_data_list.php        # 회원 목록
- shop_order_write_ok.php     # 주문 처리
- book_support_edit.php       # 전자책 후원 수정
```

### 4. 파일 헤더 템플릿
```php
<?php
/**
 * [모듈명] - [기능 설명]
 * 
 * Infoway 멀티테넌트 시스템
 * PHP 5.3.29 환경 - namespace, [], ::class 사용 불가
 * 
 * 필수 변수:
 * @global array $iw['store']  현재 테넌트 ep_code
 * @global array $iw['group']  현재 그룹 gp_code
 * @global array $iw['level']  사용자 권한 (guest/member/admin/super)
 * @global array $iw['member'] 로그인 회원 mb_code
 */

if (!defined("_INFOWAY_")) exit; // 직접 접근 방지

// 관리자 페이지인 경우
include_once("_common.php");
if ($iw['level'] != "admin") alert("잘못된 접근입니다!","");
```

## 데이터베이스 테이블 (60+ 개)

### 코어 시스템
- `iw_setting`: 테넌트별 설정
- `iw_seo`: SEO 메타 정보 (최근 추가)
- `iw_enterprise`: 테넌트 정보 ★핵심★
- `iw_member`: 회원 정보
- `iw_group`: 그룹 정보

### 주요 모듈
- **명함(MCB)**: iw_mcb_data, iw_mcb_support
- **출판**: iw_publishing_* (7개 테이블)
- **쇼핑**: iw_shop_* (9개 테이블)
- **전자책**: iw_book_* (8개 테이블)
- **문서**: iw_doc_* (3개 테이블)

## 권한 레벨 시스템

### 사용자 권한 (mb_display)
```php
$iw['level'] = 
    "guest"    // 비로그인 (mb_display = 0)
    "member"   // 일반 회원 (mb_display = 1)
    "seller"   // 판매자 (mb_display = 4)
    "admin"    // 관리자 (mb_display = 7)
    "super"    // 슈퍼관리자 (mb_display = 9)
```

### 그룹 권한 (그룹 활성화 시)
```php
$iw['gp_level'] = 
    "gp_guest"   // 그룹 비회원
    "gp_member"  // 그룹 회원
    "gp_admin"   // 그룹 관리자
```

## 보안 체크리스트

### 1. SQL Injection 방지 (필수)
```php
// common.php에서 자동 처리 (magic_quotes_gpc)
// 추가 변수는 수동 처리
$safe_input = addslashes($_POST['user_input']);
$sql = "INSERT INTO table (field) VALUES ('$safe_input')";
```

### 2. XSS 방지
```php
// 출력 시 필수
echo htmlspecialchars($user_input);
echo stripslashes(htmlspecialchars($data));
```

### 3. 직접 접근 방지
```php
// 모든 PHP 파일 상단에 필수
if (!defined("_INFOWAY_")) exit;
```

### 4. 권한 체크
```php
// 관리자 페이지
if ($iw['level'] != "admin") alert("잘못된 접근입니다!","");

// 슈퍼관리자 페이지
if ($iw['level'] != "super") alert("잘못된 접근입니다!","");
```

### 5. 파일 업로드 검증
```php
$allowed_ext = array('jpg', 'jpeg', 'png', 'gif');
$file_ext = strtolower(pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION));
if (!in_array($file_ext, $allowed_ext)) {
    alert("허용되지 않은 파일 형식입니다.");
}
```

## 현재 작업 현황

### ✅ 완료
- SEO 시스템 구축 (iw_seo 테이블)
- Modern Card UI 적용 (design/css/modern-card.css)
- 서브도메인 자동 초기화 (세션 캐싱)
- 서브도메인 관리 스크립트 (scripts/)

### 🔄 진행 중
- UI 현대화 (Bootstrap 3 → 5 마이그레이션)
- AI 명함 시스템 개선
- 모바일 반응형 개선

### ⚠️ 알려진 이슈
- 모바일 백키 에러 (일부 페이지)
- Bootstrap 3.0 구버전 사용
- jQuery 의존도 높음

## 개발 워크플로우

### 1. 새 관리자 페이지 생성
```bash
# 1. 파일 생성
touch bbs/admin/module_name_list.php
touch bbs/admin/module_name_write.php
touch bbs/admin/module_name_write_ok.php

# 2. 템플릿 사용 (기존 파일 참고)
# 3. ep_code 격리 확인
# 4. 권한 레벨 체크
# 5. PHP 5.3 호환성 테스트
```

### 2. 서브도메인 추가
```bash
cd scripts
./manage_subdomain.sh add {subdomain} {ep_code}
./subdomain_db_sync.sh  # 동기화 확인
systemctl restart httpd
```

### 3. 테스트 체크리스트
- [ ] PHP 5.3 호환성 ([], namespace 등 미사용)
- [ ] ep_code 필터 적용 (모든 쿼리)
- [ ] SQL Injection 방지 (addslashes)
- [ ] XSS 방지 (htmlspecialchars)
- [ ] 권한 체크 (level, gp_level)
- [ ] 모바일 반응형 테스트

## 주의사항 🚨

### 1. 절대 하지 말 것
- ❌ PHP 7+ 문법 사용 (namespace, [], ::class 등)
- ❌ ep_code 없는 쿼리 작성
- ❌ Prepared Statements (PHP 5.3에서 제한적)
- ❌ Composer 최신 패키지 (대부분 PHP 7+ 요구)

### 2. 항상 해야 할 것
- ✅ 모든 쿼리에 ep_code 필터
- ✅ addslashes() 또는 자동 이스케이프 확인
- ✅ _INFOWAY_ 상수 체크
- ✅ 권한 레벨 검증
- ✅ 테넌트 간 데이터 격리 테스트

### 3. 성능 고려사항
- 세션 캐싱 5분 TTL (subdomain_init.php)
- 서브도메인 변경 시 캐시 클리어 필요
- 대량 데이터 조회 시 ep_code 인덱스 활용

## 참고 문서
- `docs/analysis/README.md`: 프로젝트 전체 분석
- `docs/analysis/architecture.md`: 시스템 아키텍처
- `docs/analysis/multitenant.md`: 멀티테넌트 상세 설명
- `docs/guides/development.md`: 개발 가이드
- `include/config.php`: 테이블 정의
- `include/common.php`: 전역 초기화 로직

## Cursor AI 사용 팁

### 새 기능 개발 시
```
"@.cursorrules 참고하여 {모듈명} 관리자 페이지를 만들어줘.
BBS 패턴을 따르고, PHP 5.3 호환성과 ep_code 격리를 적용해줘."
```

### 버그 수정 시
```
"@docs/analysis/multitenant.md 참고하여 {이슈}를 수정해줘.
세션 캐싱과 서브도메인 초기화를 고려해야 해."
```

### 코드 리뷰 시
```
"이 코드가 .cursorrules 규칙을 따르는지 검토해줘.
특히 ep_code 격리와 PHP 5.3 호환성을 확인해줘."
```

---

**⚠️ 이 파일은 Cursor AI가 자동으로 읽어 모든 대화에 적용됩니다.**
**프로젝트 규칙이 변경되면 이 파일을 업데이트하세요.**