hwon-j / hpdp

SSAFY 9기 특화 프로젝트

💰한푼두푼(HPDP) 💰

프로젝트 기간: 2023.08.21 ~ 2023.10.06

---

서비스 소개

---

소셜 벤처에 후원해주세요! ❤ UCC보러가기 ❤

한푼두푼(HPDP)은 크라우드 펀딩을 활용한 소셜 벤처 자금 후원 서비스 플랫폼입니다.

일상에서 발생하는 끝전으로 당신이 관심을 가지는 기업과 프로젝트에 후원하세요.

서비스 특징

---

1. 계좌에서 발생하는 1,000원 미만 끝전이 매일 오후 10시에 자동으로 이체되어 포인트로 누적됩니다.

2. 누적된 포인트로 관심 있는 프로젝트를 후원합니다.

3. 가격 변동 위험 없는 자체 블록체인 토큰으로 후원 금액이 소셜 벤처에 전달되는 과정을 투명하게 관리합니다.

주요 기능

---

끝전 자동이체

• 자체 뱅킹 서비스를 구현하여 매일 오후 10시 끝전 자동이체 기능을 제공합니다.

• 끝전을 부담 없이 후원할 수 포인트를 모을 수 있도록 사용자의 참여를 유도합니다.

스마트 컨트랙트와 블록체인을 이용한 한푼두푼 코인

• 스마트 컨트랙트를 이용하여 크라우드 펀딩 로직을 구현했습니다.

• 프라이빗 네트워크를 구축하고 자체 토큰을 발행하여 원화와 토큰의 환율이 1:1로 고정되어 가격 변동 위험을 제거했습니다.

OpenAI API를 활용한 기업 정보 제공

• OpenAI(ChatGPT) API를 활용해 소셜 벤처에 대한 요약 정보를 제공합니다.

• 후원 주체는 대상 기업의 정보를 확인하고 소셜 벤처는 홍보 효과를 얻을 수 있습니다.

기능별 화면

계좌 등록

끝전 이체

알림 확인

후원 목록

후원 진행

후원 내역

기업 목록

관심 기업

쪽지 작성

블록체인 정보

기업 정산

---

사용한 외부 서비스

---

• OpenAI(ChatGPT) API

• Web3 API

시스템 아키텍쳐

---

ERD 다이어그램

---

문서 링크

---

• [팀 노션](Notion – The all-in-one workspace for your notes, tasks, wikis, and databases.)

• API 명세서

• 기능 명세서

Git-flow

---

• 기능 개발이 완료되면 feature branch를 develop branch로 merge한다.

• branch 규칙

master : 서버를 배포하는 branch

develop : 기능을 개발하는 branch

feature : 세부 기능을 개발하는 branch

• feature branch 이름 규칙

feature/[BC/BE/FE]/[기능]

ex) feature/BC/private-network

BC: blockchain

BE: backend

FE: frontend

commit conventions

[타입] 작업 내용(최대한 자세히) ex)[INIT] 초기화
- INIT: 초기화
- FEAT: 신규 기능 추가
- MODIFY: 기존 코드 수정
- DESIGN or STYLE: 코드 순서, CSS 등 개발된 기능에 영향을 미치지 않는 코드
- FIX: 버그 수정
- REFACTOR: 프로덕션 코드 리팩토링
- TEST: 테스트 코드 작성
- DOCS: readme, log 등 main 문서 수정
- REVIEW: 코드 리뷰 반영
- BUILD: 빌드
- BACKUP: 백업
- COMMENT : 주석 추가, 수정, 삭제
- FILE: 파일 추가, 수정, 삭제
- MERGE: 병합
- CHORE: 기타

JIRA 규칙

---

기준

- epic : 스토리들의 집합체, 스프린트가 필요한 작업 내용을 정의
    - 회원 관리
- story : 에픽의 Use Case, 사용자가 수행하는 행동과 목표 위주 기술
    - 회원 가입, 로그인
- task : 스토리에서 기술한 내용을 달성하기 위해 수행해야할 기술적인 업무
    - 회원 가입, 아이디 중복체크

[날짜] 이름

- 이슈 연결하기
- 컴포넌트 선택 [ BE | FE ]

폴더 구조

---

frontend
  ├── docker
  ├── assets
  ├── node_modules
  ├── public
  └── src
      ├── api
      ├── components
      ├── interface
      ├── pages
      ├── store
      ├── style
      │   ├─ css
      │   ├─ fonts
      │   └─ scss
      └── types

backend
└─ main
  ├─ config
  ├─ controller
  │  └─ member
  │     ├─ request
  │     |    └─ MemberReq
  |     └─ response
  │          └─ MemberRes
  ├─ service
  │  └─ member
  │     └─ MemberService
  │     └─ MemberQueryService
  │        # @ReadOnly 조회때 사용
  ├─ common # dao
  │  ├─ auth
  │  ├─ exception
  │  └─ util
  └─ model
     ├─ entity
     |  └─ Member
     └─ repository
        ├─ MemberRepository
        └─ MemberQueryRepository

팀원 소개

---

맡은 역할

이름	역할	설명
홍승준	백엔드, 블록체인 담당	Geth를 활용한 Private Networks 구축, Web3 API를 활용한 서버와 블록체인 네트워크의 통신, Solidity를 활용한 크라우드 펀딩 스마트 컨트랙트 구현, 포인트 API 구현
김정훈	백엔드 담당	Redis를 활용한 관심 기업 등록/삭제 기능, SSE API를 활용한 알림 구현, Spring Security + JWT + Redis 로그인 구현, 예외 처리(Customized Exception Handler) 설계, Fast API(뉴스 크롤링, openAI)
변영채	백엔드, 인프라 담당	펀딩 관련 CRUD API 구현, 자체 뱅킹 시스템 구현, 쪽지 API 구현, 기업 프로필 페이지 API 구현, EC2, Nginx, Docker-Compose를 활용한 배포, S3 연동
김웅서	프론트엔드 담당	공통 컴포넌트 개발, Auth 관련 기능 구현, Axios Interceptors와 Refresh Token을 이용한 JWT 관리, 토스페이먼츠 API를 활용한 결제 기능 구현, CSS 애니메이션 구현
박태규	프론트엔드, 블록체인 담당	Geth를 활용한 Private Networks 구축, Web3 API를 활용한 클라이언트와 블록체인 네트워크의 통신, 자체 뱅킹 서비스 구현, Redis를 활용한 관심 기업 등록/삭제 구현, SSE API와 Toast Library를 활용한 알림 구현
장혜원	프론트엔드 담당	초기 페이지 및 컴포넌트 설정, 펀딩 관련 API 연결 및 쪽지 API, Fast API, 블록체인 데이터 API 연결, 후원 및 기업 관련 디자인 및 CSS 구현