docs: add project docs and test updates

docs/종량제 관련 자료/대화_요약_20260305.md

@@ -0,0 +1,40 @@
+# 대화 요약 (2026-03-05)
+
+## 진행한 작업
+
+### 1. member 테이블 mb_level COMMENT 수정
+- `login_tables.sql`에서 mb_level COMMENT 수정
+- 실제 DB에 `ALTER TABLE member MODIFY mb_level ...` 실행 반영
+- Comment: `1=일반, 2=지정판매소, 3=지자체관리자, 4=super admin (Roles.php)`
+
+### 2. 회원가입 시 사용자 역할 선택 (임시)
+- `app/Views/auth/register.php`: 역할(mb_level) 선택 드롭다운 추가
+- `app/Controllers/Auth.php`: mb_level 검증 및 저장 처리
+- Roles config의 levelNames 활용
+
+### 3. 로그인 기능 구현
+- `MemberLogModel` 생성 (member_log 테이블)
+- `Auth::login()`: password_verify, 세션, mb_latestdate 갱신, member_log 기록
+- mb_state 검사 (1=정상, 2=정지, 0=탈퇴)
+- `Auth::logout()`: 세션 삭제, member_log mll_logout_date 갱신
+
+### 4. 로그인 후 대시보드 및 로그아웃
+- `app/Views/home/dashboard.php`: 로그인 후 전용 화면 (사용자 정보 + 로그아웃 버튼)
+- `Home::index()`: 로그인 시 dashboard, 비로그인 시 welcome_message
+
+### 5. 로그인 후 화면 - 스크린샷 참조
+- 프로젝트 내 스크린샷 없음 확인
+- 문서 기준: 대시보드 최소 구성(사용자 표시 + 로그아웃)
+
+### 6. 종량제 관련 자료 정리
+- `docs/종량제 관련 자료/` 폴더 생성
+- `202511_지자체쓰레기봉투_스크린샷` → 쓰레기봉투 물류시스템_스크린샷, ss_gbms 복사
+- `종량제csv` → 종량제 개발목록 폴더로 이동
+- 최종 구조:
+  - `docs/종량제 관련 자료/종량제 개발목록/` (CSV 8개)
+  - `docs/종량제 관련 자료/쓰레기봉투 물류시스템_스크린샷/`
+  - `docs/종량제 관련 자료/ss_gbms/`
+
+---
+
+*이 파일은 Cursor AI와의 대화 내용을 요약한 것입니다.*

docs/종량제 관련 자료/로그인후_화면_분석.md

@@ -0,0 +1,144 @@
+# 로그인 후 화면 분석 (종량제 관련 자료 기반)
+
+종량제 관련 자료(스크린샷, CSV, 메뉴 구조)를 분석해 **로그인 후 어떤 페이지가 나오는 것이 좋은지** 정리했습니다.
+
+---
+
+## 1. 기존 앱(스크린샷) 구조
+
+### 1.1 공통 레이아웃
+모든 화면에 동일한 구조가 적용됨:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 쓰레기봉투 물류시스템                                         │
+├─────────────────────────────────────────────────────────────┤
+│ 기본정보관리 | 발주입고관리 | 불출관리 | 재고관리 | 판매관리  │
+│ 판매현황 | 봉투수불관리 | 통계분석관리 | 창 | 도움말          │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  [현재 선택된 모듈 화면 - 예: 기본 코드 관리, 단가 관리 등]   │
+│                                                             │
+├─────────────────────────────────────────────────────────────┤
+│ Ready...                                    Ver 2025.12.26   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 1.2 스크린샷에서 확인된 첫 화면
+- **1-1.png, 기본 코드 관리.png**: `[w_gm010e] 기본 코드 관리` — **기본정보관리**의 첫 메뉴
+- 기존 앱은 로그인 후 **기본정보관리 > 기본 코드 관리**가 기본(첫) 화면으로 보임
+
+### 1.3 주요 화면 유형
+| 구분 | 화면 예시 | 용도 |
+|------|----------|------|
+| 기본정보 | 기본 코드 관리, 단가 관리 | 마스터 데이터 설정 |
+| 판매 | 전화 접수, 지정판매소 판매 | 주문·판매 처리 |
+| 현황 | 일계표, 기간별 판매현황 | 조회·리포트 |
+
+---
+
+## 2. 권한별 로그인 후 첫 화면 제안
+
+### 2.1 역할(mb_level)별 차이
+| 역할 | 주 업무 | 적합한 첫 화면 |
+|------|---------|----------------|
+| **super admin (4)** | 전체 시스템 관리 | 기본 코드 관리 또는 대시보드 |
+| **지자체관리자 (3)** | 지자체 단위 관리·조회 | 대시보드 또는 주문 접수 관리 메인 |
+| **지정판매소 (2)** | 판매·접수·반품 | 주문 접수 관리 메인 또는 지정판매소 판매 |
+| **일반 (1)** | 제한적(정품 확인 등) | 대시보드(빠른 링크) |
+
+### 2.2 권장: **대시보드(홈) + 메뉴**
+
+**로그인 후 첫 화면**으로 다음을 권장합니다.
+
+1. **Phase 1 (현재)**: 
+   - 사용자 정보 + 로그아웃 (현재 구현 유지)
+   - 본문에 "대시보드" 문구 + (선택) 빠른 메뉴 링크
+
+2. **Phase 2 (admin 레이아웃 적용 시)**:
+   - **레이아웃**: header(쓰레기봉투 물류시스템 + 사용자 + 로그아웃) + sidebar(권한별 메뉴)
+   - **본문 첫 화면**: **대시보드(홈)**
+     - 오늘 접수 건수, 재고 요약 등 요약 정보 (일계표 스타일)
+     - 자주 쓰는 메뉴 링크 (전화 접수, 지정판매소 판매, 재고 현황 등)
+     - 권한에 따라 노출 항목/링크 제어
+
+3. **대안**: 기본 코드 관리
+   - 기존 앱처럼 **기본정보관리 > 기본 코드 관리**를 첫 화면으로 두는 방식
+   - 관리자 전용에 적합
+
+---
+
+## 3. 메뉴 구조 (04-menu-structure, CSV 기준)
+
+로그인 후 보여줄 **메뉴바/사이드바** 구성:
+
+```
+기본정보관리
+  ├ 기본 코드 관리
+  ├ 단가 관리
+  ├ 포장 단위 관리
+  ├ 판매 대행소 관리
+  ├ 담당자 관리
+  ├ 업체 관리
+  ├ 무료용 대상자 관리
+  ├ 지정판매소 관리/조회/현황
+  └ PASSWORD 변경
+
+발주 입고 관리
+  ├ 발주 등록/변경/현황
+  ├ 발주 입고[스캐너]
+  ├ 일괄입고
+  └ 입고 현황
+
+불출 관리
+  ├ 무료 불출 현황
+  ├ 무료용 불출 처리
+  └ 무료용 불출 취소
+
+재고 관리
+  ├ 재고 현황
+  ├ 실사 관리
+  └ ...
+
+판매 관리
+  ├ 전화 접수
+  ├ 전화 접수 관리
+  ├ 지정 판매소 판매
+  ├ 지정 판매소 반품
+  └ ...
+
+판매 현황
+  ├ 지정 판매소 일/기간별 판매대장
+  ├ 일계표
+  ├ 기간별 판매현황
+  └ ...
+
+봉투 수불 관리
+통계 분석 관리
+```
+
+---
+
+## 4. 구현 순서 요약
+
+| Phase | 로그인 후 화면 |
+|-------|----------------|
+| **Phase 1** | 현재: 사용자 정보 + 로그아웃 (최소 대시보드) |
+| **Phase 2** | header + sidebar(권한별 메뉴) + **대시보드 본문** (요약/빠른 링크) |
+| **Phase 3 이후** | 대시보드에 실제 데이터(접수 건수, 재고 요약 등) 연동 |
+
+---
+
+## 5. 결론
+
+**로그인 후 첫 화면**으로는 다음을 권장합니다.
+
+1. **Phase 1**: 현재처럼 **최소 대시보드** (사용자 표시 + 로그아웃) 유지
+2. **Phase 2**: **header + sidebar + 대시보드** 구조
+   - **대시보드**에 요약 정보·빠른 링크 배치
+   - 기존 앱의 **일계표**처럼 요약 성격의 화면을 첫 화면으로 사용
+3. **권한별**: super admin/지자체 → 기본 코드 관리 또는 대시보드, 지정판매소 → 주문 접수/판매 관련 메뉴로 빠른 이동 가능하도록
+
+---
+
+*분석 기준: docs/종량제 관련 자료/쓰레기봉투 물류시스템_스크린샷, ss_gbms, 04-menu-structure.md, CSV 개발목록*