🖥 BPS_Frontend Sever

⚙ Project Settings

$ node --version
v20.11.0

$ npm --version
v10.5.0

$ docker --version
v24.0.5

$ nginx --v
nginx/1.18.0

🛠 Project Setup

$ npm install -g npm@10.5.0
$ npm install vite
$ npm install axios
$ npm install -D sass
$ npm install js-cookie
$ npm install chart.js
$ npm install @fortawesome/fontawesome-free
$ npm install xlsx file-saver
$ npm install lodash-es
$ npm install autonumeric
$ npm install exceljs
$ npm install file-saver

💡 Compile and Hot-Reload for Development

npm run dev

📀 Deploy URL

https://bpssystem.store

🚩 Github Action Deploy to EC2 with docker container

🎨 FrontEnd View

화면 설계서

⭐ 로그인

### 로그인 / 로그아웃
https://github.com/T2-Papillon/Main/assets/148880521/4cfb8e7f-c529-4259-8ce5-33bd960ca7bc - DB에 저장되어있는 사번과 비밀번호로 로그인한다. - 퇴사자는 로그인할 수 없다. - 로그인에 성공한 사람만 로그아웃을 할 수 있다.

⭐ 대시 보드

### 대시 보드
https://github.com/T2-Papillon/Main/assets/148880521/d3202842-64e8-4f0b-8f74-3108f1fc44b8 #### 이달의 거래처 - 현재 거래처 목록이 지도에 모두 표기된다. - 거래처 목록중 이달 매출 1위인 지점을 왕관아이콘으로 표시해준다. - 지도에서 해당 거래처에 커서를 위치하면 해당 거래처 이름이 표기된다. #### 이달의 최우수 사원 - 이달 최고 매출을 찍은 사원의 사진과 이름, 소속부서, 매출액이 표기된다. #### 창고/차량 온도 조회 ![image](https://github.com/Team5-be01-Final-Project/.github/assets/150888333/77e43f6c-4703-4794-be95-76ea68437052) - 창고의 온도를 대시보드에서 확인할 수 있다. - 각 차량 별로 온도를 그래프를 통해 대시보드에서 확인할 수 있다. - 하단에 마지막 업데이트 시간이 표기된다. #### 이달의 매출 현황 - 이달 거래처별 매출 현황을 확인 할 수 있다. #### 월별 매출 현황 - 월별로 총매출 합계와 순이익을 조회할 수 있다.

⭐ 사원 관리

### 사원 조회
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/ba4b845d-3d67-46ef-aac6-3f9eb22cc483 - 대표와 팀장은 전직원 조회가 가능하지만 사원은 조회할 수 없다.
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/5d08f08e-0ddc-416c-b4d8-07fa2bf7516a - 대표 권한자만 권한을 수정할 수 있다. - 대표 권한자만 알림 수신 여부를 수정할 수 있다.

⭐ 이상 온도

### 이상 온도 알림
![image](https://github.com/Team5-be01-Final-Project/Frontend/assets/149128094/c8c3a92f-a43b-4c29-85d1-5c6d116ddb2d) - 온도가 특정 범위(냉장(2∼8℃))를 벗어나면 관리자(알림대상자) 이메일로 알림을 전송한다. - 관리자(알림대상자)는 알림 로그 목록을 조회할 수 있다.

⭐ 제품 관리

### 제품 조회
![image](https://github.com/Team5-be01-Final-Project/.github/assets/148880521/101f18e3-caae-491d-afd5-3c47b5fc10e9) ![image](https://github.com/Team5-be01-Final-Project/.github/assets/148880521/8e48d034-0375-4a04-aeaa-13e1076b833f) - 제품 목록 조회 시 대표, 팀장의 경우 모두 조회할 수 있지만 사원은 단가를 조회할 수 없다. - 특정 거래처에 대한 제품을 검색하여 조회할 수 있다.
### 거래처 별 판매가 등록, 수정, 삭제
[https://github.com/Team5-be01-Final-Project/.github/assets/148880521/c1fb03a9-0775-47f0-beab-5cfcc1ef8262](https://github.com/Team5-be01-Final-Project/.github/assets/148880521/0f5877cf-6171-4694-84d4-a704c26825b3) - 거래처별 판매가 등록은 대표와 팀장만 가능하다. - 거래처에 중복된 조건의 제품은 등록이 불가능하다. - 대표와 팀장은 수정, 삭제가 가능하지만 사원은 불가능하다.
### 거래처 별 제품 조회
![image](https://github.com/Team5-be01-Final-Project/Frontend/assets/149128094/58df5d28-80d8-412c-8786-721decd80870) - 거래처별 제품을 모든 사원이 조회가 가능하다.

⭐ 재고 관리

### 재고 조회 및 등록
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/9138c2b7-58e8-48d6-9161-d30310e312e6 - 재고 조회는 현재 남아있는 재고를 조회하며 전 직원이 조회할 수 있다. - 재고를 등록하기 위해서 특정 제품을 검색할 수 있다. - 재고 등록은 대표와 팀장만 가능하다.

⭐ 전표 관리

### 전표 조회
![image](https://github.com/Team5-be01-Final-Project/Frontend/assets/149128094/89c6553f-ce79-4e82-8deb-49431d77b204) - 전표의 상태는 승인대기, 승인완료, 반려가 있다. - 모든 전표 목록은 전 직원이 조회할 수 있다. - 해당 전표 조회는 전표를 생성한 팀만 조회가 가능하다.
### 전표 등록
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/da65893d-490e-4d44-a0b1-3a1fb4efca1c - 전표 등록은 사원만 가능하다. - 일자별로 출고 전표를 등록 할 수 있다. - 전표 등록 시 재고는 차감이 된다. - 전표를 등록하면 승인 대기 상태가 된다.
### 전표 승인 및 반려
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/14bf4e52-daaf-42c3-a2de-29e2e1daf48d - 대표, 팀장만 전표 승인 및 반려 권한이 있으며 대기 상태의 출고전표를 승인 및 반려 할 수 있다. - 반려 시 전표 등록에 차감되었던 물품 수량은 재고로 재등록 된다.

⭐ 판매 관리

### 매출
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/329ea5fd-404b-4fa9-bedf-316d2cf4da24 - 제품별로 판매 현황을 테이블로 조회할 수 있다. - 사원은 제품명, 판매가, 수량, 매출액 만 확인할 수 있다.
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/b0ba662c-4f62-4ee3-b260-cbd712007350 - 거래처별로 판매 현황을 테이블로 조회할 수 있다. - 사원은 제품명, 판매가, 수량, 매출액 만 확인할 수 있다.

⭐ 거래처 관리

### 거래처 조회
![image](https://github.com/Team5-be01-Final-Project/Frontend/assets/149128094/1cb2c41e-1988-4521-91f3-18a63bf6c4de) - 매출 거래처 목록을 조회 할 수 있다.
### 거래처 등록 및 수정
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/4f2a3fc3-3683-4bdd-913f-04aa27911d2f - 대표, 팀장만 매출 거래처 등록, 수정과 삭제 권한이 있으며 사원은 등록, 수정 삭제 기능을 이용할 수 없다.

⭐ 인센티브 관리

### 인센티브 현황
![image](https://github.com/Team5-be01-Final-Project/Frontend/assets/149128094/91b57341-15b8-450c-adb0-31c7c2d1db94) - 대표는 전 직원에 대한 인센티브 조회가 가능하다. - 팀장인 본인 팀원에 대한 인센티브 조회가 가능하다. - 사원은 이 메뉴를 이용할 수 없다.

⭐ My 영업

### My 영업
https://github.com/Team5-be01-Final-Project/.github/assets/148880521/5ab69fd8-0df9-42bb-b62d-44b1b6afbece #### 내 정보 조회 - 사원은 자신의 정보를 조회할 수 있다. #### 내 거래처 조회 - 사원은 자신의 담당 병원에 대한 이름, 담당자, 담당자 전화번호를 조회할 수 있다. #### 내 매출 현황 - 사원은 자신의 최근 3개월 거래처 당 매출현황을 볼 수 있다. #### 내 인센티브 - 사원은 자신의 현재매출 대비 인센티브를 확인할 수 있다. - 추가 매출을 기입하여 예상 인센티브를 확인할 수 있다. - 시뮬레이션 기능이기 때문에 데이터를 변환하지 않는다.

📝 Changelog

Changelog.md

🧾 릴리즈 내역

Release v7.0.0

화면 권한 수정
버그 수정 및 기타 디자인 수정

릴리즈 모음

- [Release v6.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v6.0.0) - 버그 수정 및 기타 디자인 수정 - [Release v6.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v6.0.0) - 버그 수정 및 기타 디자인 수정 - [Release v5.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v5.0.0) - 디자인 및 기타 오류 수정 - [Release v4.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v4.0.0) - 권한 관리 추가. - [Release v3.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v3.0.0) - 대시보드, My영업 및 매출 관리 기능 추가. - [Release v2.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v2.0.0) - Docker, Nginx 사용, npm run build로 수정 및 쿠키 들어오는거 확인 - [Release v1.0.0](https://github.com/Team5-be01-Final-Project/Frontend2/releases/tag/v1.0.0) - Github Flow를 통해 EC2로 CI/CD 구축. (Docker 및 nginx는 사용하지 않고, npm run dev로 실행 확인)

Team5-be01-Final-Project / Frontend

readme