sam-kd/docs/DATABASE.md

5130 데이터베이스 구조

데이터베이스 정보

항목	값
DB명	chandj
엔진	MySQL 8.0
문자셋	utf8mb4

---

주요 테이블 목록

핵심 업무 테이블

테이블	설명	비고
output	출고/주문	메인 업무 테이블
estimate	견적	스크린/스라트 견적
instock	수입검사	자재 입고/검사
lot	LOT 관리	재고 LOT

전자결재 테이블

테이블	설명	비고
eworks	전자결재 통합	품의서, 지출결의서, 연차 등

게시판 테이블

테이블	설명	비고
notice	공지사항
notice_ripple	공지 댓글
qna	자료실
rnd	개발일지

회원/조직 테이블

테이블	설명	비고
member	회원 정보	로그인 계정

자산 관리 테이블

테이블	설명	비고
car	차량 정보	정비이력 JSON
lift	지게차 정보	정비이력 JSON

---

테이블 상세

output (출고/주문)

CREATE TABLE output (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 기본 정보
    indate DATE,                    -- 접수일
    outdate DATE,                   -- 출고예정일
    outdonedate DATE,               -- 출고완료일

    -- 현장 정보
    outworkplace VARCHAR(200),      -- 현장명
    outarea VARCHAR(100),           -- 지역

    -- 제품 정보
    prodCode VARCHAR(50),           -- 제품코드 (KS, KW 등)

    -- 인정검사
    ACIregDate DATE,                -- 인정검사 요청일
    ACIaskDate DATE,                -- 인정검사 신청일
    ACIdoneDate DATE,               -- 인정검사 완료일

    -- 배송
    deliveryfeeList JSON,           -- 배차/운송비 목록

    -- 상태
    is_deleted TINYINT DEFAULT 0,   -- 삭제 여부
    devMode TINYINT,                -- 개발모드

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

estimate (견적)

CREATE TABLE estimate (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 견적 정보
    estimate_date DATE,             -- 견적일
    customer VARCHAR(100),          -- 고객명
    project_name VARCHAR(200),      -- 프로젝트명

    -- 제품 정보
    product_type VARCHAR(50),       -- 제품유형 (screen, slat)
    specifications JSON,            -- 사양 정보

    -- 금액
    unit_price DECIMAL(15,2),       -- 단가
    total_amount DECIMAL(15,2),     -- 총금액

    -- 상태
    is_deleted TINYINT DEFAULT 0,

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

instock (수입검사)

CREATE TABLE instock (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 검사 정보
    inspection_date DATE,           -- 검사일
    item_name VARCHAR(200),         -- 품명
    supplier VARCHAR(100),          -- 공급사

    -- 검사 상세
    specification TEXT,             -- 규격
    iList JSON,                     -- 검사 상세 항목

    -- 판정
    resultJudgement VARCHAR(20),    -- 합격/불합격

    -- 비고
    remarks TEXT,
    weight_kg DECIMAL(10,2),        -- 중량

    -- 상태
    is_deleted TINYINT DEFAULT NULL,

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

eworks (전자결재)

CREATE TABLE eworks (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 문서 유형
    eworks_item VARCHAR(50),        -- 품의서, 지출결의서, 연차 등
    al_company VARCHAR(20),         -- 회사 (경동, 주일)

    -- 기본 정보
    indate DATE,                    -- 작성일
    outworkplace VARCHAR(200),      -- 제목/현장명

    -- 금액 (품의서/지출결의서)
    suppliercost VARCHAR(50),       -- 금액
    expense_data JSON,              -- 지출 상세 (지출결의서)

    -- 연차 정보
    al_askdatefrom DATE,            -- 연차 시작일
    al_askdateto DATE,              -- 연차 종료일

    -- 결재 정보
    status VARCHAR(20),             -- 상태 (draft, pending, end)
    e_line_id VARCHAR(200),         -- 결재라인 ID
    e_confirm TEXT,                 -- 결재 확인 정보

    -- 상태
    is_deleted TINYINT DEFAULT NULL,

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

member (회원)

CREATE TABLE member (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 계정 정보
    userid VARCHAR(50) UNIQUE,
    password VARCHAR(255),
    name VARCHAR(50),

    -- 조직 정보
    company VARCHAR(50),            -- 회사
    department VARCHAR(50),         -- 부서
    position VARCHAR(50),           -- 직급

    -- 권한
    level INT,                      -- 권한 레벨
    eworks_lv INT,                  -- 결재 레벨
    eworks_level INT,               -- 결재 단계
    authority VARCHAR(50),          -- 특수 권한

    -- 연락처
    email VARCHAR(100),
    phone VARCHAR(20),

    -- 결재 설정
    first_approval_id VARCHAR(50),
    first_approval_name VARCHAR(50),

    -- 상태
    is_active TINYINT DEFAULT 1,

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

notice (공지사항)

CREATE TABLE notice (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 게시글 정보
    subject VARCHAR(200),           -- 제목
    content TEXT,                   -- 내용

    -- 공지 설정
    noticecheck CHAR(1),            -- 전체공지 여부 (y/n)

    -- 작성자
    name VARCHAR(50),
    userid VARCHAR(50),

    -- 조회
    hit INT DEFAULT 0,

    -- 날짜
    regist_day DATETIME,

    -- 파일
    file_name VARCHAR(200),
    file_path VARCHAR(500),

    -- 상태
    is_deleted TINYINT DEFAULT 0
);

car (차량)

CREATE TABLE car (
    num INT AUTO_INCREMENT PRIMARY KEY,

    -- 차량 정보
    vehicle_type VARCHAR(100),      -- 차종
    license_plate VARCHAR(20),      -- 차량번호
    purchase_date DATE,             -- 구매일

    -- 정비 이력 (JSON)
    engine_oil_change_data JSON,    -- 엔진오일 교환 이력
    maintenance_data JSON,          -- 정비 이력

    -- 상태
    is_deleted TINYINT DEFAULT 0,

    -- 메타
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

-- JSON 구조 예시
-- engine_oil_change_data: [
--   {"engine_oil_change_date": "2024-01-15", "mileage": "50000"}
-- ]
-- maintenance_data: [
--   {"maintenance_date": "2024-02-20", "maintenance_record": "타이어 교체"}
-- ]

lift (지게차)

-- car 테이블과 동일한 구조
CREATE TABLE lift (
    num INT AUTO_INCREMENT PRIMARY KEY,
    vehicle_type VARCHAR(100),
    purchase_date DATE,
    engine_oil_change_data JSON,
    maintenance_data JSON,
    is_deleted TINYINT DEFAULT 0,
    created_at TIMESTAMP,
    updated_at TIMESTAMP
);

---

공통 컬럼 패턴

Soft Delete

대부분의 테이블에서 is_deleted 컬럼으로 소프트 삭제 구현:

-- 삭제되지 않은 레코드 조회
WHERE is_deleted IS NULL OR is_deleted = '0'

-- 삭제 처리
UPDATE table SET is_deleted = '1' WHERE num = ?

타임스탬프

created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP

JSON 컬럼

복잡한 데이터 구조는 JSON 컬럼으로 저장:

-- 예: 배차 정보
deliveryfeeList JSON
-- 값: [{"col1": "업체명", "col5": "100000"}, ...]

-- 예: 검사 항목
iList JSON
-- 값: [{"inputItems": {"resultJudgement": "합격"}}, ...]

---

인덱스 권장 사항

output 테이블

CREATE INDEX idx_output_indate ON output(indate);
CREATE INDEX idx_output_outdate ON output(outdate);
CREATE INDEX idx_output_is_deleted ON output(is_deleted);
CREATE INDEX idx_output_prodcode ON output(prodCode);

eworks 테이블

CREATE INDEX idx_eworks_company ON eworks(al_company);
CREATE INDEX idx_eworks_item ON eworks(eworks_item);
CREATE INDEX idx_eworks_status ON eworks(status);
CREATE INDEX idx_eworks_indate ON eworks(indate);
CREATE INDEX idx_eworks_leave_dates ON eworks(al_askdatefrom, al_askdateto);

instock 테이블

CREATE INDEX idx_instock_date ON instock(inspection_date);
CREATE INDEX idx_instock_deleted ON instock(is_deleted);

---

연결 설정

PDO 연결 (lib/mydb.php)

function db_connect(){
    loadEnv();

    $db_host = $_ENV['DB_HOST'] ?? 'localhost';
    $db_name = $_ENV['DB_NAME'] ?? 'chandj';
    $db_user = $_ENV['DB_USER'] ?? 'chandj';
    $db_pass = $_ENV['DB_PASS'] ?? '';

    $dsn = "mysql:host=".$db_host.";dbname=".$db_name.";charset=utf8mb4";

    $options = [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false
    ];

    $pdo = new PDO($dsn, $db_user, $db_pass, $options);
    return $pdo;
}

환경 변수 (.env)

DB_HOST=localhost
DB_NAME=chandj
DB_USER=chandj
DB_PASS=your_password

---

백업 권장

일일 백업

mysqldump -u chandj -p chandj > backup_$(date +%Y%m%d).sql

주요 테이블 우선 백업

mysqldump -u chandj -p chandj output estimate instock eworks member > critical_backup.sql

---

문서 작성일: 2025-12-13