Aura Docs

Aura AirTouch 운영 안정성 · 트러블슈팅 · 시스템 아키텍처 문서 사이트 (발표용 QR).

배포: Vercel — 이 저장소 루트를 연결하면 됩니다.

로컬 실행

npm install
npm run dev

http://localhost:3000

Vercel 배포

1. vercel.com/new → Import Git Repository
2. apkool12/aura-docs 선택 (또는 이 저장소 fork)
3. Framework Preset: Next.js (자동 감지)
4. Root Directory: . (기본값 — 저장소 루트)
5. Deploy → 배포 URL을 QR 코드로 생성

빌드 설정 (기본값 그대로 사용):

항목	값
Build Command	npm run build
Output Directory	.next (Next.js 자동)
Install Command	npm install

커스텀 도메인 (선택)

Vercel 프로젝트 → Settings → Domains

데이터 갱신

트러블슈팅 JSON은 Aura 메인 저장소에서 생성됩니다:

# Aura 루트에서
python3 docs/artifacts/build_troubleshooting_blog.py
# → docs-site/public/data/*.json 갱신 후 이 저장소에 push

스택

• Next.js 16 · Emotion · GSAP · Recharts
• Pretendard · 모바일 우선

페이지

경로	내용
/	개요 · 통계 · 이슈 분포 · 타임라인
/troubleshooting	전체 검색·필터·아코디언
/pipeline	시스템 아키텍처 + P0 목표 지표