ERD 페이지는 경계 수준에서 Lumie의 persistence 형태를 보여줍니다. 이 페이지들은 데이터베이스 덤프를 자동 생성한 것이 아닙니다. 관계가 어디에 속하는지, tenant 격리가 적용되는지, migration이나 repository를 바꾸기 전에 어떤 상세 스키마 페이지를 읽어야 하는지 판단하는 개발자를 위한 선별된 다이어그램입니다.
소스 경로
| 경로 | 역할 |
|---|
lumie-backend/app/src/main/resources/db/migration/public/V1__create_platform_tables.sql | 플랫폼 tenant registry |
lumie-backend/app/src/main/resources/db/migration/public/V18__rls_baseline.sql | tenant 범위 baseline 테이블과 FK |
lumie-backend/app/src/main/resources/db/migration/public/V28__billing_platform_tables.sql | 플랫폼 billing 테이블 |
lumie-backend/app/src/main/resources/db/migration/public/V29__tuition_tenant_tables.sql | tenant tuition billing 테이블 |
lumie-backend/modules/**/domain/entity/ | 엔티티 매핑과 aggregate 소유권 |
다이어그램 범위
읽는 규칙
| 규칙 | 의미 |
|---|
| Solid relation | migration의 DB FK 또는 직접 소유 관계로 뒷받침됨 |
| Soft relation | hard FK 없이 id 또는 의미적 링크로 저장됨 |
| Tenant-scoped entity | tenant_id를 가지며 RLS로 보호되어야 함 |
| Platform entity | cross-tenant Lumie 제어 평면 데이터로, 대체로 RLS가 없음 |
| Worker state | 제품 tenant 데이터가 아닌 서비스 소유 기술 상태 |
다음에 열어볼 페이지
유지보수 규칙
migration이 지속적인 관계를 변경하거나, 새 aggregate 테이블을 도입하거나, tenant 격리 의미를 바꾸거나, soft reference를 hard DB FK로 바꿀 때는 이 ERD도 함께 업데이트해야 합니다.