sam-kd/docs/MODULES.md

# 5130 모듈 상세 문서

## 모듈 분류

### 핵심 업무 모듈

| 모듈 | 폴더 | 파일 수 | 설명 |
|------|------|---------|------|
| 견적 | `estimate/` | 67 | 스크린/스라트 견적 |
| 출고 | `output/` | 136 | 주문/출고 관리 |
| 작업 | `work/` | 33 | 생산/작업 관리 |
| 수입검사 | `instock/` | 50 | 자재 입고/검사 |
| LOT | `lot/` | - | LOT 관리 |

### 전자결재 모듈

| 모듈 | 폴더 | 설명 |
|------|------|------|
| 연차 | `annualleave/` | 연차/반차/조퇴 신청 |
| 품의서 | `askitem/` | 품의 신청 (경동) |
| 품의서 | `askitem_juil/` | 품의 신청 (주일) |
| 지출결의 | `askitem_ER/` | 지출결의서 (경동) |
| 지출결의 | `askitem_ER_juil/` | 지출결의서 (주일) |

### 회계 모듈

| 모듈 | 폴더 | 설명 |
|------|------|------|
| 회계 | `account/` | 회계 관리 (경동) |
| 회계 | `account_juil/` | 회계 관리 (주일) |
| 회계계획 | `account_plan/` | 회계 계획 (경동) |
| 회계계획 | `account_plan_juil/` | 회계 계획 (주일) |

### 자산 관리 모듈

| 모듈 | 폴더 | 설명 |
|------|------|------|
| 차량 | `car/` | 차량 관리 (정비, 오일교환) |
| 지게차 | `lift/` | 지게차 관리 |

### 게시판 모듈

| 모듈 | 폴더 | 설명 |
|------|------|------|
| 공지 | `notice/` | 공지사항 |
| 자료실 | `qna/` | 자료실/Q&A |
| 개발일지 | `rnd/` | R&D 개발일지 |

### 기타 모듈

| 모듈 | 폴더 | 설명 |
|------|------|------|
| 회원 | `member/` | 회원 관리 |
| 로그인 | `login/` | 인증 |
| 벤딩 | `bending/` | 벤딩 작업 |
| 벤딩비 | `bendingfee/` | 벤딩 비용 |
| 입찰 | `bid/` | 입찰 관리 |
| A/S | `as/` | A/S 관리 |
| 분석 | `analysis/` | 데이터 분석 |
| 단가 | `KDunitprice/` | 단가 관리 |

---

## 견적 모듈 (`estimate/`)

### 파일 구조

```
estimate/
├── list.php                # 견적 목록
├── write_form.php          # 견적 작성/수정
├── update.php              # 견적 저장
├── delete.php              # 견적 삭제
├── view.php                # 견적 상세
│
├── estimate.php            # 스크린 견적서 출력
├── estimateSlat.php        # 스라트 견적서 출력
│
├── get_screen_amount.php   # 스크린 금액 계산 엔진
├── get_slat_amount.php     # 스라트 금액 계산 엔진
│
├── EsDetail_screen.php     # 스크린 상세 정보
├── EsDetail_slat.php       # 스라트 상세 정보
│
├── common/                 # 공통 컴포넌트
├── css/                    # 스타일
│
├── _request.php            # 요청 처리
├── _row.php                # 행 템플릿
│
└── README.md               # 모듈 문서
```

### 주요 기능

1. **견적 작성**: 스크린/스라트 제품 견적
2. **금액 계산**: 자동 견적 금액 산출
3. **견적서 출력**: PDF/인쇄 형태 견적서
4. **이력 관리**: 견적 수정 이력

---

## 출고 모듈 (`output/`)

### 파일 구조

```
output/
├── list.php                # 출고 목록
├── write_form.php          # 출고 작성/수정
├── update.php              # 출고 저장
├── delete.php              # 출고 삭제
│
├── delivery.php            # 배송 관리
├── bendingview.php         # 벤딩 뷰
│
├── statistics.php          # 출고 통계
├── list_deliveryfee.php    # 배차/운송비 목록
│
├── list_ACI.php            # 인정검사 목록
├── write_ACI.php           # 인정검사 (스크린)
├── write_ACI_slat.php      # 인정검사 (스라트)
│
├── common/                 # 공통 컴포넌트 (29개)
├── css/                    # 스타일
│
├── _request.php            # 요청 처리
├── _row.php                # 행 템플릿
└── _row_extra.php          # 추가 행 템플릿
```

### 주요 기능

1. **주문 접수**: 고객 주문 등록
2. **출고 관리**: 출고 예정일, 출고 완료 관리
3. **배차**: 배송 차량 및 운송비 관리
4. **인정검사**: KS/KW 인증 검사 기록
5. **통계**: 일/월/년 출고 통계

### 상태 플로우

```
접수 → 생산예정 → 생산완료 → 출고예정 → 출고완료
         ↓
     인정검사 요청 → 인정검사 완료
```

---

## 수입검사 모듈 (`instock/`)

### 파일 구조

```
instock/
├── list.php                # 검사 목록
├── write_form.php          # 검사 등록
├── update.php              # 검사 저장
│
├── i_EGI155.php           # EGI155 검사 양식
├── i_Fireproof_sealings.php  # 방화 실링 검사
├── i_GIplate.php          # GI 판재 검사
├── i_SUScoil.php          # SUS 코일 검사
│
├── statistics.php          # 구매 통계
├── func_statistics.php     # 통계 함수
│
├── fetch_*.php            # AJAX 데이터 조회
├── common/                 # 공통 컴포넌트
└── css/                    # 스타일
```

### 주요 기능

1. **검사 등록**: 자재별 수입검사 기록
2. **품목별 양식**: 자재 유형별 검사 양식
3. **합격/불합격**: 검사 판정
4. **구매 통계**: 월별 구매 현황

### 품목별 검사 양식

- `i_EGI155.php`: EGI155 강판
- `i_GIplate.php`: GI 판재
- `i_SUScoil.php`: SUS 코일
- `i_Fireproof_sealings.php`: 방화 실링재

---

## 작업 관리 모듈 (`work/`)

### 파일 구조

```
work/
├── list.php                # 작업 목록
├── write_form.php          # 작업 등록
├── update.php              # 작업 저장
├── delete.php              # 작업 삭제
│
├── handover_list.php       # 인계서 목록
├── handover_doc.php        # 인계서 문서
├── delete_handover.php     # 인계서 삭제
│
├── accountlist.php         # 정산 목록
├── accountlist_good.php    # 양품 정산
├── accountlist_bad.php     # 불량 정산
├── accountlist_request.php # 요청 정산
│
├── _request.php            # 요청 처리
└── _row.php                # 행 템플릿
```

### 주요 기능

1. **작업 등록**: 생산 작업 기록
2. **인계서**: 작업 인계 문서 관리
3. **정산**: 양품/불량 정산 처리

---

## 전자결재 시스템

### 공통 테이블: `eworks`

모든 전자결재 문서가 `eworks` 테이블에 저장됩니다.

```sql
eworks 테이블 주요 컬럼:
- num: PK
- eworks_item: 문서 유형 (품의서, 지출결의서, 연차 등)
- al_company: 회사 (경동, 주일)
- indate: 작성일
- status: 결재 상태
- e_line_id: 결재라인
- e_confirm: 결재 완료 정보
```

### 결재 상태

```
draft → pending → approved / rejected
         ↓
       end (결재 완료)
```

### 연차 신청 (`annualleave/`)

```
annualleave/
├── index.php              # 연차 현황
├── write_form.php         # 신청 작성
├── list.php               # 신청 목록
└── ...
```

### 품의서 (`askitem/`)

```
askitem/
├── list.php               # 품의 목록
├── write_form.php         # 품의 작성
└── ...
```

### 지출결의서 (`askitem_ER/`)

```
askitem_ER/
├── list.php               # 지출결의 목록
├── write_form.php         # 지출결의 작성
└── ...
```

---

## 게시판 모듈 공통 구조

모든 게시판은 유사한 파일 구조를 가집니다:

```
{board}/
├── list.php               # 목록
├── view.php               # 상세 보기
├── write_form.php         # 작성/수정
├── update.php             # 저장
├── delete.php             # 삭제
├── delete_ripple.php      # 댓글 삭제
└── common/                # 공통 컴포넌트
```

### 공지사항 (`notice/`)

- 전체 공지 기능 (`noticecheck='y'`)
- 댓글 기능 (`notice_ripple` 테이블)

### 자료실 (`qna/`)

- 파일 첨부 기능
- 카테고리 분류

### 개발일지 (`rnd/`)

- R&D 활동 기록
- 프로젝트별 분류

---

## 모듈 개발 가이드

### 새 모듈 생성 시 필수 파일

1. `list.php` - 목록 페이지
2. `write_form.php` - 등록/수정 폼
3. `update.php` - 데이터 저장
4. `delete.php` - 데이터 삭제
5. `_request.php` - 요청 파라미터 처리
6. `_row.php` - 행 템플릿

### 공통 include 순서

```php
<?php
require_once($_SERVER['DOCUMENT_ROOT'] . "/session.php");
require_once($_SERVER['DOCUMENT_ROOT'] . "/load_header.php");
require_once($_SERVER['DOCUMENT_ROOT'] . "/common.php");
require_once($_SERVER['DOCUMENT_ROOT'] . "/lib/mydb.php");

$pdo = db_connect();
// ... 로직
?>
```

---

*문서 작성일: 2025-12-13*