Architecture 개요

고정 원칙

• Backend 최상위는 domain → application → adapters → interfaces; 각 계층 안에서 bounded context → feature를 둔다.
• CQRS는 전역 계층이 아니다. feature가 필요할 때만 commands/ 또는 queries/를 둔다.
• Contract, backend, frontend, assembly 네 repository가 각 권위를 소유한다. 직접 sibling source import는 금지한다.
• 영속 권위는 self-hosted Supabase Postgres·Auth·Storage다. application은 stateless를 유지한다.
• UI는 Astro 7+ 우선, .astro와 zero-JS 기본, 필요한 island만 React를 사용한다.
• image build는 Buildx remote cache와 build-once/promote-one-digest 원칙을 따른다.

Layer-first DDD계층 우선 물리 구조와 import 방향.

C4 modelContext부터 Code까지 전체 시스템 지도.

Supabase platformDB, Auth, Storage와 운영 책임.

Astro·frontendAtomic Projection Shell과 UI 경계.

Architecture gatesTach와 ESLint boundary 검증.

Delivery stageBuild, preview, evidence, release 단계.

상세 문서 사용법

C4 model, development-stage, OSS service stack은 전체 근거와 운영 제약을 보존한 긴 문서다. 결정 확인은 ADR, 구현 위치 확인은 repository 문서, 실행 결과 확인은 Testing topic을 우선한다.