AWA (AAR with AI)

AI 기반 After Action Review 협업 도구입니다.

Next.js + Supabase + Genkit 기반으로, 팀 회고를 구조화하고 AI 제안을 활용해 실행 가능한 개선안을 도출할 수 있습니다.

주요 기능

• 4단계 AAR 플로우
  • Step 1: 계획과 실행 비교
  • Step 2: 타임라인/이벤트 정리
  • Step 3: 원인 분석(계층형 포스트잇)
  • Step 4: 개선안 정리 및 실행 계획
• 실시간 협업
  • 워크샵 코드 기반 참여
  • 실시간 동기화 및 역할 기반 뷰
• AI 제안 통합
  • Gemini, Claude, OpenAI 연동
  • 사용자 API 키 우선 + 서버 폴백
• 결과 문서화
  • 요약 카드 및 Word 내보내기

아키텍처

• Frontend: Next.js App Router, React, TypeScript
• Backend: Next.js API Routes
• Data/Realtime: Supabase (PostgreSQL, Realtime)
• AI: Genkit + 다중 LLM Provider
• Hosting: Vercel + Supabase Cloud

빠른 시작

1) 설치

npm install

2) 환경 변수

아래 값은 실제 값으로 채우고, 민감값은 절대 커밋하지 않습니다.

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<redacted>
SUPABASE_SERVICE_ROLE_KEY=<redacted>

# Optional: server fallback keys
GEMINI_API_KEY=<redacted>
ANTHROPIC_API_KEY=<redacted>
OPENAI_API_KEY=<redacted>

# Optional: Supabase CLI helper
SUPABASE_PROJECT_REF=your-project-ref

3) 실행

npm run dev

브라우저에서 http://localhost:3000 접속

4) 빌드/검증

npm run typecheck
npm run lint
npm run build
npm run start

주요 스크립트

npm run dev
npm run build
npm run start
npm run typecheck
npm run lint
npm run supabase:version
npm run supabase:link
npm run supabase:db:push:dry-run
npm run supabase:db:push

프로젝트 구조

src/
  app/                # Next.js App Router pages/routes
  components/         # UI 및 AAR 도메인 컴포넌트
  hooks/              # 커스텀 훅
  lib/                # API/서비스/유틸
  ai/                 # Genkit 설정 및 AI flows
  types/              # 도메인/DB 타입
supabase/
  migrations/         # DB 마이그레이션
  seed.sql            # 시드
docs/                 # 설계/운영 문서

보안 및 운영 메모

• 퍼블릭 전환 시 민감 파일(.env.local, .env.vercel 등)은 Git 추적 금지
• 키/토큰 노출 이력이 있으면 재발급 후 기존 값 폐기
• GitHub Secret Scanning, Code Scanning 경고를 정기 확인

문서

• docs/AI_MODELS.md
• docs/REALTIME_COLLABORATION.md
• docs/CURRENT_ARCHITECTURE.md
• docs/CODE_QUALITY_REMEDIATION_PLAN.md

라이선스

MIT