1. 문서 개요

• 문서 목적:

  본 문서는 [아주 먼 옛날 프로젝트]의 요구사항 정의서를 기반으로 시스템 개발에 필요한 전반적인 사항(기능, 성능, 인터페이스, 보안 등)을 상세하게 명세하여 개발, 테스트, 배포, 유지보수에 참고할 수 있도록 작성됨.

• 문서 버전 및 이력:

  버전	작성일	작성자	주요 변경사항
  1.0	2025-02-20	김형표	최초 작성

2. 시스템 개요

• 프로젝트 개요:

  [아주 먼 옛날]은 WebRTC 기술을 기반으로 사용자들이 만드는 이야기를 실시간으로 이미지를 생성해서 책을 한 권 만들어주는 웹 게임 서비스입니다.

• 게임 Rule :

  1. 모든 유저는 10점의 포인트와 4장의 이야기 카드, 1장의 결말 카드를 가진다.

  이야기 카드는 '소녀', '비밀통로', ‘거대함' 과 같은 단어 카드들이다. 결말 카드는 ‘그들을 보면서 그는 커피를 마시며 구경했습니다.’와 같은 문장 카드들이다. 2. 자신의 턴에 자신이 소지한 카드 중 하나를 선택하여 이야기를 만들 수 있습니다. ex) 한 ‘소녀’가 살았습니다 3. 다음 사람은 그 전 사람의 이야기와 개연성에 맞게 이야기를 만들어야 합니다. ex) 그 소녀는 정말 예뻤습니다 4. 이야기를 만들 때마다 개연성이 있는지를 투표로 판단합니다. 5. 투표가 반대가 나오거나 제한 시간 안에 이야기를 만들지 못하면 점수가 깎이고, 이야기를 만들어내면 점수를 얻습니다. 6. 결말 카드를 내면 대량의 점수를 받을 수 있습니다.

3. 기능 명세

아래 기능별 상세 명세는 요구사항 정의서의 각 항목을 기반으로 작성되었습니다.

3.1 게임 데이터 관리

• 기능 설명:

  게임 시작, 게임 종료, 게임 내 플레이어들의 상태 변화 관리

• 세부 기능:

  • 게임 시작:
    • 게임 시작 시 게임에 참여한 모든 유저들에게 이야기 카드 4개와 결말 카드 1장을 분배함
    • 카드 분배 시 카드 내용을 셔플해서 줌. (게임 인스턴스마다 다른 카드 목록 제공)
  • 게임 종료:
    • 게임 종료 시 AI 모델이 책 표지와 제목을 생성해줌
    • 지금까지 만들어진 장면 데이터를 모두 DB에 저장하고 이미지들도 S3에 업로드.
    • BOOK 객체를 만들고 Redis로 관리되던 장면 데이터들은 삭제 처리
  • 결말 카드 리롤 기능:
    • 결말 카드는 3번 리롤을 돌릴 수 있음

• 에러 및 예외 처리:

  • 자신이 소유한 카드를 상대방이 몰라야 하기 때문에 방장이 게임 시작 요청을 보내면 응답으로 방장의 카드 상태만 보내게 됨.
  • 나머지 유저들은 방장에게 트리거를 받고 자신이 분배 받은 카드 조회 요청을 보내서 각자의 카드 정보를 받을 수 있음.
  • 카드 조회 요청을 받았을 때 존재하는 게임 ID인지, 그 게임 내에 존재하는 유저 ID 인지를 검증

3.2 장면 생성

• 기능 설명:

  장면 생성, 장면 삭제

• 세부 기능:

  • 장면 생성:
    • 인게임 내에서 사용자들이 만든 장면들을 Redis로 관리
    • 이미지 생성 모델이 실시간으로 이미지를 생성해서 백엔드 서버에 보내주기 때문에 이를 Redis에 저장하기 위해 바이너리 데이터로 저장
    • Redis로 관리하기 때문에 접근 속도 향상
    • 후에 투표 반대 시는 장면 데이터를 삭제해야 하므로 임시 저장소로 Redis에서 관리 (게임 종료 시 DB에 저장)
  • 장면 삭제:
    • 투표 반대 시 그 장면은 장면 목록에서 삭제 돼야함
    • Redis에서 관리하던 장면 데이터에서 해당하는 장면을 삭제 (장면을 생성하는데 사용된 카드도 삭제되지 않음)
    • 투표 찬성 시 사용된 카드를 사용자가 소유한 카드 목록에서 삭제함

• 에러 및 예외 처리:

  • 게임 ID, 유저 ID 검증, 장면 삭제 요청 시 해당 게임에 생성된 장면이 있는지 검증 (없다면 잘못된 요청)

3.3 책 관리