hanaloan/hanaroan

🏦 Digital HanaRoan

💻 Demonstation

https://youtu.be/jS3viuVVsro

🚀 Deployment

https://www.hanaroan.shop

👥 Team Members

Role	Name	Email	Github
Leader	민새미	[email protected]	Github Link
Member	장주성	[email protected]	Github Link
Member	성창호	[email protected]	Github Link
Member	한성훈	[email protected]	Github Link

📄 Project Description

금융권 개발자에 대한 관심으로 실제 대출 상품 이용과 관련하여 고민했고, 이에 대출 운영 간소화 및 수작업을 감소시키기 위해 관리자 시스템 및 간략한 사용자 화면을 구축

💻 기술 스택 🛠️

개발 환경

IDE	JDK	Build	Database Tool

Frontend

HTML	CSS	JavaScript	AJAX

JSP

Backend

Java	Servlet

DevOps

AWS	RDS	Redis	Nginx	Reverse Proxy	SSL

협업

GIT	Notion

📂 Folder Structure

• Controller: 사용자의 요청을 처리하고, 해당 요청에 따른 적절한 동작을 수행한 후, 응답을 생성합니다. 요청은 URL, HTTP 메소드, 헤더, 쿠키, 요청 본문 등을 포함할 수 있습니다.

• Service: 비즈니스 로직을 담당합니다. Service는 Controller에 의해 호출되어 실제로 데이터를 처리하고, DAO를 통해 데이터를 저장, 수정, 삭제, 조회합니다. 이러한 연산을 수행하는 로직이 포함됩니다.

• DAO (Data Access Object): 데이터베이스 접근 로직을 담당합니다. DAO는 Service에 의해 호출되며, 데이터베이스에 직접 접근하여 데이터를 CRUD(생성, 읽기, 업데이트, 삭제)하는 역할을 합니다.

• Model (DTO): 애플리케이션의 데이터를 담는 객체입니다. 이들은 데이터베이스 테이블을 나타낼 수도 있고, 복잡한 비즈니스 로직을 수행하는데 필요한 정보를 담을 수도 있습니다.

• Config: 환경설정 파일들이 저장되는 디렉터리입니다. 데이터베이스 연결정보, 보안설정 등이 포함될 수 있습니다.

• Utils: 애플리케이션 전반에서 사용되는 유틸리티 클래스들이 저장되는 디렉터리입니다.

├── main
│   ├── java
│   │   ├── com
│   │   │   ├── Background               # 백그라운드로 실행되는 컴포넌트들 (예: Redis)
│   │   │   ├── Config                   # 환경 설정 파일들 (예: Secret Keys)
│   │   │   ├── Controller               # 사용자의 요청 처리 및 응답을 담당하는 컨트롤러들
│   │   │   ├── DAO                      # 데이터베이스 접근을 담당하는 DAO (Data Access Object) 코드들
│   │   │   ├── Model                    # DTO (Data Transfer Object) 클래스들
│   │   │   ├── Service                  # 비즈니스 로직을 담당하는 서비스 클래스들
│   │   │   └── Utils                    # 유틸리티 클래스들 (예: DB 연결, 정규 표현식 등)
│   ├── webapp
│   │   ├── css                          # CSS 스타일시트 파일들
│   │   ├── img                          # 이미지 리소스들
│   │   ├── js                           # 자바스크립트 코드 파일들
│   │   ├── jsp                          # JSP (Java Server Pages) 파일들
│   │   ├── resource                     # 공통 리소스 파일들
│   │   ├── scss                         # SCSS 파일들
│   │   ├── vendor                       # 외부 라이브러리들
│   │   └── WEB-INF                      # 웹 애플리케이션에 필요한 자원들을 담고 있는 디렉토리 (예: 보안 설정, 서블릿 매핑 등)
└── README.md                            # 프로젝트에 대한 설명이 적힌 README 파일

🌐 배포환경

🗄️ 데이터베이스 모델링

개념적 설계

---

논리적 설계

---

유스케이스

🎨 UI

ℹ️ Functional Description & Details

<관리자_대시보드>

1. 대출 관리 프로그램에 대한 전체적인 개요를 확인할 수 있다.

2. 최근 대출 신청, 기한이 지난 대출, 상환된 총 대출, 상환 기한, 연체율 등에 대한 요약 통계 또는 데이터 시각화를 위한 그래프가 포함될 수 있다.

3. 관리자는 이 페이지에서 대출 포트폴리오의 전반적인 건전성과 상태를 신속하게 평가할 수 있다.

   <상단>

   • 대출 진행 중인 총 금액 표시(진행 중 + 연체 중)
   • 연체 중인 금액 표시
   • 전체 대출 진행중인 고객 중 연체된 고객의 비율
   • 고객이 대출 신청 후 pending 상태인 대출의 수(클릭하면 대출 상태 변경할 수 있는 페이지로 이동)

   <중간 - 플랫폼 관리>

   • 월간 활성 사용자 수를 파악하여 플랫폼의 장기적인 성장을 측정한다.

   • 플랫폼의 일일 사용량을 측정하고, 특정 이벤트에 따른 사용량의 유의미한 영향을 파악한다.

   • 새로운 기획에 도움이 되는 지표를 제공한다.

   • 주간 PV: 1주일 간의 PV 그래프

   • 주간 UV: 1주일 간의 UV 그래프

   • 상환 연체 비율 : 전체 대출 중 상환 중, 연체 중, 상환 완료된 대출의 비율을 도넛 차트로 표현

   <하단>

   • 상품별 신청 비율: 대출 상품 타입 별 신청 비율 표시
   • 하나론 이용 안내: 간단한 안내 문구와 문의 사항 방법에 대해 표시(실제 링크 없음)

<관리자_직원(사용자) 관리>

1. 관리자가 시스템의 내부 사용자(직원)를 조회 및 관리할 수 있다.

2. 직원 등록 및 접근 권한 부여 및 변경에 대한 기능을 담고 있다.

3. 인증 및 권한 부여 메커니즘을 구현하여 시스템에 대한 보안 액세스를 보장한다.

4. “all”의 권한을 가진 관리자가 직원의 계정을 만들고 관리할 수 있으며, 접근 권한 또한 수정할 수 있다.

5. 총괄 관리자의 아이디와 비밀번호는 각각 root와 1234로 한다.

6. 관리자에게 부여되는 권한은 다음과 같이 구분한다.

   • 총괄 관리자 = “all”
   • 대출 상품 관리자 = “managing Products”
   • 고객 정보 관리자 = “managing Customers”
   • 조회만 가능한 관리자 = “read only”
   • 접근이 불가능한 관리자 = “none”

7. 총괄 관리자(“all”)는 직원 등록 뿐만 아니라 권한 부여를 할 수 있고, 대출 상품과 고객 정보에 대해 모든 접근이 가능하다.

8. 대출 상품 관리자(“managing Products”)는 상품 조회, 추가 및 삭제를 할 수 있다. 또한, 대출 상환 관리에서 잔액 관리 및 연체 관리를 할 수 있다. 그 외의 업무는 수행할 수 없다.

9. 고객 정보 관리자(“managing Customers”)는 고객 정보를 확인하고 승인 처리를 해줄 수 있다. 그 외의 업무는 수행할 수 없다.

10. 조회만 가능한 관리자(“read only”)는 직원 조회, 상품 조회, 고객 정보 조회만 가능하다.

11. 접근이 불가능한 관리자(““none””)는 관리자 페이지로 로그인이 불가능하다.

12. 직원 관리를 할 수 없는 관리자는 직원 등록, 접근권한 부여 버튼이 활성화가 안되어 있다.

13. 직원 등록 버튼을 누르면 직원 추가 폼으로 이동하여 ID, Password, Name, Authority를 입력하여 추가할 수 있다.

14. 접근 권한 부여 버튼을 누르면 권한에 해당하는 행의 드롭메뉴가 활성화 되어 권한을 변경할 수 있다.

15. 이때, all인 관리자 본인은 자신의 권한을 변경하지 못한다.

<관리자_승인 관리>

1. 고객 정보 관리자(“managing Customers”)는고객의 대출 신청 내역, 대출 상태, 상환 내역 및 각 고객과의 기타 상호 작용을 볼 수 있다.
2. 참조 및 분석을 위해 고객의 활동 로그를 추적하는 상호 작용을 기록한다.
3. 사전 정의된 기준에 따라 대출 승인 또는 거부를 지원한다.
4. 관리자가 보류, 승인, 거부 및 지불된 대출을 포함하여 대출 신청 상태를 추적할 수 있다.
5. 승인 프로세스의 구성으로 대출 상태를 표현하는 명칭은 다음과 같다.
   • Pending : 보류 중
   • Approved : 승인됨
   • Denied : 거부됨
6. 고객이 대출 상품을 신청하면 Pending 상태로 뜨게 되고, 관리자가 고객의 정보를 고려하여 신청을 승인해줄 지 거부할 지 제어할 수 있다.
7. Approved 상태가 되면 승인된 날짜부터 대출이 진행되어 상환날짜와 상환 금액, 상환 상태가 업데이트 된다.
8. Denied 상태가 되면 위와 같은 정보가 표시되지 않는다.
9. 검색기능이 있어 같은 사용자가 같은 대출 상품을 연속으로 신청한 경우 쉽게 확인하여 처리할 수 있다.

<관리자_고객관리>

1. 고객 정보 관리자(“managing Customers”)는 개인 정보, 연락처 정보, 재무 정보, 고용 이력, 신용 점수 등 모든 고객 정보를 보고 관리할 수 있다.
2. 이후에 신용점수, 소득, 직업 분류를 고려하여 대출 승인 처리 유무를 가릴 수 있다.
3. 검색 기능을 이용하여 효율적으로 고객을 찾을 수 있다.

<관리자_대출관리>

1. 고객에게 제공하는 대출 상품들의 정보를 조회, 추가 및 삭제 할 수 있다.

2. 해당 업무는 상품 관리자(“managing Products”) 권한을 갖고 있는 관리자가 수행할 수 있다.

3. 은행 관리자는 대출관리 시스템을 통해 전세 대출, 담보 대출 등과 같은 대출 상품을 등록 및 삭제할 수 있다.

4. 상품 종류에 따라 전체, 전세, 월세, 담보의 상품만 선택하여 조회할 수 있다.

5. 각 대출 상품은 고유번호, 상품 종류, 이름 이율, 연체이율, 최대한도, 기간, 최소신용점수 등의 속성을 가지고 있다. 이러한 속성들은 대출 상품의 특성을 정의하고, 고객이 대출 상품을 선택하는 데 필요한 정보를 제공한다.

   • 대출 상품 정보
     • 상품명: 대출 상품명
     • (연체)이자율: 대출 상품의 연간 이자율. 이는 고정 금리 또는 시장 상황에 따라 변경되는 변동금리일 수 있음.
     • 대출 기간: 대출 상환 기간. 이것은 몇 달 또는 몇 년으로 표현될 수 있습니다.
     • 대출 유형: 대출 유형(전월세 대출, 담보 대출).
     • 대출 한도: 본 대출 상품으로 빌릴 수 있는 최대 금액입니다.
     • 자격 기준: 차용인이 대출 상품에 대한 자격을 갖추기 위해 충족해야 하는 기준. (최소 신용 점수, 최소 소득)

6. 신용점수, 직업, 소득 등과 같은 고객의 정보는 대출 상품을 이용할 수 있는 고객의 범위를 결정하는 요소이다.

7. 대출 상품에는 최소 신용 등급이 설정되어 있다. 신용 점수로 구분하여 0점부터 1000점까지 존재한다.

8. 직장 분류로는 professional(전문직), public servant(공직), freelancer(개인 사업자), daily worker(일용직)로 구성되어 있다. 각 분류에 따라 점수는 100, 70, 50, 20점으로 다르게 분배된다.

9. 소득은 연봉을 의미한다.

10. 대출 상품을 등록할 때는 상품명, 상품 구분, 상품 설명, 이율 등 고객들에게 제공할 정보들을 모두 입력해야 등록된다.

11. 대출 상품 삭제는 해당 상품 정보 가장 오른쪽에 위치해있는 삭제 버튼을 누르면 삭제되며, 만약 해당 권한이 없는 관리자가 누르게 되면 권한이 없다는 메시지가 나오게 된다.

<관리자_상환관리>

1. 고객의 대출 상환 추적 및 관리를 용이하게 한다.
2. 고객명, 상품 구분, 상품명, 대출 신청일, 마감기한, 잔액, 지난 날짜, 상환 상태 등의 고객들의 대출 상품 상환 내역을 조회할 수 있다.
3. 상품 종류에 따라 전체, 전세, 월세, 담보의 상품들을 선택하여 조회할 수 있다.
4. 상환 상태에 따라 전체, 상환중, 연체, 상환 완료 상품들을 선택하여 조회할 수 있다.
5. 상환 일정을 설정하고 이자를 계산하는 옵션을 제공한다.
6. 새로운 고객 상호 작용에 대해 관리자에게 알리는 알림 시스템을 구현한다.
7. 대출 상품 관리자(“managing Products”) 권한을 갖고 있는 관리자가 지불 금액 및 날짜를 ​​포함한 상환 정보를 기록하고 업데이트하도록 허용한다.
8. 모든 대출 상품들은 만기상환 이기 때문에 고객이 금액을 모두 상환을 했다면 관리자가 잔액 차감을 해줄 수 있다.
9. 상환 기한이 지나 연체가 되었다면 관리자는 연체 관리 버튼을 눌러 이자율이 업데이트 된다. 이자율은 매년 연체이자율에 맞춰 계산되어 갚아야 하는 잔액에 들어가게 된다.
10. 연체된 지불에 대한 경고 및 알림을 고객에게 제공한다.

<고객_홈>

1. 페이지 상단에 GNB가 제공된다.
   • 로고 클릭 시 사용자 홈으로 이동한다.
   • 조회, 이체, 금융상품 등 메뉴 클릭 시 해당 페이지로 이동한다. (대출 상품 버튼만 작동)
   • 로그아웃 버튼 클릭 시 로그아웃 되며 로그인페이지로 이동한다.
2. 광고 및 추천상품 표시영역에서 사용자 개인의 성향 및 서비스 이용 로그 분석을 통해 적절한 상품에 대한 광고 및 추천
   • 광고 및 추천상품이 좌->우 방향 슬라이드 효과와 함께 노출된다.
   • 클릭 시 해당 상품상세페이지로 이동한다.
3. 로그인한 계정의 요약 정보를 한 눈에 쉽게 볼 수 있는 회원정보영역이 제공된다.
   • 고객의 회원정보가 요약되어 노출된다.
   • 고객이 가입한 대출 상품의 대출 금액, 이자율, 상환 일정 및 대출 상태와 같은 세부 정보가 요약되어 노출된다.
4. 추천 서비스
   • 고객은 기입한 본인의 신용등급, 나이, 수입 등 개인정보와 같은 요소와 기록되는 행동로그를 기반하여 대출 상품을 추천 받을 수 있다.
   • 추천 알고리즘은 다음과 같다.
     • recommendations 테이블에서 최소 신용도 이상만 만족하면 top3개는 앞단에 노출
     • PV (Page Views)
       • PV 전체평균보다 높거나 income이 2400만원 미만 -> 5% 이상 추천
       • PV 전체평균보다 높거나 income이 2400만원 이상 -> 4% 이상 5% 미만 추천
       • PV 전체평균보다 낮거나 income이 2400만원 미만 -> 3% 이상 4% 미만 추천
       • PV 전체평균보다 낮거나 income이 2400만원 이상 -> 3% 미만 추천
     • 위 조건에서 도출된 상품을 제외하고 신용도만 맞다면 모두 노출

<고객_대출상품 목록페이지>

1. “전체”, “전(월)세”, “담보” 등 대출 상품 종류 별 Nav Bar가 노출되어 원하는 종류의 상품들을 조회 할 수 있는 편의 기능이 제공된다.
2. 해당 고객의 PV값을 1 누적시킨다.
3. 대출상품 목록이 제공된다
   • 상품의 상품명, 요약된 상품 상세정보가 노출된다.
   • 가입 신청을 원하는 상품을 클릭 시 해당 상품의 상세정보 페이지로의 이동 기능이 제공된다.

<고객_대출상품 상세페이지>

1. 특정 대출 상품에 대한 자세한 정보를 제공하는 페이지
2. 상품 상세 정보 표시 영역은 선택한 대출 상품에 대한 상세 정보를 표시해야 합니다. 여기에는 대출 상품의 모든 매개 변수, 약관, 자격 기준 및 기타 관련 정보가 포함되어야 합니다.
3. 대출 상품 표시 목록
   • 상품명: 대출 상품명
   • (연체)이자율: 대출 상품의 연간 이자율. 이는 고정 금리 또는 시장 상황에 따라 변경되는 변동금리일 수 있음.
   • 대출 기간: 대출 상환 기간. 이것은 몇 달 또는 몇 년으로 표현될 수 있습니다.
   • 대출 한도: 본 대출 상품으로 빌릴 수 있는 최대 금액입니다.
   • 자격 기준: 차용인이 대출 상품에 대한 자격을 갖추기 위해 충족해야 하는 기준. (최소 신용 점수, 최소 소득)
4. 아래 대출 신청 버튼을 누르면 신청서 폼으로 이동하게 된다.
5. 신청서에는 신청 상품 정보, 고객 정보를 확인할 수 있고, 하단에 대출 금액을 입력하면 대출 신청이 완료된다.
   • 대출 금액이 대출 한도를 넘으면 신청이 되지 않는다.
   • 고객의 신용 점수가 최소신용점수보다 낮으면 신청이 되지 않는다.
   • 한 명의 고객이 같은 대출 상품을 여러번 신청은 가능하지만 관리자페이지에서 제한된다.

🎓 배운점 & 🚀 느낀점

민새미

배운점

Git 의 새로운 협업 방식을 배울 수 있었습니다, MVC 패턴을 학습하며 어떻게 하면 더 간편하게 유지보수 할 수 있을지 고민하는 시간도 가질 수 있었습니다. 발표를 준비하면서 백엔드 단의 서버 학습과 배포에 관련하여 짧게나마 학습해 볼 수 있어서 좋았습니다!

아쉬운점

JSP와 서블릿에 대해 개념적으로 습득하지 못한 채로 프로젝트가 끝나는 것 같아 아쉽고, DB를 좀 더 다양하게 써보지 못해서 아쉬웠습니다.

---

성창호

배운점

Full Stack 개발 및 Git을 활용한 효율적인 협업 방법을 경험하고 배울 수 있었다. 아울러 미흡했던 MVC 구조 구현 및 백엔드 개발 실력을 향상 시키고 배울 수 있었다.

아쉬운점

프로젝트의 빠른 진행과 짧은 기간으로 인해 JSP의 개념적인 부분을 깊이 공부하지 못한 것이 아쉬웠습니다.

---

장주성

배운점

기존에 익숙했던 IDE와 프로그래밍 언어를 벗어나 새로운 환경에 적응하며 많은 것을 배울 수 있었습니다.

아쉬운점

프로젝트 위주로 진행하다보니 자바와 JSP에 대한 개념적인 공부를 할 시간이 부족했던 점이 아쉬웠습니다.

---

한성훈

배운점

GitFlow 협업 방식을 통한 협업을 경험하고 Git의 편리함을 느꼈습니다. 아울러 Redis의 개념을 정리하며 적재적소에서 활용할 수 있는 기회를 가졌습니다.

아쉬운점

전체적인 성능 테스트를 진행하지 못한 것이 아쉬웠습니다.