AI 역문서 · 1D1S-admin@5dd0cfe · 1D1S-client@ad5edf9 · 1D1S-server-v2@f69a4eb 기준 · 코드에서 거꾸로 만든 위키입니다. 각 쪽의 근거 링크로 확인하세요.

• 1.1 서비스와 레포 개요 — 테스트 프로젝트의 사용자 서비스와 관리자 기능을 소개합니다. 1D1S-client, 1D1S-admin, 1D1S-server-v2의 역할을 구분합니다.

• 1.2 저장소 구조 — 클라이언트와 관리자 웹의 Next.js 구조를 설명합니다. 서버의 Spring Boot 도메인 구조와 마이그레이션 위치를 함께 다룹니다.

• 1.3 시스템 아키텍처 — 클라이언트와 관리자 웹이 서버의 REST API를 사용하는 구조를 설명합니다. 클라이언트의 HTTP 요청, WebSocket 채팅, 서버의 도메인 처리와 저장 흐름을 연결해 봅니다.

• 2.1 챌린지 탐색과 참여 — 사용자가 챌린지를 탐색하고 상세 정보를 확인한 뒤 참여하거나 나가는 흐름을 다룹니다. 목록·상세 화면, 참여 API, 참여자와 회차 데이터를 함께 설명합니다.

• 2.2 챌린지 만들기 — 사용자가 목표, 기간, 공개 범위와 참여 조건을 입력해 챌린지를 생성하고 수정하는 흐름을 설명합니다. 작성 폼과 서버의 챌린지 생성 모델을 연결합니다.

• 2.3 일지 작성과 조회 — 사용자가 챌린지 기록을 작성하고 이미지와 감정을 저장하며 일지를 조회하는 흐름을 다룹니다. 일지 목록·상세·작성 화면과 API, 서버 엔티티를 함께 설명합니다.

• 2.4 좋아요와 댓글 — 일지와 챌린지에서 좋아요와 댓글을 사용하는 흐름을 설명합니다. 댓글 신고와 좋아요 조회가 화면, API, 서버 모델에서 어떻게 나뉘는지 다룹니다.

• 2.5 채팅과 신고 — 사용자가 채팅방에서 메시지와 이미지를 주고받고 메시지를 신고하는 흐름을 설명합니다. REST API, STOMP 연결, 채팅 도메인 처리를 함께 다룹니다.

• 2.6 마이페이지와 활동 — 사용자가 프로필, 참여 챌린지, 일지, 친구, 통계와 레벨을 확인하는 흐름을 설명합니다. 마이페이지 화면과 회원·통계·성장 API를 연결합니다.

• 2.7 홈과 콘텐츠 탐색 — 홈에서 오늘의 기록, 추천 챌린지, 일지, 배너와 팝업을 보여주는 흐름을 다룹니다. 가이드, 공지, 검색과 공식 챌린지 탐색도 함께 설명합니다.

• 3.1 인증과 세션 — 소셜 로그인, 회원가입, JWT와 리프레시 토큰, 네이티브 세션 교환 구조를 설명합니다. 클라이언트 인증 API와 서버 보안 필터·서비스를 연결합니다.

• 3.2 API와 응답 구조 — 클라이언트의 요청 계층과 React Query 사용 방식을 설명합니다. 서버 컨트롤러, 공통 응답, 페이지네이션과 예외 응답 구조를 함께 정리합니다.

• 3.3 도메인 데이터 모델 — 챌린지, 일지, 회원, 친구와 성장 도메인의 엔티티와 저장소 구성을 설명합니다. 공통 시간 필드와 카테고리 같은 공유 모델도 다룹니다.

• 3.4 이미지 업로드 — 이미지 업로드를 위한 presigned URL 요청과 클라이언트 이미지 처리 위치를 설명합니다. 서버의 이미지 컨트롤러와 S3 설정을 함께 확인합니다.

• 3.5 알림과 푸시 — 앱 알림, 알림 설정, 디바이스 토큰과 푸시 발송 구조를 설명합니다. 챌린지 일지 리마인더와 알림 이벤트 처리 위치도 다룹니다.

• 3.6 스트릭과 보상 — 일지 기록을 바탕으로 스트릭, 프리즈, 마일스톤, XP와 레벨·배지를 처리하는 구조를 설명합니다. 관련 클라이언트 화면과 서버 정책·배치를 연결합니다.

• 4.1 클라이언트 화면 구조 — 1D1S-client의 App Router, 기능별 app.feature 구성과 공통 레이아웃을 설명합니다. 인증 상태, React Query 프로바이더와 화면 셸의 연결을 다룹니다.

• 4.2 관리자 콘솔 — 1D1S-admin의 로그인, 관리자 셸과 도메인별 관리 화면을 설명합니다. 관리자 API, 조회 훅, 폼과 상세 모달의 구성을 함께 다룹니다.

• 5.1 서버 도메인 계층 — 1D1S-server-v2의 컨트롤러, DTO, 서비스, 리포지터리, 엔티티 계층을 설명합니다. 주요 기능별 패키지 경계와 관리자 엔드포인트 구성을 함께 정리합니다.

• 6.1 개발과 배포 설정 — 세 레포의 로컬 실행, 빌드, 환경 변수와 배포 워크플로를 설명합니다. Docker Compose, GitHub Actions, 데이터베이스 백업과 운영 스크립트 위치를 안내합니다.

• 7.1 핵심 용어집 — 코드에 정의된 챌린지, 회차, 참여자, 일지, 스트릭, XP와 알림 관련 용어를 정리합니다. 주요 enum과 정책 클래스의 의미를 코드 기준으로 설명합니다.