gitea-agent/harness/docs/data-model/TEMPLATE.md

${data_model_title}

목적과 범위

${purpose}

• 포함 범위: ${included_scope}
• 제외 범위: ${excluded_scope}

정본 엔터티

${stable_section_id} — ${entity_name}

• 책임: ${entity_responsibility}
• 식별자: ${identifier_field}
• 생명 주기: ${entity_lifecycle}

필드

필드	타입	필수 여부	기본값	허용 값·형식	단위·정밀도	민감정보
${field_name}	${field_type}	${required_or_optional}	${default_value_or_none}	${allowed_values_and_format}	${unit_and_precision_or_none}	${sensitivity_or_none}

관계와 불변조건

관계

출발 엔터티	관계	대상 엔터티	카디널리티	필수 여부	소유권	삭제 규칙
${source_entity_id}	${relationship}	${target_entity_id}	${cardinality}	${required_or_optional}	${ownership}	${deletion_rule}

불변조건

• ${invariant}

저장과 마이그레이션

• 저장 위치: ${storage_location}
• 직렬화 형식: ${serialization_format}
• 스키마 버전: ${schema_version}
• 기존 데이터 처리: ${existing_data_migration}
• 하위 호환성: ${backward_compatibility}
• 롤백 조건: ${rollback_conditions}

검증

• 정상 데이터: ${normal_data_validation}
• 경계 데이터: ${boundary_data_validation}
• 오류 데이터: ${invalid_data_validation}
• 저장 후 재조회: ${round_trip_validation}
• 마이그레이션: ${migration_validation}