# AGENTS.md

## Database coding guidance

DB schema, migration, query, repository, model, or persistence code를 작성하거나 수정할 때는 먼저 [Database Schema Guide](docs/database-schema.md)를 읽고 그 문서의 테이블/enum/FK/상태 이력 규칙을 준수합니다. 로컬 DB 접속이 필요하면 [Bastion 경유 Cloud SQL 접속 가이드](docs/cloud-sql-bastion-connection.md)를 참고합니다.

- 애플리케이션 DB 접속은 `sbscax` 데이터베이스의 `core` 스키마와 `db_appuser`를 사용합니다.
- 시간값을 남기거나 표시할 때는 KST (`Asia/Seoul`, UTC+09:00)를 기준으로 합니다. timezone 없는 로컬 시간을 `TIMESTAMPTZ`에 저장하지 않습니다.
- Cloud SQL은 private 환경에 있으므로 승인된 접근 경로를 사용합니다. 현재 bastion VM은 생성 예정입니다.
- 스키마 규칙이나 DDL을 변경하면 위 문서도 함께 갱신합니다.
- 특히 상태 변경, JSONB payload, soft delete, FK 삭제 정책을 구현하기 전에 문서의 주의사항을 확인합니다.