🧑‍🧑‍🧒🙋📞 GAMO

안녕하세요. 시니어 맞춤 가족 소통 서비스 가모(GAMO)의 Spring Boot Backend & Frontend 통합 레포지토리입니다.
[2025 성신여자대학교 융합캡스톤디자인 프로젝트]

🤦‍♀️ 팀원 소개

Team Member	Team Member	Team Member	Team Member
홍유진 편지 퍼블리싱, STT·SSE, 편지 API	이지원 영상통화·기록 UI 및 API, 녹음·STT API	이채현 앨범 퍼블리싱, 앨범 API	김시영 회원·가족 UI, 소셜 로그인·JWT, FE 레이아웃

📚 목차

1. 프로젝트 소개
2. 기술 스택
3. 서비스 아키텍처
4. 프로젝트 구조
5. Git 협업 규칙

✨ 프로젝트 소개

프로젝트 목표

소셜 기능

---

홈 화면

---

가족 기능

---

편지 기능

---

영상통화 기능

---

앨범 기능

🎦 GAMO 데모 영상

https://www.youtube.com/watch?v=aL9ShCryn3M

🛠 기술 스택

Front-end

Infra & Back-end

구분	기술
Language	Java,Python
Framework	Spring Boot, FastAPI
Database	MySQL, JPA
Infra	GCP, Nginx
CI/CD	Jenkins
Auth	JWT, Spring Security
기타	OAuth, WebSocket, SSE, WebRTC, Google Cloud Storage
외부 API	Google Speech To Text, Gemini API
frontend	TailWindCss, HTML, Javascript, Thymeleaf

⛏️ 서비스 아키텍쳐

📁 프로젝트 구조

Spring 레포지토리 폴더 구조

src
├── frontend/                  # 프론트엔드 코드 (JS, CSS, Node 모듈)
│   ├── main.css               # 전역 스타일
│   ├── node_modules/          # 설치된 라이브러리
│   └── 각종 패키지별 서브 모듈
│
├── java/                      # 백엔드 코드
│   └── gamo/web/
│       ├── WebApplication.java 
│       ├── auth/              # 인증 관련
│       ├── common/            # 공통 유틸, 설정
│       ├── family/            # 가족 관련 기능
│       ├── home/              # 홈 화면 관련
│       ├── letter/            # 편지 기능
│       ├── member/            # 회원 관리
│       ├── photo/             # 사진/앨범 관리
│       └── videocall/         # 영상 통화 기능
│
├── resources/                 
│   ├── application.yml         # Spring 설정
│   ├── application-secret.properties 
│   ├── google-service-account.json   
│   ├── static/                # 정적 리소스(js, css, svg)
│   └── templates/             # Thymeleaf 템플릿
│       ├── fragments/         # 공통 레이아웃/모달
│       ├── login.html
│       └── pages/             # 기능별 페이지
│
├── package.json              
├── package-lock.json          
├── postcss.config.js          
└── tailwind.config.js         # Tailwind CSS 설정

📍 Git 협업 규칙

• develop 브랜치에 직접 commit/push 금지
• 작업 전 반드시 issue 작성 후 Pull Request 연동
• Pull Request는 2명 이상 코드 리뷰 후 merge
• 기능 개발 시:
  • develop → feature/기능 브랜치 생성
  • 기능 개발 완료 → PR 생성 → 리뷰 후 develop merge