루트 README.md가 기술 스택·실행·운영을 다룬다면, 이 디렉터리는 도메인 로직과 파트 간 연동을 어떻게 구현하는지를 다룹니다.
CONTRIBUTING.md— 시작 절차, Jira 중심 작업 추적, 검증과 PR 규칙의 단일 원본development/— 개발 워크플로우, 코드 리뷰, 패키지 구조, 코드 스타일, API, API 문서화, 에러 처리, 로깅, 설정·프로파일, 데이터베이스, 테스트 상세 규약
backend/— 백엔드 도메인의 설계·결정·구현 기록 (백엔드 파트 소유). spec/decisions/implements/troubleshooting + worklog 구조이며, 작업 로그는worklog/에 작업마다 파일 하나로 쌓고 결정은BD번호(ADR)로 기록합니다.ai/— AI 연동·Feed 관련 설계·결정·구현 기록 (AI 파트 소유). 하위 구조·문서는 AI 파트가 관리합니다.
백엔드 도메인 작업은 아래의 현재 구현 기준을 따릅니다.
- 데이터베이스 개발 규약 — Flyway의 현재 기준:
V1공통 기반,V2V99백엔드,V100V199AI,V200이후 미할당. core.feed_event소유 —V102(AI 구간)에 정의됨. 백엔드V2~에서 중복 정의 금지(재정의 시already exists).
- P21: Flyway 마이그레이션 파트별 번호 구간 — 과거 결정 기록입니다. 현재 구현 기준으로 사용하지 말고 위 데이터베이스 개발 규약을 따릅니다.
백엔드 공통 규약은 development/에서 관리합니다. 도메인별 설계 문서는 backend/spec/에 추가하고, 시작·검증·PR 규칙은 중복하지 않고 CONTRIBUTING.md를 참조합니다.
공용 계약(원칙·상태값·내부 API·Visibility·AI 데이터 구조)의 단일 원본은 Team-PinLog/docs의 static/05_AI_설계.md입니다. 이 저장소 문서와 충돌하면 공용 계약이 우선합니다.