todos/.claude/skills/gitea-workflow.md

Gitea 워크플로우 (Gitea Workflow)

이 프로젝트의 Gitea 리포지토리 관리 워크플로우입니다.

Gitea 서버 정보

• URL: http://gitea.yakenator.io
• 조직: yakenator
• 사용자: yakenator
• 비밀번호: asdfg23we

새 리포지토리 생성

1. Gitea CLI (tea) 사용

# tea 설치 (macOS)
brew install tea

# 로그인
tea login add --url http://gitea.yakenator.io --user yakenator --password asdfg23we

# 리포지토리 생성
tea repo create --name {repo-name} --org yakenator --private=false

2. API 사용

# 리포지토리 생성
curl -X POST "http://gitea.yakenator.io/api/v1/orgs/yakenator/repos" \
  -H "Content-Type: application/json" \
  -u "yakenator:asdfg23we" \
  -d '{
    "name": "{repo-name}",
    "description": "서비스 설명",
    "private": false,
    "auto_init": false
  }'

3. 웹 UI 사용

1. http://gitea.yakenator.io 접속
2. yakenator / asdfg23we 로 로그인
3. yakenator 조직 선택
4. "New Repository" 클릭
5. 리포지토리 정보 입력 후 생성

새 프로젝트 초기화 및 푸시

전체 워크플로우

# 1. 프로젝트 디렉토리 생성
mkdir ./repos/{new-service}
cd ./repos/{new-service}

# 2. Git 초기화
git init

# 3. 파일 생성 (Dockerfile, requirements.txt, worker.py 등)

# 4. 첫 커밋
git add -A
git commit -m "Initial commit: {service-name} 서비스 초기 구성

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"

# 5. Gitea에 리포지토리 생성 (API)
curl -X POST "http://gitea.yakenator.io/api/v1/orgs/yakenator/repos" \
  -H "Content-Type: application/json" \
  -u "yakenator:asdfg23we" \
  -d '{"name": "{new-service}", "private": false}'

# 6. Remote 추가 및 푸시
git remote add origin http://yakenator:asdfg23we@gitea.yakenator.io/yakenator/{new-service}.git
git branch -M main
git push -u origin main

기존 리포지토리 클론

# HTTP 클론 (인증 포함)
git clone http://yakenator:asdfg23we@gitea.yakenator.io/yakenator/{repo-name}.git

# 또는 클론 후 credential 설정
git clone http://gitea.yakenator.io/yakenator/{repo-name}.git
cd {repo-name}
git config credential.helper store

리포지토리 URL 패턴

http://gitea.yakenator.io/yakenator/{repo-name}.git

현재 등록된 리포지토리

서비스	URL
news-commons	http://gitea.yakenator.io/yakenator/news-commons.git
news-article-generator	http://gitea.yakenator.io/yakenator/news-article-generator.git
news-article-translator	http://gitea.yakenator.io/yakenator/news-article-translator.git
news-biocode-service	http://gitea.yakenator.io/yakenator/news-biocode-service.git
news-google-search	http://gitea.yakenator.io/yakenator/news-google-search.git
news-image-generator	http://gitea.yakenator.io/yakenator/news-image-generator.git
news-rss-collector	http://gitea.yakenator.io/yakenator/news-rss-collector.git
news-tts-generator	http://gitea.yakenator.io/yakenator/news-tts-generator.git
news-wikipedia-enrichment	http://gitea.yakenator.io/yakenator/news-wikipedia-enrichment.git
news-user-service	http://gitea.yakenator.io/yakenator/news-user-service.git
mcp_biocode	http://gitea.yakenator.io/yakenator/mcp_biocode.git
base-auth	http://gitea.yakenator.io/yakenator/base-auth.git
base-image	http://gitea.yakenator.io/yakenator/base-image.git

커밋 및 푸시

# 변경사항 확인
git status

# 스테이징 및 커밋
git add -A
git commit -m "$(cat <<'EOF'
feat: 기능 설명

- 변경사항 1
- 변경사항 2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"

# 푸시
git push

브랜치 전략

# 기본 브랜치: main
# 기능 브랜치: feature/{기능명}
# 버그 수정: fix/{버그설명}

# 브랜치 생성 및 전환
git checkout -b feature/new-feature

# 작업 후 푸시
git push -u origin feature/new-feature

# PR 생성 (웹 UI 또는 API)

주의사항

• 모든 서비스는 yakenator 조직 아래에 생성
• 리포지토리 이름은 news-{서비스명} 패턴 사용
• 민감 정보(.env, credentials)는 절대 커밋하지 않음
• .gitignore에 다음 항목 포함:

  .env
  __pycache__/
  *.pyc
  node_modules/
  .DS_Store