83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
# 종량제 — 쓰레기봉투 물류시스템 (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`를 확인하세요.
|
|
|