리포트
리포트(Report) 는 호스트가 자신의 스페이스에서 일어난 일을 종합해 발행하는 결과물입니다 — 참여자들이 어떻게 생각했고, 어디서 합의했고, 어디서 갈렸고, 무엇이 두드러졌는지를 정리한 문서예요. Ratel 에는 함께 동작하는 두 개의 리포트 화면이 있습니다.
| 화면 | URL | 무엇인가 |
|---|---|---|
| 스페이스 리포트 (장문) | /spaces/:space_id/report | 스페이스당 하나. 호스트의 내러티브 문서, AI 가 초안을 만들고 호스트가 다듬는 워크플로우. Phase 4 에서 구독자가 결국 구매하게 될 결과물. |
| Analyzes (교차 필터) | /spaces/:space_id/apps/analyzes/... | 스페이스당 여러 개. 폴 · 퀴즈 · 팔로우 · 토론에 대한 저장된 교차 필터 분석, 원본 데이터 드릴다운 포함. 장문 스페이스 리포트에서 인용하는 데이터. |
이 챕터는 호스트가 보통 사용하는 순서 — 먼저 Analyzes 몇 개로 데이터의 윤곽을 잡고, 그 위에 스페이스 리포트를 쓰는 — 대로 두 화면을 설명합니다.
Analyzes 앱은 검증을 거치는 동안 프로덕션에서는 숨겨져 있습니다 — 오늘은 dev / staging 에서 사용할 수 있습니다. 장문 스페이스 리포트 (/spaces/:space_id/report) 는 모든 환경에서 사용 가능합니다. 프로덕션에서는 오늘 시점에 아래의 권장 Analyze 우선 워크플로우를 사용할 수 없습니다 — 그 대신 본인의 관찰을 토대로 처음부터 장문 리포트를 작성하고, 근거가 필요한 부분에는 스페이스의 개별 폴 / 토론으로 직접 링크할 수 있어요.
Analyze 만들기
/spaces/:space_id/apps/analyzes 의 Analyzes 앱은 저장된 분석들의 수평 카루셀 입니다. 첫 카드는 항상 + 새 분석 만들기, 그 오른쪽에는 이미 만든 분석들이 놓입니다. 좌우 화살표로 넘기고, 카드를 누르면 열립니다.
1 단계 — 교차 필터 선택
/spaces/:space_id/apps/analyzes/create
생성 흐름은 두 단계입니다. 첫 번째는 교차로 자르고 싶은 데이터를 고르는 패널이에요. 스페이스의 모든 폴 문항, 모든 퀴즈 문항, 모든 팔로우 타겟, 모든 토론 스레드가 타일로 노출됩니다. 하나 이상 선택하면 각각이 필터 칩 이 됩니다. 쉼표로 구분된 키워드 를 붙여 넣어 각 키워드를 별도 필터로 추가할 수도 있어요 (예: 증거, 진술, 피해자).
각 타일 옆의 라이브 카운터가 현재 필터 조합에 매칭되는 참여자 수와 데이터 수를 보여주므로, 너무 좁혔는지 한눈에 알 수 있습니다.
2 단계 — 미리보기 및 생성
두 번째 단계는 미리보기(Preview) 패널입니다. 분석명 (결과 페이지의 제목과 카루셀 카드의 제목으로 사용) 을 입력하고, 교차 필터와 매칭되는 원본 데이터 샘플을 확인한 후 보고서 생성(Generate report) 을 누르면 됩니다. 준비가 끝나면 결과 페이지로 이동합니다.
각 카루셀 카드의 상태 뱃지는 분석 중 (Running), 분석 완료 (Analysis complete), 실패 (Failed) 중 하나로 노출됩니다. 분석 중인 카드는 완료 전까지 열 수 없습니다.
3 단계 — 결과 읽기
/spaces/:space_id/apps/analyzes/report/:report_id
결과 페이지는 선택된 필터를 칩으로 상단에 표시한 뒤, 그 교차 필터 범위 안의 데이터 — 폴 응답의 분포 차트, 퀴즈의 점수 요약, 팔로우 카운트, 토론 댓글 빈도 — 를 렌더링합니다. 칩은 보고서 저장 시점에 frozen 되므로, 한 달 뒤에 다시 열어도 같은 슬라이스를 그대로 볼 수 있어요.
4 단계 — 원본 데이터 드릴다운
원본 데이터 보기 (View raw data) 를 누르면 /spaces/:space_id/apps/analyzes/report/:report_id/records 가 열립니다 — 필터에 매칭된 모든 개별 레코드 (사용자 · 문항 · 응답 · 글 · 코멘트 · 팔로우 대상) 의 페이지네이션 표예요. 칩 헤더의 칩을 누르면 추가로 좁힐 수 있습니다.
특정 액션 단위에서 시작하고 싶다면 다음 두 딥링크가 유용합니다.
/spaces/:space_id/apps/analyzes/poll/:poll_id— 폴 단위 분석 뷰./spaces/:space_id/apps/analyzes/discussion/:discussion_id— 토론 단위 분석 뷰.
각 분석에는 매칭된 레코드를 스프레드시트로 내보내는 엑셀 다운로드(Download Excel) 버튼이 있습니다.
스페이스 리포트 작성
모든 스페이스에는 다음 위치에 단 하나의 정식 리포트가 있습니다.
/spaces/:space_id/report
이 화면이 Phase 4 에서 구독자에게 판매될 공개 내러티브입니다. 페이지는 세 가지 모드를 갖습니다.
- Read-only (읽기 전용) — 방문자가 보는 모드. Phase 4 에서 구독자가 보게 될 모드.
- Editable (편집) — 호스 트가 Toggle Edit 을 눌렀을 때 보이는 모드. 같은 페이지가 리치 텍스트 에디터로 전환됩니다.
- Generating… (생성 중) — Generate AI Report 를 누른 직후 보이는 상태. Ratel 이 누적된 활동에서 초안을 종합하여 에디터에 넣어 주면, 호스트는 이를 다듬습니다.
작성 흐름
전형적인 호스트 루프:
- 페이지 열기 —
/spaces/:space_id/report. 처음에는 비어 있습니다. - Generate AI Report 클릭 — Ratel 이 스페이스의 활동 (폴, 토론, 퀴즈, 팔로우) 을 읽고 내러티브 초안을 생성합니다. 진행 중에는 Generating… 자리표시자가 보입니다.
- Toggle Edit 클릭 — Editable 모드로 전환. 리치 텍스트 에디터에서 AI 초안을 다듬으세요: 프레이밍 추가, 앞서 만든 Analyzes 인용, AI 가 도달하지 못한 결론 보충.
- Save 클릭 — 페이지가 다시 Read-only 로 전환되고, 이제부터 방문자가 보는 화면이 됩니다.
스페이스의 활동이 더 쌓이면 Generate AI Report 를 다시 실행해도 됩니다 — 현재 데이터로 새 초안이 만들어지고, 어떤 부분을 병합할지는 호스트가 결정합니다.
리포트에는 무엇을 담나
리포트는 주장 뒤의 데이터를 함께 인용할 때 가장 유용합니다. 자연스러운 패턴은 다음과 같아요.
- 스페이스의 폴과 토론에 대해 Analyzes 를 몇 개 만든다 (
/apps/analyzes/create). - 스페이스 리포트 AI 초안을 생성한다.
- Editable 뷰에서 Analyzes 상세 페이지와 폴 / 토론 단위 드릴다운 링크를, 그것이 뒷받침하는 주장 옆에 붙인다.
- 저장한다.
Read-only 리포트를 읽는 구독자는 이 링크를 눌러 원본 데이터로 주장을 검증할 수 있습니다.
Phase 4 — 매출 분배 (예정)
Phase 4 에서 리포트가 유료 상품이 되면 모든 판매가 다음과 같이 분배됩니다.
플랫폼 10% · 호스트 60% · 기여자 30%
기여자 몫은 최종 리포트에 대한 관련도 로 가중됩니다 — 발행된 내러티브를 형성한 폴 응답 · 댓글 · 팔로우 선택 · 퀴즈 답변을 한 참여자가 더 많이 받습니다. /spaces/:space_id/apps/analyzes/report/:report_id/records 의 기여 기록 드릴다운이 그 분배의 데이터 레이어입니다.
분배 엔진과 구매 흐름 자체는 (예정) 입니다 — 리포트는 오늘도 발행 가능하지만, 가격 책정 / 판매는 아직 동작하지 않습니다. 엔진이 출시되면 별도 작업 없이 기존 리포트들이 자동으로 자격을 얻습니다.
팁
- 내러티브 전에 Analyze 부터. 비어 있는 스페이스에 AI 리포트 생성을 돌리면 빈 초안이 나옵니다. AI 가 요약할 거리가 생기도록 Analyzes 를 먼저 몇 개 만드세요.
- 스페이스당 리포트 하나, Analyzes 는 여러 개. 모든 교차 비교를 장문 리포트에 욱여넣지 마세요 — 그게 Analyzes 의 역할입니다. 리포트는 헤드라인, Analyzes 는 뒷받침 자료입니다.
- 반복하세요. 리포트는 한 번 만들고 잊는 게 아닙니다. 스페이스가 성숙해지면 다시 생성하고, 새 초안을 기존 글과 병합하세요.
다음 단계
- 스페이스 앱 → Analyzes — Analyzes 가 위치한 앱 단위 개요.
- 호스트 액션 — 결과를 분석하게 될 폴 · 토론 · 퀴즈 · 팔로우.
- 스페이스 대시보드 — 종합하려는 활동의 라이브 통계.