AI 어시스턴트

자연어로 코드베이스에 대해 질문하세요.

개요

ArchiCore AI 어시스턴트는 코드를 이해하고 다음과 같은 질문에 답변할 수 있습니다:

• "인증 시스템은 어떻게 작동하나요?"
• "UserService를 변경하면 무엇이 깨지나요?"
• "결제 처리 로직은 어디에 있나요?"
• "주문 생성 데이터 흐름을 설명해주세요"

어시스턴트 사용하기

웹 인터페이스

1. 프로젝트 선택
2. 채팅 패널에 질문 입력
3. 코드 참조가 포함된 답변 받기

CLI

대화형 모드에서 질문을 입력하세요:

> 사용자 인증은 어떻게 작동하나요?

이 프로젝트의 인증 시스템은 JWT 토큰을 사용합니다.
작동 방식은 다음과 같습니다:

1. **로그인 플로우** (src/auth/login.ts)
   - 사용자가 이메일/비밀번호 제출
   - 데이터베이스에서 자격 증명 검증
   - 사용자 ID로 JWT 토큰 생성

2. **토큰 검증** (src/middleware/auth.ts)
   - authMiddleware()가 헤더에서 토큰 추출
   - JWT_SECRET으로 토큰 검증
   - 사용자를 request 객체에 첨부

3. **세션 관리** (src/services/session.ts)
   - 세션은 Redis에 저장
   - 기본 7일 만료
   - 리프레시 토큰 지원

주요 파일:
- src/auth/login.ts:45-78
- src/middleware/auth.ts:12-34
- src/services/session.ts:23-56

API

curl -X POST https://api.archicore.io/api/v1/projects/:id/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"question": "인증은 어떻게 작동하나요?"}'

질문 유형

아키텍처 질문

> 이 프로젝트의 전체 아키텍처는 무엇인가요?
> 모듈은 어떻게 구성되어 있나요?
> 어떤 디자인 패턴이 사용되나요?

코드 플로우 질문

> 사용자가 주문하면 어떻게 되나요?
> 데이터는 API에서 데이터베이스로 어떻게 흐르나요?
> /api/users의 요청 생명주기를 추적해주세요

영향 질문

> UserService를 변경하면 무엇이 깨지나요?
> 데이터베이스 모듈에 의존하는 파일은 무엇인가요?
> 결제 로직을 커버하는 테스트는 무엇인가요?

위치 질문

> 이메일 전송 로직은 어디에 있나요?
> 사용자 등록을 처리하는 파일은 무엇인가요?
> rate limiting 미들웨어를 찾아주세요

설명 질문

> processOrder()가 무엇을 하는지 설명해주세요
> 이 함수가 재귀를 사용하는 이유는 무엇인가요?
> 캐시 레이어의 목적은 무엇인가요?

더 나은 답변을 위한 팁

구체적으로 질문하기

❌ "어떻게 작동하나요?"
✓ "사용자 등록 프로세스는 어떻게 작동하나요?"

컨텍스트 제공하기

❌ "왜 느린가요?"
✓ "src/api/products.ts의 getProducts() 함수가 왜 느릴 수 있나요?"

후속 질문하기

> 인증은 어떻게 작동하나요?
[JWT 토큰에 대한 답변...]

> 토큰 검증 코드를 보여줄 수 있나요?
[특정 코드 표시...]

> 토큰이 만료되면 어떻게 되나요?
[리프레시 토큰 플로우 설명...]

언어 지원

어시스턴트는 질문과 같은 언어로 답변합니다:

> 인증은 어떻게 작동하나요?

인증 시스템은 JWT 토큰을 사용합니다...

제한 사항

AI 어시스턴트는:

• 인덱싱된 코드만 알고 있음 - 먼저 /index를 실행하세요
• 코드를 실행할 수 없음 - 정적 코드 분석만 가능
• 정보가 오래되었을 수 있음 - 변경 후 다시 인덱싱하세요
• 프로젝트에 집중 - 외부 라이브러리에 대해서는 자세히 논의하지 않습니다

개인정보 보호

• 질문은 AI 모델에 의해 처리됩니다
• 코드 컨텍스트가 분석을 위해 전송됩니다
• 코드는 영구 저장되지 않습니다
• 자세한 내용은 개인정보 보호정책을 참조하세요