미니 프로젝트 (1/24 ~ 1/26)
교육과정에서 스프링 MVC 및 Mybatis(SQL Mapper Framework)를 마무리 하고 과제의 성격으로 미니 프로젝트를 진행하게 되었다. 그리고 어쩌다 보니 이 프로젝트에서 조장을 맡게 되었다. 3일이라는 기간이 주어진다고 하였고, 거기다 일정이 넉넉하지 않아 완전한 애플리케이션을 완성시키기에는 무리가 있을 것으로 판단, 조원들과 프로젝트가 시작되기 전에 몇 차례 회의를 진행하게 되었다.
1차 회의 - 프로젝트 주제 선정
미니 프로젝트 고려사항
- 일단 시간이 짧다, 문제가 생겨서 해결하지 못하면 엎어질 가능성이 다분하다. 최대한 단순한 주제로!!
- 도메인과 계층을 명확하게 구분하여 코드를 작성하도록 노력하고(Higher Coherence, Loose Coupling) 효율적으로 각자의 역할을 할 수 있도록 한다
- 가급적 과정에서 배운 내용에서 벗어나지 않도록
위의 고려사항을 만족하며 팀원들과 상의하게 된 프로젝트 주제가 마니또 애플리케이션,
이 주제를 선정하게 된 근거는 우선 마니또라는 게임이 모두가 직관적으로 이해하기 쉽다고 생각해서였고, 또한 단순히 게시판을 구현하는것 보다는 누군가가 호기심을 가질만한 서비스를 이번기회에 만들어 볼 수 있으면 어떨까 하는 의견에 모든 조원들이 동의하였다.
2차 회의 - 프로젝트 개념 구체화 및 명세서 작성
다음 회의에서는 마니또 서비스라는 것을 어떻게 구체화 할 것 인지에 대해 이야기 하였고, 부가적인 기능을 제외한 필수 기능들에 대한 명세를 작성하게 되었다.
프로젝트 공유 GitHub Public Repository
- 프로젝트 공유자 : 박종현
- url : https://github.com/zezeg2/manitto
- 팀 멤버
개발환경
- JDK : oracle-jdk17
- Spring Boot : Spring Boot 3.0.1
- 관계형 데이터베이스 : Maria DB
- 데이터베이스 클라이언트 : 자유선택
- IDE : STS4 / IntelliJ
- 프론트엔드 : JSP, AJAX를 통한 브라우저 - REST-API 서버 통신
마니또 애플리케이션이 제공하는 서비스
- 마니또 서비스에 가입하면 회원들 중 임의로 매칭이 발생한다
- 매칭은 N쌍의 마니또가 매칭이 발생하며 애플리케이션이 실행되는 시점 혹은 매일 특정한 시간에 갱신된다
- 매칭이 갱신되면 모든 유저들은 익명의 이름이 갱신되고, 익명의 이름이 서로에게 노출된다.
- 관리자에 의해 매칭에 대한 Action(Mission, Reward, Penalty)이 등록된다
- 마니또로 매칭되게 되면 Receiver는 새로운 매칭이 발생하기 전에 누가 자신의 마니또인지 맞춰야 하고, Contributor는 주어진 미션을 수행해야 한다.
- 매칭은 하나의 포스트 처럼 간주되어 익명의 이름으로 모든 사용자들이 코멘트를 남기며 소통할 수 있다.
- 사용자의 역할에 따라 동적으로 페이지를 로드하여 재미요소를 추가한다.
테이블 설계
- ERDiagram
- schema.sql
create table user ( id int primary key auto_increment, username varchar(30) unique not null, password varchar(255) not null, name varchar(30) not null, email varchar(30) unique not null, random_name varchar(30) default null, role varchar(30) default 'none' not null, aware_role boolean default false not null, prev_contributor boolean default false not null, prev_receiver boolean default false not null, is_admin boolean default false not null ); create table `match` ( id int primary key auto_increment, title varchar(255) not null, match_ymd date default now() not null, round int not null, `status` varchar(100) default false not null, result boolean default null ); create table user_match ( id int primary key auto_increment, user_id int not null, match_id int not null, is_contributor boolean default false not null, is_receiver boolean default false not null, constraint foreign key (user_id) references user (id), constraint foreign key (match_id) references `match` (id) ); create table action ( id int primary key auto_increment, type varchar(100) not null, match_id int not null, task text not null, recommendation int default 0 not null, constraint foreign key (match_id) references `match` (id) ); create table comment ( id int primary key auto_increment, user_id int not null, match_id int not null, writer varchar(30) not null, content text not null, write_at datetime default now() not null, edited boolean default false not null, constraint foreign key (user_id) references user (id), constraint foreign key (match_id) references `match` (id) );
Pages
- Index Page (”/”)
- 로그인, 회원가입 폼
- Main Page (”/user/main”)
- admin User : Action 등록, 전체 회원 정보 조회
- common : 역할 확인(세션), 매치 리스트 쿼리
- contributor : 액션(Mission)리스트 쿼리
- receiver : 마니또 정답 맞추기(유저 리스트 쿼리)
- 정답 시 액션(Reward) 쿼리
- 오답 시 액션(Penalty) 쿼리
- Match Detail ( (”/user/match-detail/{matchId}”))
- 댓글 작성 폼, 댓글 리스트
Scheduler
- 매칭 Generation → 애플리케이션 실행시(Fixed Delay), 매일 9시(Cron)
- 기존 매칭 아카이빙(active → archive)
- 유저 역할 초기화
- 유저 역할 재할당 , 매칭 활성화(wating → activate) 새로운 UserMatch 생성
- 대기상태 매치 생성
REST API
- User
("/api/user")MethodName ReturnType ArgsType Method Mapping 유저생성 registerUser void User.CreateDto createDto POST / 로그인 login void User.AuthDto authDto POST /login 로그아웃 logout void GET /logout 유저 정보리스트 getUserInfoList List<User.InfoDto> GET /list 유저 정보 확인 getUserInfo User.InfoDto long id GET /{id} - Match
("/api/match")MethodName ReturnType ArgsType Method Mapping 활성상태 매치 정보리스트 getMatchListActive List<Match.InfoDto> GET /list - UserMatch
("/api/user-match")MethodName ReturnType ArgsType Method Mapping 유저-매치 정보리스트 getUserInfoList List<UserMatch.InfoDto> GET /list - Action
("/api/action")MethodName ReturnType ArgsType Method Mapping 액션 생성 createAction void Action.CreateDto createDto POST / 미션 정보리스트 getMissionList List<Action.InfoDto> GET /mission-list - Comment
("/api/comment")MethodName ReturnType ArgsType Method Mapping 댓글 생성 registerUser void Action.CreateDto createDto POST / 댓글 정보리스트 login List<Comment.InfoDto> POST /login
Result(1/27)
src 디렉터리 구조
. ~/IdeaProjects/manitto/src main ❯ tree --gitignore 14:07:27
├── main
│ ├── java
│ │ └── com
│ │ └── example
│ │ └── manitto
│ │ ├── ManittoApplication.java
│ │ ├── apicall
│ │ │ └── NicknameApiService.java
│ │ ├── common
│ │ │ ├── Constants.java
│ │ │ └── LoginSessionManager.java
│ │ ├── controllers
│ │ │ ├── mvc
│ │ │ │ ├── IndexPageController.java
│ │ │ │ └── UserPageController.java
│ │ │ └── rest
│ │ │ ├── ActionApiController.java
│ │ │ ├── CommentApiController.java
│ │ │ ├── MatchApiController.java
│ │ │ ├── UserApiController.java
│ │ │ └── UserMatchApiController.java
│ │ ├── dtos
│ │ │ ├── Action.java
│ │ │ ├── Comment.java
│ │ │ ├── Match.java
│ │ │ ├── User.java
│ │ │ └── UserMatch.java
│ │ ├── repositories
│ │ │ ├── ActionRepository.java
│ │ │ ├── CommentRepository.java
│ │ │ ├── MatchRepository.java
│ │ │ ├── UserMatchRepository.java
│ │ │ └── UserRepository.java
│ │ └── services
│ │ ├── ActionService.java
│ │ ├── CommentService.java
│ │ ├── MatchService.java
│ │ ├── SchedulerService.java
│ │ ├── UserMatchService.java
│ │ └── UserService.java
│ ├── resources
│ │ ├── application.yaml
│ │ ├── draft
│ │ │ ├── page-structure.drawio
│ │ │ └── schema.drawio
│ │ ├── mybatis
│ │ │ ├── mappers
│ │ │ │ ├── action-mapper.xml
│ │ │ │ ├── comment-mapper.xml
│ │ │ │ ├── match-mapper.xml
│ │ │ │ ├── user-mapper.xml
│ │ │ │ └── usermatch-mapper.xml
│ │ │ └── mybatis-config.xml
│ │ └── sql
│ │ ├── data.sql
│ │ └── schema.sql
│ └── webapp
│ ├── WEB-INF
│ │ └── views
│ │ ├── admin.jsp
│ │ ├── frame
│ │ │ ├── common.jsp
│ │ │ ├── footer.jsp
│ │ │ └── header.jsp
│ │ ├── index.jsp
│ │ ├── login.jsp
│ │ ├── main.jsp
│ │ ├── match-detail.jsp
│ │ ├── match-list.jsp
│ │ ├── register.jsp
│ │ └── role-check.jsp
│ └── static
│ ├── images
│ │ └── logo.png
│ └── js
│ ├── comment.js
│ ├── index.js
│ ├── login.js
│ ├── main.js
│ ├── match-detail.js
│ ├── register.js
│ └── role-check.jsIndex Page
- login
- register
MainPage
- receiver
- contributor
- none
- match-detail
프로젝트 후기
매번 생각하지만 키보드에 손을 올리는 것 보다 50000배 더 중요한 것이 구현하고자 하는 아이디어를 구체화 하는 것이라고 느끼게 되었고, 철저하게 책임을 분리하되, 유기적으로 코드 공유가 가능하도록 팀원과의 소통을 통해 양식과 규칙을 수립하는것이 중요하다고 느끼게 되었음. 프로젝트 기간도 짧았고, 예상한 것 보다 서비스 로직이 더 복잡했던 탓에 힘들기도 했지만 기술적인 부분이나 노하우를 공유할 수 있어 의미있었고 열정을 다했기 때문에 즐거웠던 프로젝트였습니다.
