EverNex BMS Smart Factory

목차

프로젝트 개요

주요 기능

실시간 대시보드

차량 관리

경보 관리

LLM 챗봇

설정 관리 (관리자 전용)

사용자 관리 (관리자 전용)

다국어 & 테마

기술 스택

백엔드

프론트엔드

인프라

프로젝트 구조

04_BMS_SF_ver02/
├── backend/
│ ├── Dockerfile # 멀티스테이지 Docker 빌드
│ ├── pom.xml
│ └── src/main/java/com/evernex/bms/
│ ├── BmsApplication.java
│ ├── config/ # CORS 설정 (WebConfig)
│ ├── controller/ # REST API 컨트롤러 9개
│ │ ├── AuthController # 로그인 / 회원가입 / 내 정보
│ │ ├── DashboardController # 실시간 통계
│ │ ├── VehiclesController # 차량 CRUD + 상세 조회
│ │ ├── AlertsController # 경보 관리
│ │ ├── ChatController # LLM 챗봇 + 리포트 생성
│ │ ├── ReportsController # 저장된 리포트 조회/삭제
│ │ ├── SettingsController # 관리 설정
│ │ ├── UsersController # 사용자 관리
│ │ └── HealthController # 헬스 체크
│ ├── service/
│ │ ├── SimulationService # 500ms 스케줄 상태머신
│ │ ├── VehicleFactoryService # 차량 자동 생성
│ │ ├── ChatService # RAG Lite / Text-to-SQL 처리
│ │ ├── LlmClient # OpenAI / Gemini / LM Studio 연동
│ │ ├── SettingsService # 설정 CRUD
│ │ └── RandomMetricService # 시뮬레이션용 난수 생성
│ ├── security/
│ │ ├── JwtUtil # JWT 생성·검증 (HS256)
│ │ ├── JwtAuthFilter # Spring 필터 체인 인증
│ │ ├── AuthContext # 스레드로컬 사용자 정보
│ │ ├── AuthPrincipal # 사용자 권한 모델
│ │ └── GlobalExceptionHandler
│ ├── db/
│ │ ├── SchemaInitializer # 앱 시작 시 테이블 자동 생성
│ │ ├── DataSeeder # 샘플 데이터 삽입
│ │ ├── FactoryScope # 공장 권한 필터링
│ │ └── TimeUtil
│ └── domain/
│ └── Constants # 차량 상태, 모델명, 공장 상수
│
├── frontend/
│ ├── vercel.json # SPA 라우팅 설정
│ ├── src/
│ │ ├── views/ # 페이지 컴포넌트 9개
│ │ │ ├── Dashboard.vue
│ │ │ ├── VehicleList.vue
│ │ │ ├── VehicleDetail.vue
│ │ │ ├── Alerts.vue
│ │ │ ├── Reports.vue
│ │ │ ├── Settings.vue
│ │ │ ├── Users.vue
│ │ │ ├── Login.vue
│ │ │ └── Signup.vue
│ │ ├── components/
│ │ │ ├── Chatbot.vue # 부동형 LLM 챗봇 위젯
│ │ │ ├── CellHeatmap.vue # 배터리 셀 온도 히트맵
│ │ │ ├── Gauge.vue # SOC/SOH/온도 게이지 차트
│ │ │ ├── ProcessTimeline.vue # 처리 단계 타임라인
│ │ │ ├── FactoryFilter.vue # 공장 다중 선택 필터
│ │ │ └── MultiSelect.vue # 범용 다중 선택 드롭다운
│ │ ├── layouts/
│ │ │ └── AppLayout.vue # 사이드바 + 헤더 레이아웃
│ │ ├── stores/ # Pinia 상태 관리
│ │ │ ├── auth.js # 로그인 / 사용자 정보
│ │ │ ├── filters.js # 공장 필터 상태
│ │ │ ├── alerts.js # 미해결 경보 카운트
│ │ │ └── theme.js # 다크 / 라이트 모드
│ │ ├── composables/
│ │ │ ├── api.js # HTTP 클라이언트 (JWT 자동 첨부, 401 자동 로그아웃)
│ │ │ ├── status.js # 상태별 색상·라벨 매핑
│ │ │ └── labels.js # 모델명·공장·국가 라벨
│ │ ├── router/index.js # Vue Router (인증 가드)
│ │ └── i18n/
│ │ └── locales/
│ │ ├── ko.js # 한국어 메시지
│ │ └── en.js # 영어 메시지
│
├── sql/
│ ├── schema.sql # MySQL DDL (프로덕션 마이그레이션 참고용)
│ └── seed.sql # 초기 데이터
│
├── .github/workflows/
│ ├── backend-ci.yml # Maven 빌드 + Docker 빌드 검증
│ └── frontend-ci.yml # npm ci + Vite 빌드 검증
│
├── render.yaml # Render Blueprint 설정
├── DEPLOYMENT.md # Vercel + Render 배포 단계별 가이드
└── README.md

로컬 실행

사전 요구사항

환경 변수

백엔드

프론트엔드 (.env)

API 엔드포인트

인증

대시보드

차량

경보

챗봇 & 리포트

설정 & 사용자 (관리자 전용)

헬스 체크

데이터베이스 스키마

주요 테이블 (16개)

차량 상태 흐름

ARRIVAL (입고)
 │
 ▼ 6단계 검사
BATTERY_INSPECTION ─── 이상 감지 ──► ANOMALY_DETECTED
CELL_INSPECTION │
 │ 통과 QA_MAINTENANCE
 │ │
 │ RE_INSPECTION_WAITING
 │ RE_INSPECTION
 │◄──────────────────────────────── 재검사 통과
 │
BATTERY_QC_COMPLETE
 │
SHIPMENT_WAITING
 │
SHIPMENT_COMPLETE (출고 완료)

배터리 검사 6단계

LLM 챗봇

지원 제공자

동작 모드

리포트 생성

챗봇 설정 방법

배포

빠른 요약

1. Render → New → Blueprint → 이 저장소 연결
 → render.yaml 자동 감지 → bms-backend 배포
2. Vercel → New Project → 이 저장소 Import
 → Root Directory: frontend
 → 환경 변수: VITE_API_BASE_URL = https://<render-url>/api/v1
 → Deploy

권한 체계