How cp949/storix works
Storix — 호출 서버가 경로 기반 파일시스템 API로 파일과 디렉터리를 저장·조회하는 독립 VFS 서버입니다. 주 흐름은 호출 서버의 서비스 key 요청에서 시작해 namespace 및 VFS API를 거쳐 메타데이터 DB와 S3 호환 blob 저장소를 사용하고 결과를 돌려주는 것입니다. 주요 도메인 단계로 업로드 세션, 변경 feed, snapshot, 휴지통 복구와 GC·백업·복원을 포함했습니다. 데모 웹/서버는 Storix API를 이용하는 별도 문서 보관 예시입니다. 관계는 README와 제공된 SOURCE INDEX 및 발췌로 확인되는 범위에 한정했습니다.
Main entry points: vfs.service.ts VFS 서비스 · fs.controller.ts 파일 API · vfs-node.repository.ts Node 저장소 · data-source.ts 메타데이터 DB
Components 22
API 및 네임스페이스
- Namespace 관리
apps/api/src/namespace/namespace.controller.ts - API 키 인증
apps/api/src/auth/api-key.guard.ts - Capability 설정
apps/api/src/capability/capability.service.ts
파일시스템 도메인
- 파일 API
apps/api/src/vfs/fs.controller.ts - VFS 서비스
apps/api/src/vfs/vfs.service.ts - 파일 변경
apps/api/src/vfs/mutation.service.ts - 콘텐츠 전송
apps/api/src/vfs/content.service.ts - 분할 업로드
apps/api/src/vfs/upload-session-part.service.ts - 변경 feed
apps/api/src/vfs/change-feed.service.ts - Snapshot
apps/api/src/vfs/vfs-snapshot.service.ts - 휴지통 복구
apps/api/src/vfs/vfs-trash.service.ts
저장 및 운영
문서 보관 데모
- 보관함 웹
apps/demo1/web/src/components/DocumentArchive.tsx - 보관함 API
apps/demo1/was/src/document-archive/documents.controller.ts - Storix HTTP 클라이언트
apps/demo1/was/src/storix-client/storix-client.service.ts
Other components
- 호출 서버
- S3 호환 저장소
Connections 24
- 호출 서버 → API 키 인증: 서비스 key 전송
README.md - API 키 인증 → 파일 API: 인증 후 요청
README.md - 호출 서버 → Namespace 관리: namespace 관리
README.md - 파일 API → VFS 서비스: 파일 요청 처리
- VFS 서비스 → 파일 변경: 변경 수행
- VFS 서비스 → 콘텐츠 전송: 콘텐츠 처리
- 파일 API → 분할 업로드: 분할 업로드
- 호출 서버 → 변경 feed: 변경 cursor 조회
README.md - 호출 서버 → Snapshot: snapshot 조작
README.md - 호출 서버 → 휴지통 복구: 복구・purge
README.md - 호출 서버 → Capability 설정: 기능 확인
README.md - VFS 서비스 → Node 저장소: node 읽기・쓰기
- 파일 변경 → Node 저장소: 메타데이터 변경
- 콘텐츠 전송 → Blob 저장 계층: blob 전송
- 분할 업로드 → Node 저장소: 세션 상태 저장
apps/api/src/vfs/upload-session-part.service.ts - Node 저장소 → 메타데이터 DB: DB 질의
apps/api/src/persistence/vfs-node.repository.ts - Blob 저장 계층 → S3 호환 저장소: S3 객체 처리
apps/api/src/storage/s3-blob-storage.ts - 정리 작업 → 메타데이터 DB: 만료 데이터 정리
- 정리 작업 → S3 호환 저장소: 미참조 blob 회수
README.md - 백업 작업 → 메타데이터 DB: DB 백업
- 복원 작업 → 메타데이터 DB: DB 복원
- 보관함 웹 → 보관함 API: 보관함 요청
- 보관함 API → Storix HTTP 클라이언트: Storix 호출
apps/demo1/was/src/document-archive/documents.controller.ts - Storix HTTP 클라이언트 → 파일 API: HTTP 요청