다크 모드
truloop Wiki
truloop 프로젝트의 공식 위키입니다.
비즈니스 규칙, 기능 스펙, 기술 아키텍처, 의사결정 기록 등 프로젝트 전반의 지식을 체계적으로 정리합니다.
팁
이 위키는 팀의 유비쿼터스 언어를 정립하고, AI 에이전트의 컨텍스트 소스로 활용됩니다.
문서 추가/수정 시 문서 운영 가이드를 참고하세요.
정보
이 위키는 VitePress + Cloudflare Pages로 운영됩니다. main 브랜치에 커밋하면 자동으로 배포됩니다.
문서 구조
- 공통 레이어 — 도메인 용어, 비즈니스 규칙, 기능 스펙, 의사결정 기록 등 플랫폼에 무관한 공통 문서
- 기술 레이어 — iOS, Android, Backend, Web, Infra 등 서비스별 기술 아키텍처 문서
서비스 개요
| 카테고리 | 서비스 | 기술 스택 | 설명 |
|---|---|---|---|
| Client | truloop-ios | Swift / SwiftUI | iOS 앱 (17.2+) |
| Client | truloop_android | Kotlin / Compose | Android 앱 (API 29+) |
| Backend | truloop-core | Kotlin / Ktor 3.4 | 핵심 비즈니스 로직 |
| Backend | truloop-media-service | Go 1.24 | 미디어 업로드 / 처리 |
| Backend | truloop-ai-server | Python / FastAPI | AI 콘텐츠 생성 |
| Backend | truloop-assistant | Python / FastAPI | AI 비서 (RAG) |
| Web | truloop-web-invite | Next.js 16 | 초대 웹앱 |
| Web | truloop-teaser-web | Next.js 15 | 랜딩 페이지 |
| Infra | truloop-infra | Pulumi / TypeScript | AWS 인프라 |
| Infra | truloop-functions | AWS Lambda / Python | 트리거 디스패처 |
문서 작성 워크플로우
이 위키의 문서는 AI 에이전트 팀이 소스 코드 변경사항을 감지하여 자동으로 업데이트합니다.
| 단계 | 담당 | 설명 |
|---|---|---|
| 변경 감지 | PR Analyst | 병합된 PR, 커밋 메시지에서 변경 의도 파악 |
| 코드 분석 | Source Analysts | 소스 코드 diff에서 구체적인 변경 내용 분석 |
| 영향 평가 | Synthesizer | 분석 결과를 통합하여 위키 업데이트 범위 결정 |
| 문서 작성 | Feature Writer / Tech Writer | 레이어별 전담 작성 (공통: PM 관점, 기술: Engineer 관점) |
| 품질 검증 | Reviewer | 정확성 + 스타일 이중 검토 후 피드백 반복 |
정보
30분 주기로 자동 실행되며, 소스 코드에서 확인된 사실만 문서에 반영합니다.
상세 규칙은 문서 운영 가이드를 참고하세요.