ClubKebi
LIVE스포츠 학원·학교 동아리·대학 체육동아리·사회인 클럽을 위한 운영 플랫폼입니다.
DjangoWeb SaaSMulti-tenantPostgreSQLCloudflareCoolify
제품 개요
ClubKebi는 학생, 수업, 출석, 코치, 성장 리포트, 재무를 한곳에서 운영하는 Django 기반 Web SaaS입니다. 별도 설치 없이 웹에서 운영하며, 각 학원은 {slug}.clubkebi.com에서 공개 랜딩과 테넌트 운영 진입점을 제공합니다.
제품 구조
| 영역 | 역할 |
|---|---|
/ | 경기 기록표·리그 순위표 등 로그인 없는 무료 도구 |
/program/ | 학원·클럽 운영 프로그램과 Free / Plus 가격 안내 |
{slug}.clubkebi.com | 학원별 공개 랜딩과 tenant 운영 진입점 |
sample.clubkebi.com | 공식 read-only 샘플 학원 |
운영 상태
- → Free / Plus 가격·한도·30일 체험 정책을 billing 공개 API 한 곳에서 관리합니다.
- → 공개 랜딩 공유 메타, 공식 read-only sample, 첫 고객 전달·배포 smoke checklist를 갖췄습니다.
- → Resend 발신 도메인 인증, Founding Academy 리허설, 백업·복구·모니터링을 운영 안정성의 핵심 점검 항목으로 관리합니다.
- → 세부 체크 상태와 다음 작업은 제품·운영 로드맵을 단일 기준으로 관리합니다.
핵심 원칙
- → Django modular monolith와 vertical slice를 유지합니다.
- → 도메인 간 접근은
interface.py공개 API만 사용합니다. - → 모든 운영 데이터는
academy_idtenant scope로 격리합니다. - → 재무 자동 집계와 수동 조정 변경은 감사할 수 있어야 합니다.
- → 기능 수보다 실제 한 학원의 안정적인 반복 운영을 제품 운영의 우선순위로 둡니다.
개발 환경
로컬 환경, 시딩, 테스트 명령은 개발 가이드를 기준으로 관리합니다.
just up cp .env.example .env just setup just dev
운영 문서
| 문서 | 용도 |
|---|---|
| 제품·운영 로드맵 | 제품 결정, 완료 상태, 출시 전 체크리스트 |
| 제품 개요 · 개발 가이드 | 대상 사용자, 기능 범위, AI 원칙과 로컬 실행·시딩·테스트 |
| 아키텍처 · Production 배포 | modular monolith, tenant 경계, Docker·GHCR·Coolify·Cloudflare |
| 외부 URL 배포 Smoke Check · Sample 운영 | 공개 URL·보안 헤더·sample 확인과 공식 샘플 학원 운영 |
| 첫 고객 전달 · Founding 리허설 | 계정 전달과 첫 주 운영, 첫 고객 여정 점검 |
| 보안·데이터 · 인프라 운영 | 데이터 보존, 감사 로그, 백업·복구·모니터링·오브젝트 스토리지 |