RaonNuri_Public_Documents/FUNCTIONAL_DESCRIPTION.md
2026-02-02 00:13:13 +00:00

8.3 KiB

라온누리 플랫폼 - 기능 명세서

1. 개요 (Introduction)

이 문서는 라온누리 플랫폼의 주요 페이지와 기능에 대한 상세 명세서입니다. 플랫폼의 구성 요소와 각 페이지의 핵심 기능을 객관적으로 설명합니다.

2. 공용 페이지 (Public Pages)

2.1 랜딩 페이지 (/)

목적: 비로그인 사용자에게 서비스 정보를 제공하고 회원가입 및 로그인을 지원합니다. 주요 기능:

  • 메인 섹션: 서비스 소개 문구와 로그인/회원가입 버튼, 팀 코드 입력(학생용) 버튼을 제공합니다.
  • 로그인: 개인 계정 로그인과 단체(팀) 로그인을 분리하여 지원합니다.
  • 기능 안내: 글쓰기, 습관 관리, 보상 시스템 등 주요 기능을 아이콘과 텍스트로 설명합니다.
  • 이용 가이드: 서비스 사용 절차를 단계별로 안내합니다.
  • 다국어 지원: 한국어, 영어, 일본어 언어 변경 기능을 제공합니다.

2.2 요금제 페이지 (/pricing)

목적: 서비스 구독 플랜 정보를 제공하고 결제를 처리합니다. 주요 기능:

  • 플랜 정보: Free, Classroom, Academy, School 등 4가지 등급별 요금제와 혜택을 비교하여 표시합니다.
  • 결제 주기: 월간 결제와 연간 결제 옵션을 제공하며, 연간 결제 시 할인율을 표기합니다.
  • 기능 비교표: 팀 생성 수, AI 크레딧, 멤버 수 제한 등 플랜별 상세 스펙을 표 형태로 제공합니다.
  • 구독 관리:
    • 플랜 변경(업그레이드/다운그레이드) 시 잔여 기간에 대한 크레딧 계산 및 안내 기능을 제공합니다.
    • 결제 확인 및 처리 프로세스를 포함합니다.

3. 핵심 서비스 (Writer's Hub)

3.1 홈 / 대시보드 (/home)

목적: 로그인 사용자의 메인 화면으로, 주요 기능 접근 및 활동 요약을 제공합니다. 주요 기능:

  • 사용자 정보: 사용자 이름과 환영 메시지를 표시합니다.
  • 빠른 실행 (Quick Actions): 새 글쓰기, 패턴 분석, 팀 관리 등 자주 사용하는 기능으로 바로 이동하는 바로가기 버튼을 제공합니다.
  • 활동 요약: 최근 작성한 글 목록을 표시하여 최근 작업에 빠르게 접근할 수 있도록 합니다.
  • 글쓰기 패턴 분석 (통계 보고서): 사용자의 누적된 글쓰기 데이터를 분석하여 시각화된 리포트를 제공합니다.
    • 학습 습관 분석: 글쓰기 빈도, 평균 분량, 선호하는 주제 등 창작 활동 패턴을 요약합니다.
    • 자기 주도적 피드백: 데이터 기반의 객관적인 지표를 통해 자신의 성장 과정을 파악할 수 있습니다.

3.2 글쓰기 허브 (/write)

목적: 글쓰기 모드를 선택하고 창작 활동을 시작하는 페이지입니다. 주요 기능:

  • 글쓰기 모드 선택 (2x3 방식): 시작 방식 2가지와 도움 단계 3가지를 조합하여 총 6가지 글쓰기 방식을 제공합니다.
    • 시작 방식:
      • 이미지 기반: 이미지를 먼저 업로드하고 관련 내용을 작성합니다.
      • 텍스트 기반: 주제를 정하고 텍스트로 작성을 시작합니다.
    • 도움 단계:
      • AI 초안 (빈칸 채우기): AI가 생성한 초안의 빈칸을 채우는 방식입니다.
      • AI 힌트: AI가 문장이나 표현을 제안하여 작성을 돕는 방식입니다.
      • 혼자 쓰기: AI 도움 없이 직접 작성하는 방식입니다.
  • 영감 피드:
    • 팀 활동 피드: 소속 팀원의 최근 활동 내역과 추천 글감(주제)을 표시합니다.
    • 동료 학습 갤러리 (Reference): 동일한 주제로 다른 팀원들이 생성한 이미지를 갤러리 형태로 조회합니다. 타인의 해석을 참고하여 다양한 관점을 학습하고, 창작의 실마리를 얻을 수 있는 시각적 참고 자료를 제공합니다.
  • 라우팅 처리: 이전 작업 내역이나 URL 파라미터에 따라 적절한 에디터 화면으로 자동 연결합니다.

3.3 글 목록 (/writing)

목적: 사용자가 작성한 글을 목록 형태로 조회하고 관리합니다. 주요 기능:

  • 목록 조회: 작성한 글을 카드 형태의 그리드 레이아웃으로 표시합니다.
  • 정렬 및 필터: 최신순/과거순 정렬 기능을 제공합니다.
  • 관리: 개별 글을 삭제하거나 상세 페이지로 이동할 수 있습니다.

3.4 이미지 업로드 및 생성 (/imageUpload)

목적: 작성된 글에 이미지를 추가하거나 AI로 생성합니다. 주요 기능:

  • AI 이미지 생성:
    • 글 내용을 분석하여 적합한 장면(Scene)을 추출 및 추천합니다.
    • 선택한 장면을 기반으로 이미지를 생성합니다. (사용자 플랜에 따라 제한됨)
  • 이미지 업로드: 사용자의 로컬 이미지를 업로드할 수 있습니다.
  • 이미지 수정: 기존에 생성하거나 업로드한 이미지를 변경할 수 있습니다.

3.5 인터랙션 스튜디오 (/interaction)

목적: 이미지에 반응형 효과를 설정합니다. 주요 기능:

  • 영역 설정: 이미지 내 특정 영역을 지정하여 마우스/터치 반응을 설정합니다.
  • 효과 편집: 회전, 펄스 등 미리 정의된 효과를 선택하거나 물리 파라미터(강도, 속도 등)를 직접 조정합니다.
  • 보상 시스템: 글 분석 점수에 따라 설정 가능한 인터랙션 영역의 개수가 제한됩니다. (점수가 높을수록 많은 영역 설정 가능)
  • 미리보기: 설정한 효과를 실시간으로 테스트하고 전체 화면으로 조회할 수 있습니다.

4. 팀 및 커리큘럼

4.1 팀 관리 (/team)

목적: 선생님이나 리더가 그룹을 만들고 멤버의 활동을 관리하는 공간입니다. 주요 기능:

  • 팀 목록: 사용자가 소유한 팀과 소속된 팀을 구분하여 표시합니다.
  • 팀 생성: 수업이나 모임을 위한 그룹을 간편하게 개설합니다.
  • 실시간 모니터링 대시보드: 팀 리더(선생님)를 위한 관리 도구를 제공합니다.
    • 실시간 글쓰기 현황: 팀원들이 현재 글을 쓰고 있는지, 얼마나 작성했는지를 실시간으로 확인합니다.
    • 활동 통계 보고서: 주제별, 멤버별 상세 분석 데이터를 제공합니다.
      • 개별 멤버 분석: 특정 멤버의 주제별 작성 현황과 글쓰기 패턴을 분석한 보고서를 조회합니다.
      • 주제별 작성 현황: 각 주제에 대해 어떤 멤버들이 참여했는지와 개별 작품의 성과를 한눈에 파악합니다.
  • 팀 설정 및 멤버 관리:
    • 주제별 시각 자료(Visual Prompt) 설정: 주제 생성 시 텍스트 설명 외에도 '추천 이미지'를 등록할 수 있습니다. 이는 멤버들이 해당 주제로 글쓰기를 시작할 때 가이드 이미지로 제시되어, 추상적인 주제를 구체적으로 시각화하는 데 도움을 줍니다.
    • 전문 설정: AI 도움 수준 설정, 채점 기준(루브릭) 관리, 멤버 초대 및 권한 설정을 수행합니다.

4.2 커리큘럼 대시보드 (/curriculum)

목적: 학습 커리큘럼을 관리하고 구독합니다. 주요 기능:

  • 나의 커리큘럼: 사용자가 생성한 커리큘럼 목록을 관리합니다.
  • 라이브러리: 구독한 커리큘럼 목록을 표시합니다.
  • 탐색 (Browse): 공개된 커리큘럼을 검색하고 상세 내용을 확인합니다.
  • 배포 및 구독:
    • 커리큘럼을 개인 라이브러리에 추가하거나 구독 취소할 수 있습니다.
    • 팀 소유자는 특정 커리큘럼을 팀에 할당하여 멤버들이 이용하도록 설정할 수 있습니다.

5. 기술 및 환경

  • 보안: 사용자 인증 및 권한 관리 시스템(Auth)을 적용했습니다.
  • 다국어: next-intl을 활용하여 다국어(i18n)를 지원합니다.
  • 반응형: 데스크톱, 태블릿, 모바일 등 다양한 해상도를 지원합니다.