Club Reservation System

동아리방의 원활한 관리를 위한 실시간 예약, 예약 현황 뷰어(시간표)를 지원하는 시스템입니다.

목차

• 개요
• 배포 주소
• 주요 기능
• 업데이트 내역
• 설치 및 실행 방법

개요

• 프로젝트 이름: 동아리 예약 시스템

• 프로젝트 기간: 2023.11.08 ~ (현재)

• 프론트 개발 언어: HTML & JavaScript & CSS

• 웹서버 개발 언어: Python(Flask)
  

  개발 동기

   사람이 많은 동아리는 원활하게 동아리방을 사용하려면 예약을 해야하는 경우가 많았습니다. 하지만 대부분 기존의 SNS(카카오톡, 디스코드)의 기능을 이용해 댓글을 다는 식으로 예약이 운영되고 있었습니다.
  
   이 예약 방식은 댓글이 작성 순서대로 나열되기 때문에, 사용자가 원하는 시간이 이미 예약되었는지 확인하기 어려웠습니다. 공유 엑셀을 통해 예약 시스템을 만드는 시도도 있었으나 셀을 병합하거나 분리하는 과정이 어려워 실패한 케이스도 보았습니다.
  
   이러한 불편함을 해결하고자, 동아리 예약 시스템을 개발하게 되었습니다. 이 시스템은 실시간으로 간편히 예약이 가능하며, 예약 현황을 시간표 형태로 한눈에 볼 수 있습니다.

배포 주소

• http://ec2-3-37-161-221.ap-northeast-2.compute.amazonaws.com:5000/

주요 기능

• 시간표 뷰어: 사용 가능한 시간과 예약된 시간을 한눈에 파악합니다.
• 실시간 예약 기능: 사용자는 원하는 시간을 실시간으로 예약할 수 있습니다.
• 멘토링 예약 기능: 정기적 멘토링 예약을 위한 특별 기능을 제공합니다.

업데이트 내역

1.2.1 (2024.05.10) - Latest

• 버그 수정: 시간표 박스 표시 오류 수정

1.2.0 (2024.05.07)

• 디자인 변경: 메인 테마 컬러를 노란색으로 지정, 폰트 변경
• 예약 폼 UI 변경: 맨 위에 항상 배치되어있던 예약 폼을 모달로 변경하여 버튼을 누르면 나타나도록 변경

1.1.2 (2024.05.05)

• 수정: 새로고침 시 오늘 날짜로 가는 기능 삭제 (편할줄 알았는데 오히려 불편하다는 문의가 들어옴.)

1.1.1 (2024.4.14)

• 코드 리팩토링: 디버깅 코드 삭제, 파일 분리, 중복 코드 통합
• 로깅 추가: 서버의 로그를 파일에 출력하게끔 변경

1.1.0 (2024.04.10)

• 멘토링 예약 기능: 매 주 진행하는 멘토링 특성상 일일이 입력하기 번거로워 멘토링 기간과 요일, 시간을 입력하면 한번에 예약할 수 있는 기능
• 색깔로 일반 예약, 멘토링 구분: 일반 예약은 노란색, 멘토링은 파란색으로 구분되게끔 변경
• 버그 수정: 시간표 표시 오류 수정

1.0.0 (2023.11.10)

• 최초 배포
  
  

설치 및 실행 방법

Linux:

1. 패키지 설치

sudo apt-get install python3 python3-pip pkg-config python3-dev default-libmysqlclient-dev build-essential gunicorn

2. 프로젝트 복사

git clone https://github.com/qkrdpwls1223/Club-Reservation-System.git
cd Club-Reservation-System

3. 파이썬 라이브러리 설치

pip insatll -r requirments.txt

4. 데이터베이스 설정 파일 추가

.env 파일 생성

touch database.env
vim database.env (텍스트 편집기)

database.env 파일에 DB 설정값 입력

DATABASE_HOST='your_host'
DATABASE_USERNAME='your_db_username'
DATABASE_PASSWORD='your_db_pw'
DATABASE='your_db_name'

5. 실행

gunicorn -w 4 -b 0.0.0.0:5000 app:app --timeout=30