# 종량제 — 쓰레기봉투 물류시스템 (jongryangje)

**[종량제 개발목록 (엑셀 다운로드)](https://github.com/wixon-associates/jongryangje/raw/main/assets/종량제_개발목록_20260127.xlsx)** — 로컬 복제 후에는 [`assets/종량제_개발목록_20260127.xlsx`](./assets/종량제_개발목록_20260127.xlsx)

지자체·지정판매소 등을 대상으로 하는 **종량제 쓰레기봉투 물류·업무 웹 애플리케이션**입니다.  
백엔드는 **[CodeIgniter 4](https://codeigniter.com/)** 기반입니다.

**저장소:** [wixon-associates/jongryangje](https://github.com/wixon-associates/jongryangje)

---

## 요구 사항

- **PHP** 8.2 이상 (`composer.json` 기준)
- **Composer** 2.x
- **MySQL / MariaDB** (프로젝트는 `MySQLi` 드라이버 사용)
- 권장 PHP 확장: `intl`, `mbstring`, MySQL 사용 시 `mysqlnd`

---

## 빠른 시작 (로컬)

### 1) 저장소 복제

```bash
git clone https://github.com/wixon-associates/jongryangje.git
cd jongryangje
```

### 2) 의존성 설치

```bash
composer install
```

### 3) 환경 설정

루트에 있는 샘플 파일을 복사해 `.env`를 만듭니다.

```bash
cp env .env
```

`.env`에서 최소한 다음을 설정합니다.

| 항목 | 설명 |
|------|------|
| `app.baseURL` | 예: `http://localhost:8080/` (끝에 `/`) |
| `database.default.*` | DB 호스트·DB명·사용자·비밀번호 |
| `encryption.key` | 개인정보(이메일·연락처) 암호화용. **64자리 hex** (예: `php -r "echo bin2hex(random_bytes(32));"`) |

> `.env`는 **Git에 올리지 마세요.** 비밀번호·키가 들어갑니다.

### 4) 데이터베이스 준비

팀에서 공유한 순서에 맞추거나, 예시로는 아래 스크립트를 참고합니다.

| 파일 | 용도 |
|------|------|
| `writable/database/init_jongryangje_dev.sql` | DB·DB 사용자 생성 예시 |
| `writable/database/login_tables.sql` | 회원·로그인·지자체 등 기본 테이블 |
| `writable/database/member_approval_request_add.sql` | 회원가입 역할 승인 요청 테이블 (별도 추가) |
| `writable/database/menu_tables.sql` 등 | 메뉴·시드 관련 SQL |

실제 적용 순서와 계정 정보는 **팀 내부 문서**를 따르세요.

---

## 주요 URL (참고)

| 경로 | 설명 |
|------|------|
| `/` | 홈 (비로그인 시 환영 화면 등) |
| `/login`, `/logout` | 로그인·로그아웃 |
| `/register` | 회원가입 (역할 승인 플로우 연동) |
| `/dashboard` | 로그인 후 사이트형 메인 흐름 |
| `/dashboard/classic-mock` 등 | UI 시안용 라우트 |
| `/admin` | 관리자 (권한·필터 적용) |
| `/admin/access/approvals` | 회원가입 역할 **승인 대기** 처리 |

정확한 라우트는 `app/Config/Routes.php`를 확인하세요.