2022.11 ~ 2023.4

1) 프로젝트 소개 : 택배 시스템 등에서 사용하기 위해서 (쿠콘)가상계좌로 입금을 받는 시스템
- 택배기사, 대리점주, 가맹점 본사 등에서 가상계좌를 통해서 입.출금 하는 관리 프로그램

2) 작업 범위 : 개발에 참여한 범위 및 지원환경
- 서버 구축: Spring boot with Tomcat8 Server, Front-end 개발: JsBuilder, shammy, 관리자 페이지 개발

3) 주요 업무 : 해당 서비스의 주요 기능 및 주요 페이지
1. 로그인
로그인: /api/v1/login
로그아웃: /api/v1{login_seq}/logout
비밀번호 재설정: /api/v1/login/{login_seq}/reset
OTP 1단계 등록: /api/v1/otp/reg
OTP 2단계 인증: /api/v1/otp/auth
OTP 3단계 초기화: /api/v1/otp/init
OTP 본사의 초기화: /api/v1/otp/init/{office_seq}
OTP 등록된 사용자 확인: /api/v1/otp/valid/{office_seq}

2. 하부관리
페이징 리스트: /api/v1/office/{login_seq}/{start_pos}/{page_size}
프로필 자세히보기: /api/v1/office/{office_seq}/detail
출금 한도설정: /api/v1/office/{office_seq}/limit
입금 한도설정: /api/v1/office/{office_seq}/deposit/limit
하부생성: /api/v1/office/{login_seq}/sub
출금하기 > 계좌주 조회: /api/v1/office/detail/{login_seq}/account
출금하기 > 출금하기: /api/v1/office/detail/{login_seq}/withdraw
출금하기 > 자주쓰는 계좌등록/조회/삭제: post/get/delete 로 동일 url 사용
/api/v1/office/detail/{login_seq}/account/favorites
부본사 권한설정: /api/v1/office/detail/{office_seq}/bo-right
수수료 수정: /api/v1/office/{office_seq}/detail/comm
개별수수료 수정: /api/v1/office/{office_seq}/detail/indi-comm
권한수정: 운영여부, 가상계좌정지, 출금정지, 회원생성, 다중접속, 본사 출금승인
/api/v1/office/{office_seq}/detail/right/operate
/api/v1/office/{office_seq}/detail/right/v-account
/api/v1/office/{office_seq}/detail/right/withdraw
/api/v1/office/{office_seq}/detail/right/create-member
/api/v1/office/{office_seq}/detail/right/multi
/api/v1/office/{office_seq}/detail/right/appd-wd
출금승인 요청하기: /api/v1/office/detail/{login_seq}/withdraw/request
출금승인 내역 리스트:
/api/v1/office/detail/{login_seq}/withdraw/request/{start_pos}/{page_size}
출금승인 승인,거부: /api/v1/office/{login_seq}/withdraw/approval

3. 회원관리
회원 리스트: /api/v1/member/{login_seq}/{start_pos}/{page_size}
하위 office list: /api/v1/member/{office_seq}/child
회원생성: /api/v1/member/{login_seq}/member
계좌주조회(하부관리의 계좌주 조회와 동일): /api/v1/member/{login_seq}/account/verify
회원 프로필 자세히보기: /api/v1/member/{login_seq}/member/detail/{member_seq}
가상계좌 생성, 삭제: post, delete 로 구분
/api/v1/member/{login_seq}/member/detail/{member_seq}/v_account
계좌정보 변경: /api/v1/member/{login_seq}/member/detail/{member_seq}/account
메모변경: /api/v1/member/{login_seq}/member/detail/{member_seq}/memo
닉네임변경: /api/v1/member/{login_seq}/member/detail/{member_seq}/nickname
운영여부 및 가상계좌사용 수정:
/api/v1/member/{login_seq}/member/detail/{member_seq}/right

4. 정산관리
정산내역 리스트: /api/v1/adjust/adjust/{login_seq}/{start_pos}/{page_size}
회원입금내역 리스트: /api/v1/adjust/deposit/{login_seq}/{start_pos}/{page_size}
하부출금내역 리스트: /api/v1/adjust/withdraw/{login_seq}/{start_pos}/{page_size}
본사의 기본 정산 정보 얻기(화면 우상단 표시): /api/v1/adjust/{login_seq}/basic

5. 출금승인
출금승인 요청하기: /api/v1/office/detail/{login_seq}/withdraw/request
요청내역 리스트: /api/v1/office/detail/{login_seq}/withdraw/wait/{start_pos}/{page_size}
출금승인 승인, 거절: /api/v1/office/{login_seq}/withdraw/approval

6. 수정내역
하부 수정로그 리스트: /api/v1/office/history/{login_seq}/{office_seq}/{start_pos}/{page_size}
회원 수정로그 리스트:
/api/v1/member/history/{login_seq}/{member_seq}/{start_pos}/{page_size}

7. 실명인증
실명인증 가상계좌 인증: /api/v1/extern/v-account/{v_bank_cd}/{v_account}
실명인증 사용자 정보 조회
http://127.0.0.1:8080/rna_svc/Listener
{ io_kind: "real_info_req",mobile_tel: "휴대폰번호" }
{ io_kind: "va_info_req", v_bank_cd: "가상계좌 은행코드", v_account: "가상계좌번호" }
실명인증 회원정보 업데이트: 실명인증 서버에서 pl/python 트리거로 동작시킨다.
/api/v1/member/match

8. 잔액이동
잔액이동 리스트: /api/v1/move/{start_pos}/{page_size}
office 리스트: /api/v1/move/office
office 정산잔액: /api/v1/move/{office_seq}/remain
잔액이동: /api/v1/move/transfer

9. 기본요율설정
기본요율 리스트: /api/v1/office/basic-rate/{start_pos}/{page_size}
기본요율 수정, 삭제: post, put, delete 로 사용
/api/v1/office/basic-rate/{bc_seq}
기본요율 추가: /api/v1/office/basic-rate

10. 공지사항
공지사항 리스트: /api/v1/notice/noti/{start_pos}/{page_size}?level=중요도(숫자)
공지사항 글쓰기, 수정: post, put 으로 사용
/api/v1/notice/noti/{login_seq}
FAQ 리스트: /api/v1/notice/faq/{start_pos}/{page_size}
FAQ 글쓰기, 수정: post, put 으로 사용
/api/v1/notice/faq/{login_seq}
공지사항 & FAQ 웹소켓 자료구조: 신규, 변경 발생시 websocket 으로 내용 전달
접속주소: ws://server_ip:8080/moon/ws/noti

11. 검색
office 이름 검색: /api/v1/search/office

12. 외부연계: 쿠콘의 예금주조회, 출금, 가상계좌확인, 가상계좌입금 후처리 기능 및 임시계좌정리
예금주 조회: url prefix 가 coocon 으로 moon 서비스와 다르다.
/api/v1/extern/account
모계좌 적립수수료 출금: url prefix 가 coocon 으로 moon 서비스와 다르다.
/api/v1/extern/withdraw
가상계좌 존재여부: /api/v1/extern/v-account/{v_bank_cd}/{v_account}
가상계좌 입금 후 정산: url prefix 가 coocon 으로 moon 서비스와 다르다.
/api/v1/extern/deposit



4) 주안점 : 개발 시 중점이 되었던 사항
- 가상계좌 입.출금의 원할한 진행으로 프로그램 기본에 얼마나 충실한지가 중요한 주제였다.