feat(purchase): 생산소모품 구매 관리 시스템 구현

tkuser: 업체(공급업체) CRUD + 소모품 마스터 CRUD (사진 업로드 포함) tkfb: 구매신청 → 구매 처리 → 월간 분석/정산 전체 워크플로 설비(equipment) 분류 구매 시 자동 등록 + 실패 시 admin 알림 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 21:21:59 +09:00
parent 1abdb92a71
commit 3623551a6b
29 changed files with 2581 additions and 1 deletions
--- a/system1-factory/api/config/routes.js
+++ b/system1-factory/api/config/routes.js
@@ -52,6 +52,9 @@ function setupRoutes(app) {
  const patrolRoutes = require('../routes/patrolRoutes');
  const notificationRoutes = require('../routes/notificationRoutes');
  const pushSubscriptionRoutes = require('../routes/pushSubscriptionRoutes');
+  const purchaseRequestRoutes = require('../routes/purchaseRequestRoutes');
+  const purchaseRoutes = require('../routes/purchaseRoutes');
+  const settlementRoutes = require('../routes/settlementRoutes');

  // Rate Limiters 설정
  const rateLimit = require('express-rate-limit');
@@ -161,6 +164,9 @@ function setupRoutes(app) {
  app.use('/api/patrol', patrolRoutes); // 일일순회점검 시스템
  app.use('/api/notifications', notificationRoutes); // 알림 시스템
  app.use('/api/push', pushSubscriptionRoutes); // Push 구독
+  app.use('/api/purchase-requests', purchaseRequestRoutes); // 구매신청
+  app.use('/api/purchases', purchaseRoutes); // 구매 내역
+  app.use('/api/settlements', settlementRoutes); // 월간 정산
  app.use('/api', uploadBgRoutes);

  // Swagger API 문서
--- a/system1-factory/api/controllers/purchaseController.js
+++ b/system1-factory/api/controllers/purchaseController.js
@@ -0,0 +1,104 @@
+const PurchaseModel = require('../models/purchaseModel');
+const PurchaseRequestModel = require('../models/purchaseRequestModel');
+const logger = require('../utils/logger');
+
+const PurchaseController = {
+  // 구매 처리 (신청 → 구매)
+  create: async (req, res) => {
+    try {
+      const { request_id, item_id, vendor_id, quantity, unit_price, purchase_date, update_base_price, notes } = req.body;
+
+      if (!item_id) return res.status(400).json({ success: false, message: '소모품을 선택해주세요.' });
+      if (!unit_price) return res.status(400).json({ success: false, message: '구매 단가를 입력해주세요.' });
+      if (!purchase_date) return res.status(400).json({ success: false, message: '구매일을 입력해주세요.' });
+
+      // 구매 내역 생성
+      const purchaseId = await PurchaseModel.createFromRequest({
+        request_id: request_id || null,
+        item_id,
+        vendor_id: vendor_id || null,
+        quantity: quantity || 1,
+        unit_price,
+        purchase_date,
+        purchaser_id: req.user.id,
+        notes
+      });
+
+      // 기준가 업데이트 요청 시
+      if (update_base_price) {
+        const items = await PurchaseModel.getConsumableItems(false);
+        const item = items.find(i => i.item_id === parseInt(item_id));
+        if (item) {
+          await PurchaseModel.updateBasePrice(item_id, unit_price, item.base_price, req.user.id);
+        }
+      }
+
+      // 설비 자동 등록 (category='equipment')
+      let equipmentResult = null;
+      if (request_id) {
+        const requestData = await PurchaseRequestModel.getById(request_id);
+        if (requestData && requestData.category === 'equipment') {
+          equipmentResult = await PurchaseModel.tryAutoRegisterEquipment({
+            item_name: requestData.item_name,
+            maker: requestData.maker,
+            vendor_name: null,
+            unit_price,
+            purchase_date,
+            purchase_id: purchaseId,
+            purchaser_id: req.user.id
+          });
+        }
+      } else {
+        // 직접 구매 시에도 category 확인
+        const items = await PurchaseModel.getConsumableItems(false);
+        const item = items.find(i => i.item_id === parseInt(item_id));
+        if (item && item.category === 'equipment') {
+          const vendors = await PurchaseModel.getVendors();
+          const vendor = vendors.find(v => v.vendor_id === parseInt(vendor_id));
+          equipmentResult = await PurchaseModel.tryAutoRegisterEquipment({
+            item_name: item.item_name,
+            maker: item.maker,
+            vendor_name: vendor ? vendor.vendor_name : null,
+            unit_price,
+            purchase_date,
+            purchase_id: purchaseId,
+            purchaser_id: req.user.id
+          });
+        }
+      }
+
+      const result = { purchase_id: purchaseId };
+      if (equipmentResult) result.equipment = equipmentResult;
+
+      res.status(201).json({ success: true, data: result, message: '구매 처리가 완료되었습니다.' });
+    } catch (err) {
+      logger.error('Purchase create error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 구매 내역 목록
+  getAll: async (req, res) => {
+    try {
+      const { vendor_id, category, from_date, to_date, year_month } = req.query;
+      const rows = await PurchaseModel.getAll({ vendor_id, category, from_date, to_date, year_month });
+      res.json({ success: true, data: rows });
+    } catch (err) {
+      logger.error('Purchase getAll error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 가격 변동 이력
+  getPriceHistory: async (req, res) => {
+    try {
+      const rows = await PurchaseModel.getPriceHistory(req.params.itemId);
+      res.json({ success: true, data: rows });
+    } catch (err) {
+      logger.error('PriceHistory get error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  }
+};
+
+module.exports = PurchaseController;
--- a/system1-factory/api/controllers/purchaseRequestController.js
+++ b/system1-factory/api/controllers/purchaseRequestController.js
@@ -0,0 +1,120 @@
+const PurchaseRequestModel = require('../models/purchaseRequestModel');
+const PurchaseModel = require('../models/purchaseModel');
+const logger = require('../utils/logger');
+
+const PurchaseRequestController = {
+  // 구매신청 목록
+  getAll: async (req, res) => {
+    try {
+      const { status, category, from_date, to_date } = req.query;
+      const isAdmin = req.user && ['admin', 'system'].includes(req.user.access_level);
+      const filters = { status, category, from_date, to_date };
+      if (!isAdmin) filters.requester_id = req.user.id;
+      const rows = await PurchaseRequestModel.getAll(filters);
+      res.json({ success: true, data: rows });
+    } catch (err) {
+      logger.error('PurchaseRequest getAll error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 구매신청 상세
+  getById: async (req, res) => {
+    try {
+      const row = await PurchaseRequestModel.getById(req.params.id);
+      if (!row) return res.status(404).json({ success: false, message: '신청 건을 찾을 수 없습니다.' });
+      res.json({ success: true, data: row });
+    } catch (err) {
+      logger.error('PurchaseRequest getById error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 구매신청 생성
+  create: async (req, res) => {
+    try {
+      const { item_id, quantity, notes } = req.body;
+      if (!item_id) return res.status(400).json({ success: false, message: '소모품을 선택해주세요.' });
+      if (!quantity || quantity < 1) return res.status(400).json({ success: false, message: '수량은 1 이상이어야 합니다.' });
+
+      const request = await PurchaseRequestModel.create({
+        item_id,
+        quantity,
+        requester_id: req.user.id,
+        request_date: new Date().toISOString().substring(0, 10),
+        notes
+      });
+      res.status(201).json({ success: true, data: request, message: '구매신청이 등록되었습니다.' });
+    } catch (err) {
+      logger.error('PurchaseRequest create error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 보류 처리 (admin)
+  hold: async (req, res) => {
+    try {
+      const { hold_reason } = req.body;
+      const request = await PurchaseRequestModel.hold(req.params.id, hold_reason);
+      if (!request) return res.status(404).json({ success: false, message: '신청 건을 찾을 수 없습니다.' });
+      res.json({ success: true, data: request, message: '보류 처리되었습니다.' });
+    } catch (err) {
+      logger.error('PurchaseRequest hold error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // pending으로 되돌리기 (admin)
+  revert: async (req, res) => {
+    try {
+      const request = await PurchaseRequestModel.revertToPending(req.params.id);
+      if (!request) return res.status(404).json({ success: false, message: '신청 건을 찾을 수 없습니다.' });
+      res.json({ success: true, data: request, message: '대기 상태로 되돌렸습니다.' });
+    } catch (err) {
+      logger.error('PurchaseRequest revert error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 삭제 (본인 + pending만)
+  delete: async (req, res) => {
+    try {
+      const existing = await PurchaseRequestModel.getById(req.params.id);
+      if (!existing) return res.status(404).json({ success: false, message: '신청 건을 찾을 수 없습니다.' });
+      const isAdmin = req.user && ['admin', 'system'].includes(req.user.access_level);
+      if (!isAdmin && existing.requester_id !== req.user.id) {
+        return res.status(403).json({ success: false, message: '본인의 신청만 삭제할 수 있습니다.' });
+      }
+      const deleted = await PurchaseRequestModel.delete(req.params.id);
+      if (!deleted) return res.status(400).json({ success: false, message: '대기 상태의 신청만 삭제할 수 있습니다.' });
+      res.json({ success: true, message: '삭제되었습니다.' });
+    } catch (err) {
+      logger.error('PurchaseRequest delete error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 소모품 목록 (select용)
+  getConsumableItems: async (req, res) => {
+    try {
+      const items = await PurchaseModel.getConsumableItems();
+      res.json({ success: true, data: items });
+    } catch (err) {
+      logger.error('ConsumableItems get error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 업체 목록 (select용)
+  getVendors: async (req, res) => {
+    try {
+      const vendors = await PurchaseModel.getVendors();
+      res.json({ success: true, data: vendors });
+    } catch (err) {
+      logger.error('Vendors get error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  }
+};
+
+module.exports = PurchaseRequestController;
--- a/system1-factory/api/controllers/settlementController.js
+++ b/system1-factory/api/controllers/settlementController.js
@@ -0,0 +1,76 @@
+const SettlementModel = require('../models/settlementModel');
+const logger = require('../utils/logger');
+
+const SettlementController = {
+  // 월간 요약 (분류별 + 업체별)
+  getMonthlySummary: async (req, res) => {
+    try {
+      const { year_month } = req.query;
+      if (!year_month) return res.status(400).json({ success: false, message: '년월을 선택해주세요.' });
+
+      const [categorySummary, vendorSummary] = await Promise.all([
+        SettlementModel.getCategorySummary(year_month),
+        SettlementModel.getVendorSummary(year_month)
+      ]);
+
+      res.json({ success: true, data: { categorySummary, vendorSummary } });
+    } catch (err) {
+      logger.error('Settlement summary error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 월간 상세 구매 목록
+  getMonthlyPurchases: async (req, res) => {
+    try {
+      const { year_month } = req.query;
+      if (!year_month) return res.status(400).json({ success: false, message: '년월을 선택해주세요.' });
+      const rows = await SettlementModel.getMonthlyPurchases(year_month);
+      res.json({ success: true, data: rows });
+    } catch (err) {
+      logger.error('Settlement purchases error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 가격 변동 목록
+  getPriceChanges: async (req, res) => {
+    try {
+      const { year_month } = req.query;
+      if (!year_month) return res.status(400).json({ success: false, message: '년월을 선택해주세요.' });
+      const rows = await SettlementModel.getPriceChanges(year_month);
+      res.json({ success: true, data: rows });
+    } catch (err) {
+      logger.error('Settlement priceChanges error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 정산 완료
+  complete: async (req, res) => {
+    try {
+      const { year_month, vendor_id, notes } = req.body;
+      if (!year_month || !vendor_id) return res.status(400).json({ success: false, message: '년월과 업체를 선택해주세요.' });
+      const result = await SettlementModel.completeSettlement(year_month, vendor_id, req.user.id, notes);
+      res.json({ success: true, data: result, message: '정산 완료 처리되었습니다.' });
+    } catch (err) {
+      logger.error('Settlement complete error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  },
+
+  // 정산 취소
+  cancel: async (req, res) => {
+    try {
+      const { year_month, vendor_id } = req.body;
+      if (!year_month || !vendor_id) return res.status(400).json({ success: false, message: '년월과 업체를 선택해주세요.' });
+      const result = await SettlementModel.cancelSettlement(year_month, vendor_id);
+      res.json({ success: true, data: result, message: '정산이 취소되었습니다.' });
+    } catch (err) {
+      logger.error('Settlement cancel error:', err);
+      res.status(500).json({ success: false, message: '서버 오류가 발생했습니다.' });
+    }
+  }
+};
+
+module.exports = SettlementController;
--- a/system1-factory/api/db/migrations/20260313100000_create_purchase_system.sql
+++ b/system1-factory/api/db/migrations/20260313100000_create_purchase_system.sql
@@ -0,0 +1,102 @@
+-- 생산소모품 구매 관리 시스템 테이블
+
+-- 업체 (tkuser에서 CRUD)
+CREATE TABLE IF NOT EXISTS vendors (
+    vendor_id INT AUTO_INCREMENT PRIMARY KEY,
+    vendor_name VARCHAR(100) NOT NULL,
+    business_number VARCHAR(20),
+    representative VARCHAR(50),
+    contact_name VARCHAR(50),
+    contact_phone VARCHAR(20),
+    address VARCHAR(200),
+    bank_name VARCHAR(50),
+    bank_account VARCHAR(50),
+    notes TEXT,
+    is_active TINYINT(1) DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+);
+
+-- 소모품 마스터 (tkuser에서 CRUD)
+CREATE TABLE IF NOT EXISTS consumable_items (
+    item_id INT AUTO_INCREMENT PRIMARY KEY,
+    item_name VARCHAR(100) NOT NULL,
+    maker VARCHAR(100),
+    category ENUM('consumable','safety','repair','equipment') NOT NULL
+      COMMENT '소모품, 안전용품, 수선비, 설비',
+    base_price DECIMAL(12,0) DEFAULT 0,
+    unit VARCHAR(20) DEFAULT 'EA',
+    photo_path VARCHAR(255),
+    is_active TINYINT(1) DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uq_name_maker (item_name, maker)
+);
+
+-- 구매신청 (tkfb에서 CRUD)
+CREATE TABLE IF NOT EXISTS purchase_requests (
+    request_id INT AUTO_INCREMENT PRIMARY KEY,
+    item_id INT NOT NULL,
+    quantity INT NOT NULL DEFAULT 1,
+    requester_id INT NOT NULL COMMENT 'FK → sso_users.user_id',
+    request_date DATE NOT NULL,
+    status ENUM('pending','purchased','hold') DEFAULT 'pending'
+      COMMENT '대기, 구매완료, 보류',
+    hold_reason TEXT,
+    notes TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (item_id) REFERENCES consumable_items(item_id),
+    FOREIGN KEY (requester_id) REFERENCES sso_users(user_id)
+);
+
+-- 구매 내역 (tkfb에서 CRUD)
+CREATE TABLE IF NOT EXISTS purchases (
+    purchase_id INT AUTO_INCREMENT PRIMARY KEY,
+    request_id INT,
+    item_id INT NOT NULL,
+    vendor_id INT,
+    quantity INT NOT NULL DEFAULT 1,
+    unit_price DECIMAL(12,0) NOT NULL,
+    purchase_date DATE NOT NULL,
+    purchaser_id INT NOT NULL COMMENT 'FK → sso_users.user_id',
+    notes TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (item_id) REFERENCES consumable_items(item_id),
+    FOREIGN KEY (request_id) REFERENCES purchase_requests(request_id),
+    FOREIGN KEY (vendor_id) REFERENCES vendors(vendor_id),
+    FOREIGN KEY (purchaser_id) REFERENCES sso_users(user_id)
+);
+
+-- 가격 변동 이력
+CREATE TABLE IF NOT EXISTS consumable_price_history (
+    history_id INT AUTO_INCREMENT PRIMARY KEY,
+    item_id INT NOT NULL,
+    old_price DECIMAL(12,0),
+    new_price DECIMAL(12,0) NOT NULL,
+    changed_by INT COMMENT 'FK → sso_users.user_id',
+    changed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (item_id) REFERENCES consumable_items(item_id)
+);
+
+-- 월간 정산
+CREATE TABLE IF NOT EXISTS monthly_settlements (
+    settlement_id INT AUTO_INCREMENT PRIMARY KEY,
+    year_month VARCHAR(7) NOT NULL COMMENT 'YYYY-MM',
+    vendor_id INT NOT NULL,
+    total_amount DECIMAL(12,0) DEFAULT 0,
+    status ENUM('pending','completed') DEFAULT 'pending',
+    completed_at TIMESTAMP NULL,
+    completed_by INT COMMENT 'FK → sso_users.user_id',
+    notes TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    FOREIGN KEY (vendor_id) REFERENCES vendors(vendor_id),
+    UNIQUE KEY uq_ym_vendor (year_month, vendor_id)
+);
+
+-- 페이지 키 등록
+INSERT IGNORE INTO pages (page_key, page_name, page_path, category, is_admin_only, display_order) VALUES
+('purchase.request', '구매신청', '/pages/purchase/request.html', 'purchase', 0, 40),
+('purchase.analysis', '구매 분석', '/pages/admin/purchase-analysis.html', 'purchase', 1, 41);
--- a/system1-factory/api/models/purchaseModel.js
+++ b/system1-factory/api/models/purchaseModel.js
@@ -0,0 +1,147 @@
+// models/purchaseModel.js
+const { getDb } = require('../dbPool');
+
+const PurchaseModel = {
+  // 구매 내역 목록
+  async getAll(filters = {}) {
+    const db = await getDb();
+    let sql = `
+      SELECT p.*, ci.item_name, ci.maker, ci.category, ci.unit, ci.photo_path,
+             v.vendor_name, su.name AS purchaser_name
+      FROM purchases p
+      JOIN consumable_items ci ON p.item_id = ci.item_id
+      LEFT JOIN vendors v ON p.vendor_id = v.vendor_id
+      LEFT JOIN sso_users su ON p.purchaser_id = su.user_id
+      WHERE 1=1
+    `;
+    const params = [];
+
+    if (filters.vendor_id) { sql += ' AND p.vendor_id = ?'; params.push(filters.vendor_id); }
+    if (filters.category) { sql += ' AND ci.category = ?'; params.push(filters.category); }
+    if (filters.from_date) { sql += ' AND p.purchase_date >= ?'; params.push(filters.from_date); }
+    if (filters.to_date) { sql += ' AND p.purchase_date <= ?'; params.push(filters.to_date); }
+    if (filters.year_month) {
+      sql += ' AND DATE_FORMAT(p.purchase_date, "%Y-%m") = ?';
+      params.push(filters.year_month);
+    }
+
+    sql += ' ORDER BY p.purchase_date DESC, p.created_at DESC';
+    const [rows] = await db.query(sql, params);
+    return rows;
+  },
+
+  // 구매 처리 (구매신청 → 구매 내역 생성 + 상태 변경)
+  async createFromRequest(data) {
+    const db = await getDb();
+
+    // 구매 내역 INSERT
+    const [result] = await db.query(
+      `INSERT INTO purchases (request_id, item_id, vendor_id, quantity, unit_price, purchase_date, purchaser_id, notes)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      [data.request_id || null, data.item_id, data.vendor_id || null,
+       data.quantity, data.unit_price, data.purchase_date, data.purchaser_id, data.notes || null]
+    );
+
+    // 구매신청 상태 → purchased
+    if (data.request_id) {
+      await db.query(
+        `UPDATE purchase_requests SET status = 'purchased' WHERE request_id = ?`,
+        [data.request_id]
+      );
+    }
+
+    return result.insertId;
+  },
+
+  // 기준가 업데이트 + 이력 기록
+  async updateBasePrice(itemId, newPrice, oldPrice, changedBy) {
+    const db = await getDb();
+
+    // 이력 기록
+    await db.query(
+      `INSERT INTO consumable_price_history (item_id, old_price, new_price, changed_by)
+       VALUES (?, ?, ?, ?)`,
+      [itemId, oldPrice, newPrice, changedBy]
+    );
+
+    // base_price 갱신
+    await db.query(
+      `UPDATE consumable_items SET base_price = ? WHERE item_id = ?`,
+      [newPrice, itemId]
+    );
+  },
+
+  // 설비 자동 등록 시도 (category='equipment')
+  async tryAutoRegisterEquipment(purchaseData) {
+    try {
+      const EquipmentModel = require('./equipmentModel');
+      const equipmentCode = await EquipmentModel.getNextEquipmentCode('TKP');
+
+      await EquipmentModel.create({
+        equipment_code: equipmentCode,
+        equipment_name: purchaseData.item_name,
+        manufacturer: purchaseData.maker || null,
+        supplier: purchaseData.vendor_name || null,
+        purchase_price: purchaseData.unit_price,
+        installation_date: purchaseData.purchase_date,
+        status: 'active',
+        notes: `구매 자동 등록 (purchase_id: ${purchaseData.purchase_id})`
+      });
+
+      return { success: true, equipment_code: equipmentCode };
+    } catch (err) {
+      console.error('[purchase] 설비 자동 등록 실패:', err.message);
+
+      // admin 알림 전송
+      try {
+        const notificationModel = require('./notificationModel');
+        await notificationModel.createTypedNotification({
+          type: 'equipment',
+          title: `설비 자동 등록 실패: ${purchaseData.item_name}`,
+          message: `구매 완료 후 설비 자동 등록에 실패했습니다. 수동으로 등록해주세요. 오류: ${err.message}`,
+          link_url: '/pages/admin/equipments.html',
+          created_by: purchaseData.purchaser_id
+        });
+      } catch (notifErr) {
+        console.error('[purchase] 설비 등록 실패 알림 전송 오류:', notifErr.message);
+      }
+
+      return { success: false, error: err.message };
+    }
+  },
+
+  // 업체 목록 (vendors 테이블 직접 조회)
+  async getVendors() {
+    const db = await getDb();
+    const [rows] = await db.query(
+      'SELECT vendor_id, vendor_name FROM vendors WHERE is_active = 1 ORDER BY vendor_name'
+    );
+    return rows;
+  },
+
+  // 소모품 목록 (구매신청용)
+  async getConsumableItems(activeOnly = true) {
+    const db = await getDb();
+    let sql = 'SELECT item_id, item_name, maker, category, base_price, unit, photo_path FROM consumable_items';
+    if (activeOnly) sql += ' WHERE is_active = 1';
+    sql += ' ORDER BY category, item_name';
+    const [rows] = await db.query(sql);
+    return rows;
+  },
+
+  // 가격 변동 이력
+  async getPriceHistory(itemId) {
+    const db = await getDb();
+    const [rows] = await db.query(
+      `SELECT cph.*, su.name AS changed_by_name
+       FROM consumable_price_history cph
+       LEFT JOIN sso_users su ON cph.changed_by = su.user_id
+       WHERE cph.item_id = ?
+       ORDER BY cph.changed_at DESC`,
+      [itemId]
+    );
+    return rows;
+  }
+};
+
+module.exports = PurchaseModel;
--- a/system1-factory/api/models/purchaseRequestModel.js
+++ b/system1-factory/api/models/purchaseRequestModel.js
@@ -0,0 +1,94 @@
+// models/purchaseRequestModel.js
+const { getDb } = require('../dbPool');
+
+const PurchaseRequestModel = {
+  // 구매신청 목록 (소모품 정보 JOIN)
+  async getAll(filters = {}) {
+    const db = await getDb();
+    let sql = `
+      SELECT pr.*, ci.item_name, ci.maker, ci.category, ci.base_price, ci.unit, ci.photo_path,
+             su.name AS requester_name
+      FROM purchase_requests pr
+      JOIN consumable_items ci ON pr.item_id = ci.item_id
+      LEFT JOIN sso_users su ON pr.requester_id = su.user_id
+      WHERE 1=1
+    `;
+    const params = [];
+
+    if (filters.status) { sql += ' AND pr.status = ?'; params.push(filters.status); }
+    if (filters.requester_id) { sql += ' AND pr.requester_id = ?'; params.push(filters.requester_id); }
+    if (filters.category) { sql += ' AND ci.category = ?'; params.push(filters.category); }
+    if (filters.from_date) { sql += ' AND pr.request_date >= ?'; params.push(filters.from_date); }
+    if (filters.to_date) { sql += ' AND pr.request_date <= ?'; params.push(filters.to_date); }
+
+    sql += ' ORDER BY pr.created_at DESC';
+    const [rows] = await db.query(sql, params);
+    return rows;
+  },
+
+  // 단건 조회
+  async getById(requestId) {
+    const db = await getDb();
+    const [rows] = await db.query(`
+      SELECT pr.*, ci.item_name, ci.maker, ci.category, ci.base_price, ci.unit, ci.photo_path,
+             su.name AS requester_name
+      FROM purchase_requests pr
+      JOIN consumable_items ci ON pr.item_id = ci.item_id
+      LEFT JOIN sso_users su ON pr.requester_id = su.user_id
+      WHERE pr.request_id = ?
+    `, [requestId]);
+    return rows[0] || null;
+  },
+
+  // 구매신청 생성
+  async create(data) {
+    const db = await getDb();
+    const [result] = await db.query(
+      `INSERT INTO purchase_requests (item_id, quantity, requester_id, request_date, notes)
+       VALUES (?, ?, ?, ?, ?)`,
+      [data.item_id, data.quantity || 1, data.requester_id, data.request_date, data.notes || null]
+    );
+    return this.getById(result.insertId);
+  },
+
+  // 상태 변경 (보류)
+  async hold(requestId, holdReason) {
+    const db = await getDb();
+    await db.query(
+      `UPDATE purchase_requests SET status = 'hold', hold_reason = ? WHERE request_id = ?`,
+      [holdReason || null, requestId]
+    );
+    return this.getById(requestId);
+  },
+
+  // 상태 → purchased
+  async markPurchased(requestId) {
+    const db = await getDb();
+    await db.query(
+      `UPDATE purchase_requests SET status = 'purchased' WHERE request_id = ?`,
+      [requestId]
+    );
+  },
+
+  // pending으로 되돌리기
+  async revertToPending(requestId) {
+    const db = await getDb();
+    await db.query(
+      `UPDATE purchase_requests SET status = 'pending', hold_reason = NULL WHERE request_id = ?`,
+      [requestId]
+    );
+    return this.getById(requestId);
+  },
+
+  // 삭제 (admin only, pending 상태만)
+  async delete(requestId) {
+    const db = await getDb();
+    const [result] = await db.query(
+      `DELETE FROM purchase_requests WHERE request_id = ? AND status = 'pending'`,
+      [requestId]
+    );
+    return result.affectedRows > 0;
+  }
+};
+
+module.exports = PurchaseRequestModel;
--- a/system1-factory/api/models/settlementModel.js
+++ b/system1-factory/api/models/settlementModel.js
@@ -0,0 +1,104 @@
+// models/settlementModel.js
+const { getDb } = require('../dbPool');
+
+const SettlementModel = {
+  // 월간 분류별 요약
+  async getCategorySummary(yearMonth) {
+    const db = await getDb();
+    const [rows] = await db.query(`
+      SELECT ci.category,
+             COUNT(*) AS count,
+             SUM(p.quantity * p.unit_price) AS total_amount
+      FROM purchases p
+      JOIN consumable_items ci ON p.item_id = ci.item_id
+      WHERE DATE_FORMAT(p.purchase_date, '%Y-%m') = ?
+      GROUP BY ci.category
+    `, [yearMonth]);
+    return rows;
+  },
+
+  // 월간 업체별 요약
+  async getVendorSummary(yearMonth) {
+    const db = await getDb();
+    const [rows] = await db.query(`
+      SELECT v.vendor_id, v.vendor_name,
+             COUNT(*) AS count,
+             SUM(p.quantity * p.unit_price) AS total_amount,
+             ms.settlement_id, ms.status AS settlement_status,
+             ms.completed_at, ms.notes AS settlement_notes
+      FROM purchases p
+      LEFT JOIN vendors v ON p.vendor_id = v.vendor_id
+      LEFT JOIN monthly_settlements ms ON ms.vendor_id = p.vendor_id AND ms.year_month = ?
+      WHERE DATE_FORMAT(p.purchase_date, '%Y-%m') = ?
+      GROUP BY COALESCE(v.vendor_id, 0), v.vendor_name, ms.settlement_id, ms.status, ms.completed_at, ms.notes
+      ORDER BY total_amount DESC
+    `, [yearMonth, yearMonth]);
+    return rows;
+  },
+
+  // 월간 상세 구매 목록
+  async getMonthlyPurchases(yearMonth) {
+    const db = await getDb();
+    const [rows] = await db.query(`
+      SELECT p.*, ci.item_name, ci.maker, ci.category, ci.unit, ci.base_price, ci.photo_path,
+             v.vendor_name, su.name AS purchaser_name
+      FROM purchases p
+      JOIN consumable_items ci ON p.item_id = ci.item_id
+      LEFT JOIN vendors v ON p.vendor_id = v.vendor_id
+      LEFT JOIN sso_users su ON p.purchaser_id = su.user_id
+      WHERE DATE_FORMAT(p.purchase_date, '%Y-%m') = ?
+      ORDER BY p.purchase_date DESC
+    `, [yearMonth]);
+    return rows;
+  },
+
+  // 정산 완료 처리
+  async completeSettlement(yearMonth, vendorId, completedBy, notes) {
+    const db = await getDb();
+
+    // 총액 계산
+    const [[{ total }]] = await db.query(`
+      SELECT COALESCE(SUM(p.quantity * p.unit_price), 0) AS total
+      FROM purchases p
+      WHERE p.vendor_id = ? AND DATE_FORMAT(p.purchase_date, '%Y-%m') = ?
+    `, [vendorId, yearMonth]);
+
+    // UPSERT
+    await db.query(`
+      INSERT INTO monthly_settlements (year_month, vendor_id, total_amount, status, completed_at, completed_by, notes)
+      VALUES (?, ?, ?, 'completed', NOW(), ?, ?)
+      ON DUPLICATE KEY UPDATE status = 'completed', total_amount = ?, completed_at = NOW(), completed_by = ?, notes = ?
+    `, [yearMonth, vendorId, total, completedBy, notes || null, total, completedBy, notes || null]);
+
+    return { year_month: yearMonth, vendor_id: vendorId, total_amount: total, status: 'completed' };
+  },
+
+  // 정산 취소
+  async cancelSettlement(yearMonth, vendorId) {
+    const db = await getDb();
+    await db.query(`
+      UPDATE monthly_settlements SET status = 'pending', completed_at = NULL, completed_by = NULL
+      WHERE year_month = ? AND vendor_id = ?
+    `, [yearMonth, vendorId]);
+    return { year_month: yearMonth, vendor_id: vendorId, status: 'pending' };
+  },
+
+  // 가격 변동 목록 (월간)
+  async getPriceChanges(yearMonth) {
+    const db = await getDb();
+    const [rows] = await db.query(`
+      SELECT p.purchase_id, p.purchase_date, p.unit_price, p.quantity,
+             ci.item_id, ci.item_name, ci.maker, ci.category, ci.base_price,
+             v.vendor_name
+      FROM purchases p
+      JOIN consumable_items ci ON p.item_id = ci.item_id
+      LEFT JOIN vendors v ON p.vendor_id = v.vendor_id
+      WHERE DATE_FORMAT(p.purchase_date, '%Y-%m') = ?
+        AND p.unit_price != ci.base_price
+      ORDER BY ABS(p.unit_price - ci.base_price) DESC
+    `, [yearMonth]);
+    return rows;
+  }
+};
+
+module.exports = SettlementModel;
--- a/system1-factory/api/routes/purchaseRequestRoutes.js
+++ b/system1-factory/api/routes/purchaseRequestRoutes.js
@@ -0,0 +1,18 @@
+const express = require('express');
+const router = express.Router();
+const ctrl = require('../controllers/purchaseRequestController');
+const { requireMinLevel } = require('../middlewares/auth');
+
+// 보조 데이터
+router.get('/consumable-items', ctrl.getConsumableItems);
+router.get('/vendors', ctrl.getVendors);
+
+// 구매신청 CRUD
+router.get('/', ctrl.getAll);
+router.get('/:id', ctrl.getById);
+router.post('/', ctrl.create);
+router.put('/:id/hold', requireMinLevel('admin'), ctrl.hold);
+router.put('/:id/revert', requireMinLevel('admin'), ctrl.revert);
+router.delete('/:id', ctrl.delete);
+
+module.exports = router;
--- a/system1-factory/api/routes/purchaseRoutes.js
+++ b/system1-factory/api/routes/purchaseRoutes.js
@@ -0,0 +1,10 @@
+const express = require('express');
+const router = express.Router();
+const ctrl = require('../controllers/purchaseController');
+const { requireMinLevel } = require('../middlewares/auth');
+
+router.get('/', ctrl.getAll);
+router.post('/', requireMinLevel('admin'), ctrl.create);
+router.get('/price-history/:itemId', ctrl.getPriceHistory);
+
+module.exports = router;
--- a/system1-factory/api/routes/settlementRoutes.js
+++ b/system1-factory/api/routes/settlementRoutes.js
@@ -0,0 +1,12 @@
+const express = require('express');
+const router = express.Router();
+const ctrl = require('../controllers/settlementController');
+const { requireMinLevel } = require('../middlewares/auth');
+
+router.get('/summary', ctrl.getMonthlySummary);
+router.get('/purchases', ctrl.getMonthlyPurchases);
+router.get('/price-changes', ctrl.getPriceChanges);
+router.post('/complete', requireMinLevel('admin'), ctrl.complete);
+router.post('/cancel', requireMinLevel('admin'), ctrl.cancel);
+
+module.exports = router;