EL-FLOW (Enterprise Logic Flow)

EL-FLOW는 중소기업 생산/재고 관리를 위한 웹 기반 ERP(Enterprise Resource Planning) 시스템입니다. 복잡한 제조 프로세스를 단순화하고, 자재 입고부터 생산, 재고 관리, 발주, 매출까지의 전체 흐름을 통합 관리합니다.

🚀 Key Features (핵심 기능)

• 🔐 사용자 및 인증 관리 (Role-Based Access Control)

  • JWT 기반 인증 및 보안 로그인
  • 사용자 권한 관리 (관리자, 구매, 생산, 영업 등)

• 🏭 생산/제조 관리 (Production Management)

  • BOM (Bill of Materials) 관리: 제품 생산을 위한 자재 구성 정의
  • 생산 계획 및 등록: 생산 시 자재 자동 차감 (재고 연동)
  • 생산 시뮬레이션: 생산 가능 수량 예측 및 부족 자재 식별

• 📦 재고 및 자재 관리 (Inventory & Material)

  • 선입선출(FIFO) 로직: 자재 출고 시 먼저 입고된 자재부터 차감
  • 엑셀 대량 등록: 자재 입고 내역 엑셀 업로드 지원
  • 재고 실사 및 조정: 실재고와 전산재고 차이 보정 및 감사 로그 기록

• 💰 구매 및 영업 관리 (Purchase & Sales)

  • 발주 요청(PO): 부족 자재에 대한 구매 요청 워크플로우
  • 매출 등록: 완제품 판매 및 재고 차감, 거래명세서 엑셀 다운로드

• 📊 대시보드 및 리포트

  • 실시간 자재/제품 재고 현황
  • 월별 입출고 리포트

🛠 Tech Stack (기술 스택)

Backend

• Language: Kotlin 1.8
• Framework: Spring Boot 3.1
• Database:
  • MariaDB (Production)
  • H2 (Test)
  • Redis (Caching & Refresh Token)
• Security: Spring Security + JWT
• Testing: JUnit 5, MockMvc
• API Docs: Swagger (OpenAPI 3.0)

Frontend

• Framework: Vue.js 3 (Composition API)
• State Management: Pinia
• Styling: Tailwind CSS
• Build Tool: Vite

DevOps

• Containerization: Docker & Docker Compose
• CI/CD: Github Actions (Planned)

🏃‍♂️ Getting Started (실행 방법)

Prerequisites

• Docker & Docker Compose installed
• JDK 17+ (for local development)
• Node.js 18+ (for local development)

Quick Start (Docker)

# 프로젝트 클론
git clone https://github.com/your-repo/el-flow.git
cd el-flow

# 전체 시스템 실행 (Backend + Frontend + DB + Redis)
docker-compose up -d

• Backend API: http://localhost:8080/api
• Frontend: http://localhost:3000

Local Development

Backend

cd backend/el-flow
./gradlew bootRun

Frontend

cd frontend
npm install
npm run dev

📂 Project Structure

el-flow/
├── backend/            # Spring Boot Application
│   ├── src/main/kotlin # Source Code (Domain-Driven Design)
│   └── src/test        # Integration & Unit Tests
├── frontend/           # Vue.js Application
│   ├── src/views       # Page Components
│   └── src/stores      # Pinia Stores
└── docker-compose.yml  # Container Orchestration

📝 License

This project is licensed under the MIT License.