Skip to content

AGENTS.md

Latest commit

 

History

History
58 lines (42 loc) · 2.08 KB

AGENTS.md

File metadata and controls

58 lines (42 loc) · 2.08 KB

Trackly Platform Meta Notes

이 리포지토리는 Trackly 백엔드와 프론트엔드를 각각 독립 저장소로 분리한 뒤, Git submodule로 연결해 관리하는 상위 프로젝트입니다. 실제 애플리케이션 개발은 각 서브모듈 저장소에서 진행하며, 이 문서는 상위 프로젝트 관점의 운영 정보를 정리합니다.

구성

.
├── Trackly-Backend/    # Project-Trackly/Trackly-Backend 서브모듈
├── Trackly-Frontend/   # Project-Trackly/Trackly-Frontend 서브모듈
├── AGENTS.md           # 현재 문서 (메타 정보)
├── README.md           # 상위 프로젝트 개요
└── .gitmodules         # 서브모듈 정보

각 하위 저장소에는 별도의 AGENTS.md가 존재하며, 백엔드/프론트엔드 세부 개발 지침은 해당 문서를 참고하세요.

서브모듈 워크플로우

최초 클론

git clone https://github.com/Team-Trackly/platform.git
cd platform
git submodule update --init --recursive

조직/원격 변경 후 동기화

git remote set-url origin https://github.com/Team-Trackly/platform
git submodule sync --recursive
git submodule update --init --recursive

서브모듈 업데이트

각 서브모듈 디렉터리에서 커밋·푸시 후, 루트 저장소에서 해당 서브모듈 변경 사항을 커밋합니다.

# 예: 백엔드 변경
cd Trackly-Backend
# ... 작업 및 커밋, push
cd ..
git add Trackly-Backend
git commit -m "Update backend submodule"

문서 위치

  • Trackly-Backend/AGENTS.md: Spring Boot 백엔드 개발 가이드
  • Trackly-Frontend/AGENTS.md: Next.js 프런트/관리자 콘솔 개발 가이드
  • README.md: 상위 프로젝트 소개 및 구조

기타 메모

  • 루트 저장소에는 더 이상 애플리케이션 코드가 포함되지 않습니다. 모든 코드 변경은 해당 서브모듈 저장소에서 처리하세요.
  • 서브모듈의 main 브랜치가 최신 상태인지 확인한 뒤, 상위 저장소에서 버전 태그를 관리하면 릴리즈 추적이 용이합니다.