architecture
생태계 개요
Modfolio Universe 15+ 앱 생태계의 전체 구조와 원칙
생태계 개요
Modfolio Universe란?
Modfolio Universe는 15개 이상의 앱으로 구성된 SaaS 생태계입니다. 각 앱은 독립 브랜드로 운영되며, 공통 인프라(SSO, 이벤트, 결제)를 통해 연결됩니다.
| 항목 | 값 |
|---|---|
| 조직 | github.com/modfolio |
| 플랫폼 | 100% Cloudflare Edge Native |
| 런타임 | Bun |
| 언어 | TypeScript (strict mode) |
| 린터 | Biome v2 |
모든 앱은 Cloudflare의 글로벌 엣지 네트워크에서 실행되며, 사용자 가까운 곳에서 응답합니다. Vercel, AWS, GCP 등 타 클라우드 플랫폼은 사용하지 않습니다.
3대 불변 원칙
생태계 전체에 적용되는 세 가지 원칙이 있습니다. 이 원칙은 예외 없이 모든 앱에 적용됩니다.
1. House of Brands
각 앱은 독립 브랜드입니다. 앱 간 UI 라이브러리 공유는 금지되며, 각 앱이 고유한 디자인 시스템과 기술 스택을 유지합니다.
# 금지 — 공유 UI 라이브러리
import { Button } from "@modfolio/shared-ui";
# 허용 — 각 앱 고유 컴포넌트
import { Button } from "$lib/components/Button.svelte";2. Zero Physical Sharing
앱 간 코드를 직접 공유하지 않습니다. 연결은 오직 세 가지 수단으로만 이루어집니다.
| 연결 수단 | 패키지/프로토콜 | 용도 |
|---|---|---|
| SSO 토큰 | modfolio-connect OIDC |
인증/인가 |
| 데이터 스키마 | @modfolio/contracts (Zod) |
이벤트 구조 검증 |
| Webhook API | HTTP POST | 앱 간 이벤트 전달 |
3. 100% Cloudflare Edge Native
모든 인프라는 Cloudflare 서비스만 사용합니다.
- 컴퓨팅: Workers + Pages
- 데이터: D1, R2, Durable Objects, KV
- 네트워크: DNS, CDN, Zero Trust
- 외부 DB: Neon Postgres, Turso (Hyperdrive 경유)
앱 분류
생태계는 4개 비즈니스 그룹, 유니버설 서비스, 인프라로 구성됩니다.
Universal Services (유니버설)
생태계 전체가 의존하는 핵심 서비스입니다.
| 앱 | 역할 | 프레임워크 |
|---|---|---|
| modfolio-connect | SSO/OIDC (login.modfolio.io) |
SvelteKit 5 + Better Auth |
| modfolio-pay | 결제 게이트웨이 | SvelteKit 5 |
Infrastructure (인프라)
생태계 운영을 지원하는 내부 도구입니다.
| 앱 | 역할 |
|---|---|
| modfolio-admin | 관리자 패널 |
| modfolio-dev | 개발자 도구 & API 콘솔 |
| modfolio-on | 커뮤니티 플랫폼 |
| modfolio-press | 퍼블리싱 & 매거진 커머스 |
| modfolio-docs | 시스템 문서 (이 사이트) |
Works 그룹
교육 및 생산성 앱으로 구성된 비즈니스 그룹입니다.
| 앱 | 도메인 | 역할 |
|---|---|---|
| Naviaca | naviaca.com | LMS (학습 관리 시스템) |
| GistCore | gistcore.com | AI 스피킹 훈련 |
| Fortiscribe | fortiscribe.com | AI 라이팅 어시스턴트 |
| KeepNBuild | keepnbuild.com | 프로젝트 관리 |
| Worthee | worthee.io | 가치 평가 도구 |
LS 그룹
라이프스타일 및 콘텐츠 앱입니다.
| 앱 | 도메인 | 역할 |
|---|---|---|
| Amberstella | amberstella.com | 라이프스타일 플랫폼 |
| Munseo | munseo.com | 문서 관리 |
| Sincheong | sincheong.com | 신청/접수 시스템 |
Axiom 그룹
미디어 및 데이터 앱입니다.
| 앱 | 도메인 | 역할 |
|---|---|---|
| Umbracast | umbracast.com | 미디어 캐스팅 플랫폼 |
상태 현황
| 앱 | 버전 | 상태 |
|---|---|---|
| modfolio-connect | v1.0.0 | Active |
| modfolio-pay | v0.5.0 | Active |
| modfolio-admin | v0.4.0 | Active |
| modfolio-dev | v0.2.0 | Landing |
| modfolio-on | v0.2.0 | Landing |
| modfolio-press | v0.3.0 | Landing |
| modfolio-docs | v0.2.0 | Landing |
| Naviaca | — | Active |
| GistCore | — | Active |
| Fortiscribe | — | Planned |
| KeepNBuild | — | Planned |
| Worthee | — | Planned |
| Amberstella | — | Planned |
| Munseo | — | Planned |
| Sincheong | — | Planned |
| Umbracast | — | Planned |
- Active: 프로덕션 운영 중
- Landing: 랜딩 페이지 구축 단계
- Planned: 기획 확정, 개발 미착수
다음 단계
- 도메인 아키텍처 — 2-프로젝트 모델과 라우팅 규칙
- 기술 스택 매트릭스 — 프레임워크 × DB 조합 상세