Enterprise Resource Planning

ERP

프로젝트형 제조, 공급망, 품질, 재무, 시운전 운영을 한 화면 흐름으로 연결하는 업무 웹 애플리케이션입니다.

GitHub 저장소README 보기
Repository
cptkuk91/erp
Framework
Next.js 16.1.6
Database
MongoDB Driver 7.1.0
License
Apache License 2.0

Product Screens

실제 화면으로 보는 ERP

Dashboard

ERP 운영 현황판

진행 프로젝트, 오픈 NCR, 미확정 전표, 승인 대기, 자료실 최신 문서를 한 화면에서 확인합니다.

1 / 4

Product Overview

단순 CRUD 샘플이 아니라 내부 업무 시스템에 가깝습니다.

사업기회 발굴부터 계약, 프로젝트 구조화, 실행예산, 발주, 입고, 재고, 제작, 출하, 품질, 안전, 재무, 시운전, 승인 워크플로우까지 부서별로 흩어지는 운영 데이터를 하나의 서비스로 연결합니다.

Service Domains

제공하는 업무 영역

사업개발

고객/거래처, 사업기회, 계약 생성과 수주/실주 상태 전이를 관리합니다.

프로젝트 운영

프로젝트, 현장, 유닛, 시스템, WBS, 실행예산 승인과 집행을 연결합니다.

공급망 / 자재

공급업체, 자재 마스터, 발주, 입고, 재고 이동과 조정 흐름을 다룹니다.

제작 / 물류

모듈, 제작오더, 운송/통관 상태 전이를 프로젝트 구조와 함께 추적합니다.

품질 / 안전

ITP, 검사, NCR, HSE 사고 등록부터 검토, 승인, 종료까지 관리합니다.

재무

계정과목, AP, AR, 전표, 고정자산, 감가상각과 예산 사용액을 연결합니다.

시운전 / 규제

시운전 패키지, MC/COMM 완료, 인계, 규제 대응 액션 일정을 추적합니다.

플랫폼 / 협업

사용자, 조직, 역할, 정책, 공지, 자료실, 승인함, 알림을 제공합니다.

Core Scenarios

핵심 사용자 시나리오

계약에서 수금까지

  1. 1사업기회 생성
  2. 2계약 활성화
  3. 3프로젝트 연결
  4. 4AR 발행
  5. 5수금과 자동 전표 생성

프로젝트 계획에서 집행까지

  1. 1프로젝트 생성
  2. 2현장/WBS 정의
  3. 3실행예산 승인
  4. 4발주/AP/전표 기반 사용액 재계산

발주에서 재고 반영까지

  1. 1공급업체와 자재 준비
  2. 2발주 승인
  3. 3입고 등록
  4. 4발주 상태와 재고 트랜잭션 갱신

제작에서 시운전 인계까지

  1. 1모듈 생성
  2. 2제작오더 진행
  3. 3운송/통관 추적
  4. 4시운전 완료와 인계 처리

협업 문서 승인까지

  1. 1문서 초안 작성
  2. 2검토 요청
  3. 3승인 또는 반려
  4. 4게시 상태 전환과 이력 누적

Technology

기술 스택

Frontend

  • Next.js 16.1.6 App Router
  • React 19.2.3
  • TypeScript 5
  • Tailwind CSS v4

Backend / Data

  • Next.js Route Handlers
  • MongoDB Node Driver 7.1.0
  • MongoDB transactions
  • Denormalized snapshots

Auth / Access

  • Google OAuth
  • 역할 기반 접근 제어
  • 프로젝트 범위 제한

Tooling

  • ESLint 9
  • eslint-config-next
  • Node.js 20+ 권장
  • Apache License 2.0

Architecture

아키텍처와 접근 제어

Single Next.js Runtime

Next.js 한 애플리케이션 안에서 화면과 업무 API를 함께 제공합니다.

Permission Guard

페이지와 API 접근을 사용자 역할과 업무 권한 기준으로 제한합니다.

Project Scope

프로젝트별 데이터 범위를 나누고 접근 가능한 프로젝트만 조회합니다.

MongoDB Transaction

발주, 재고, 재무 핵심 흐름은 트랜잭션으로 데이터 일관성을 유지합니다.

Data Model

데이터 연결 방식

업무 문서에 필요한 참조 정보를 함께 저장해 당시 기준을 보존합니다.

업무 문서 이력 보존

참조 원본이 바뀌어도 당시 업무 문서에 기록된 이름과 코드를 유지합니다.

프로젝트 단위 데이터 연결

프로젝트, 현장, 유닛, 시스템, WBS 정보를 기준으로 업무 데이터를 연결합니다.

예산·발주·재무 흐름 추적

실행예산, 발주, AP/AR, 전표 흐름을 함께 추적해 집행 상태를 확인합니다.

운영 메모

일부 화면과 업무 흐름은 실제 운영 기준에 맞춰 계속 개선하고 있습니다.
재고와 재무 흐름에는 트랜잭션을 지원하는 MongoDB 환경을 권장합니다.
권한, 승인, 재무 흐름은 실제 업무 기준에 맞춰 계속 보완하고 있습니다.
실제 운영 시나리오를 기준으로 데이터 구조와 화면 구성을 지속적으로 다듬고 있습니다.

Open Source ERP

프로젝트 운영 흐름을 코드로 확인하세요.

누구나 무료로 사용할 수 있으며, GitHub에서 코드와 라이선스를 확인할 수 있습니다.

저장소 보기