Skip to content

azure0929/schoolmate

 
 

Repository files navigation

🏫 SCHOOLMATE 프로젝트

🚀 프로젝트 개요

SCHOOLMATE는 학생들의 학교생활 만족도와 행복감 저하 및 참여형 동기/콘텐츠 부족 문제를 해결하기 위해 기획된 학생 참여형 웹 서비스입니다.

학교 활동(출석, 급식 등)에 '포인트'와 '보상'을 도입하여 활동으로 쌓은 포인트를 다양한 '상품'으로 교환하게 함으로써 학교생활의 재미와 성취감을 높이는 것을 목표로 합니다. 또한, 종이 알림장을 대체하여 간편하게 학교 정보를 조회할 수 있는 기능도 제공합니다.



✨ 주요 기능 및 특징

1. 학생 활동 기반 포인트 및 보상 시스템

  • 출석 체크를 통해 포인트 지급 및 출석 현황을 관리합니다.
  • Google Cloud Vision AI를 활용하여 급식 사진을 분석하고, 업로드를 통해 포인트를 적립합니다.
  • 쌓은 포인트로 CUGS25 등의 다양한 상품 교환이 가능합니다.
  • 포인트 현황 (적립 및 차감) 및 상품 교환 내역을 조회합니다.

2. 학교 정보 조회 및 관리

  • NEIS API 연동을 통해 학교 기본 정보, 학과 정보, 학급 정보 등을 조회합니다.
  • NEIS API를 통해 급식 식단 정보학사 일정을 제공합니다.
  • 시간표 (초/중/고) 정보를 제공합니다.
  • 일정 관리 페이지를 제공합니다.

3. 사용자 및 관리자 기능

  • 일반 및 소셜 로그인을 지원합니다.
  • 관리자 페이지를 통해 학생 관리상품 관리 (등록, 수정, 삭제) 기능을 제공합니다.


🗓️ 프로젝트 기간

구분 시작일 종료일
착수 (주제 선정) 2025.08.26 2025.08.29
분석 (요구사항 정의, UseCase) 2025.08.29 2025.09.05
설계 (FrontEnd, DB, Class Diagram 등) 2025.09.05 2025.09.22
구현 (FrontEnd/BackEnd, 외부 API 연결) 2025.09.12 2025.10.09


🛠️ 아키텍처 및 기술 스택 (Tech Stack)

아키텍처 구성

계층 구성 요소 설명
FrontEnd React, styled-components, JS, GSAP, Swiper, AXIOS 사용자 인터페이스 및 상호작용 담당 (Port: 3000)
BackEnd Spring Boot 비즈니스 로직 처리 (Port: 9000)
AI & API Google Vision API, NEIS API (나이스 교육 정보 개방 포털) 외부 API 연동 및 AI 이미지 분석
Cloud & DB Google Cloud, Firebase, MySQL 데이터베이스 및 클라우드 서비스
CI/CD GitHub Actions, Google Cloud Build, Docker, Artifact Registry, Google Cloud Run 자동화된 빌드 및 배포 파이프라인 구축


기술 스택 상세

구분 기술 버전 및 설명
FrontEnd React 19.1.1
GSAP 3.13.0 (애니메이션)
Styled-components 6.1.19
BackEnd Spring boot Intellij, Spring Security 포함
API 및 AI Google Vision API, NEIS API
CI/CD 및 배포 Github Actions, Docker, Google Cloud Run, Vercel
협업 도구 Figma, Jira, Github


📌 개발 팀원 및 역할

양준용 장영민
양준용 (팀장) 장영민
1. 디자인 및 프론트 레이아웃 설계
2. 소셜 로그인 구현
3. Google Cloud Vision AI 연동
- 메인페이지(급식 사진 업로드)
4. Firebase
- 메인페이지(급식 사진 업로드)
- 관리자 페이지(상품 관리)
- 마이페이지(프로필 관리, 활동 기록)
5. 포인트 샵(상품 교환)
6. 포인트 현황(적립 및 차감)
7. 출석(포인트 지급, 출석 현황)
8. 관리자 페이지(학생 관리)
1. 디자인
2. 로그인 및 회원가입 구현
3. NEIS API 연결
- 학교 정보
- 학과 정보
- 학급 정보
- 급식 식단 정보
- 학사 일정
- 초/중/고 시간표
4. 마이페이지(회원 정보 수정)
5. 일정 관리 페이지

About

스쿨메이트

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 98.9%
  • Other 1.1%