Skip to content

tpals0409/AlgoSu

BranchesTags

Repository files navigation

AlgoSu Logo

AlgoSu

알고리즘 스터디 관리 플랫폼 — 코드 제출부터 AI 분석까지 자동화된 워크플로우

CI Tests TypeScript Coverage

🔗 algo-su.com

주요 기능

  • OAuth 소셜 로그인 — Google · Naver · Kakao 3사 OAuth + httpOnly Cookie JWT 인증
  • 코드 제출 → GitHub 자동 Push — 제출 즉시 GitHub 레포지토리에 자동 커밋 (GitHub App 연동)
  • AI 코드 분석 — Claude API 기반 코드 리뷰 · 점수 산정 · 피드백 자동 생성 (Circuit Breaker 적용)
  • 스터디 관리 — 문제 출제 · 마감 자동 종료 · 난이도 티어 시스템 · 스터디룸 대시보드
  • 실시간 알림 — SSE(Server-Sent Events) 기반 제출 상태 · 분석 완료 실시간 푸시

체험하기 (Demo)

별도 가입 없이 AlgoSu의 전체 워크플로우를 바로 체험할 수 있습니다.

데모 접속 방법

  1. algo-su.com/login 접속
  2. "데모로 체험하기" 버튼 클릭 (OAuth 로그인 불필요)
  3. 자동 발급된 데모 JWT로 즉시 대시보드 진입

데모 워크플로우

flowchart LR
    A["로그인 페이지\n데모로 체험하기\n버튼 클릭"] --> B["스터디룸\n대시보드"]
    B --> C["문제 목록\n6개 알고리즘 문제\n난이도 티어 확인"]
    B --> D["제출 내역\n15건 코드 제출\n상태 확인"]
    D --> E["AI 분석 결과\nClaude 코드 리뷰\n점수 + 피드백"]
Loading

체험 가능 기능

기능 설명
스터디룸 대시보드 스터디 현황, 멤버 목록, 진행률 한눈에 확인
문제 목록 조회 난이도 티어(브론즈~다이아), 마감 상태, 문제 상세
제출 내역 열람 코드 제출 이력, 제출 상태(대기/완료), GitHub Push 결과
AI 코드 분석 결과 Claude 기반 코드 리뷰 점수, 카테고리별 피드백, 하이라이트
퍼블릭 프로필 사용자 프로필 및 제출 통계

데모 제한사항

항목 내용
권한 읽기 전용 -- 생성/수정/삭제(CUD) 작업은 DemoWriteGuard에 의해 차단
데이터 리셋 6시간 주기 자동 초기화 (K8s CronJob)
세션 데모 전용 JWT 발급 (isDemo 클레임 포함)

데모 환경에는 사용자 3명, 스터디 1개, 알고리즘 문제 6개, 제출 15건, AI 분석 결과가 미리 세팅되어 있습니다.

기술 스택

서비스 역할 기술
Gateway API Gateway · OAuth · JWT · SSE NestJS 10 · Passport · ioRedis · Throttler · Swagger
Submission 제출 관리 · Saga Orchestrator NestJS 10 · TypeORM · RabbitMQ (amqplib)
Problem 문제 CRUD · 마감 스케줄러 NestJS 10 · TypeORM · @nestjs/schedule
Identity 사용자 · 스터디 DB NestJS 10 · TypeORM · PostgreSQL
GitHub Worker RabbitMQ Consumer · GitHub Push Node.js · Octokit (GitHub App) · amqplib
AI Analysis Claude API · Circuit Breaker FastAPI · Anthropic SDK · pika · httpx
Frontend SPA · 대시보드 · 코드 에디터 Next.js 15 (App Router) · React 19 · Tailwind 4 · shadcn/ui · Monaco Editor
인프라 기술
오케스트레이션 k3s (프로덕션) · k3d (개발)
CI/CD GitHub Actions (15 jobs) → GHCR → ArgoCD GitOps
DB PostgreSQL 16 (Database per Service)
메시지 큐 RabbitMQ 3.13
캐싱 Redis 7.2
객체 저장소 MinIO
모니터링 Prometheus · Grafana · AlertManager
보안 SealedSecret · NetworkPolicy · Gitleaks

아키텍처

%%{init: {'theme': 'base', 'themeVariables': {
  'primaryColor': '#7C6AAE',
  'primaryTextColor': '#FAFAF8',
  'primaryBorderColor': '#C4A6FF',
  'lineColor': '#A08CD6',
  'secondaryColor': '#1C1C22',
  'tertiaryColor': '#0F0F12',
  'mainBkg': '#1C1C22',
  'nodeBorder': '#C4A6FF',
  'clusterBkg': '#16161C',
  'clusterBorder': '#7C6AAE',
  'titleColor': '#FAFAF8',
  'edgeLabelBackground': '#0F0F12',
  'textColor': '#FAFAF8',
  'fontSize': '13px',
  'fontFamily': 'Sora, sans-serif'
}}}%%
flowchart LR
    subgraph CLIENT["🖥️ Client"]
        Next["Next.js 15\nApp Router\nTailwind · shadcn/ui"]
    end

    subgraph GATEWAY["🔐 API Gateway"]
        GW["Gateway\nOAuth · JWT · SSE\nRate Limit · Proxy"]
    end

    subgraph SERVICES["⚙️ Microservices"]
        direction TB
        ID["Identity\n사용자 · 스터디"]
        SUB["Submission\nSaga Orchestrator"]
        PROB["Problem\n문제 · 마감"]
    end

    subgraph ASYNC["📨 Async Workers"]
        direction TB
        GH["GitHub Worker\nOctokit · Push"]
        AI["AI Analysis\nFastAPI · Claude"]
    end

    subgraph INFRA["🗄️ Infrastructure"]
        direction TB
        PG[("PostgreSQL 16")]
        RMQ[["RabbitMQ"]]
        RD[("Redis")]
        MIO[("MinIO")]
    end

    Next -->|HTTP| GW
    GW --> ID & SUB & PROB
    SUB -->|publish| RMQ
    RMQ -->|consume| GH & AI
    ID & SUB & PROB --> PG
    GW & SUB --> RD
    GH --> MIO

    GH -..->|push| EXT_GH(("GitHub"))
    AI -..->|analyze| EXT_CL(("Claude API"))
Loading

디렉토리 구조

AlgoSu/
├── frontend/                  # Next.js 15 (App Router, Tailwind, shadcn/ui)
├── services/
│   ├── gateway/               # API Gateway · OAuth · JWT · SSE
│   ├── submission/            # 제출 관리 · Saga Orchestrator
│   ├── problem/               # 문제 CRUD · 마감 스케줄러
│   ├── identity/              # 사용자 · 스터디 DB
│   ├── github-worker/         # RabbitMQ Consumer · GitHub Push
│   └── ai-analysis/          # Claude API · Circuit Breaker
├── infra/
│   ├── k3s/                   # K8s 매니페스트 (HPA, PDB, NetworkPolicy)
│   ├── overlays/              # Kustomize (dev / staging / prod)
│   └── sealed-secrets/        # SealedSecret 암호화
├── scripts/                   # 배포 · 검증 스크립트
├── .github/workflows/         # CI 파이프라인 (15 jobs)
└── docs/                      # ADR · 런북 · 규칙 문서

시작하기

사전 요구사항

  • Docker & Docker Compose
  • Node.js 20+
  • Python 3.12+
  • pnpm (프론트엔드)

1. 인프라 실행

# 저장소 클론
git clone https://github.com/tpals0409/AlgoSu.git
cd AlgoSu

# 환경 변수 설정
cp .env.example .env
# .env 파일에 PostgreSQL, Redis, RabbitMQ 비밀번호 입력

# 인프라(PostgreSQL, Redis, RabbitMQ) 실행
docker compose -f docker-compose.dev.yml up -d

2. 백엔드 서비스 실행

# 각 서비스 디렉토리에서 .env.example을 참고하여 .env 설정
# 예: services/gateway/.env.example → services/gateway/.env

# 서비스 실행 (각 서비스 디렉토리에서)
cd services/gateway && npm install && npm run start:dev
cd services/identity && npm install && npm run start:dev
cd services/problem && npm install && npm run start:dev
cd services/submission && npm install && npm run start:dev
cd services/github-worker && npm install && npm run start:dev
cd services/ai-analysis && pip install -r requirements.txt && uvicorn main:app --reload

3. 프론트엔드 실행

cd frontend
pnpm install
pnpm dev
# http://localhost:3000 접속

About

알고리즘 스터디 관리 플랫폼 — 코드 제출부터 AI 분석까지 자동화된 워크플로우

algo-su.com

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages