• 목차
• 🟥 Epic 1 — Task 2
  • 🎉 Gitea 저장소 생성 및 초기 커밋 (Markdown 설명형)
    • 📌 작업 개요
    • 🎯 작업 목적
    • 📁 진행 내용
      • 🗂️ 1. Gitea 저장소 생성
      • 🗂️ 2. 로컬 개발 환경에서 프로젝트 초기 구조 생성
      • 🗂️ 3. .gitignore 구성
      • 🗂️ 4. README.md 작성
      • 🗂️ 5. PyCharm에서 Gitea 연동
      • 🗂️ 6. 초기 커밋 수행
    • 📌 산출물

🟥 Epic 1 — Task 2¶

🎉 Gitea 저장소 생성 및 초기 커밋 (Markdown 설명형)¶

📌 작업 개요¶

• FastAPI 기반 mgmt 서버 개발을 위한 프로젝트 저장소를 Gitea에 생성하고,
  앞서 정의한 디렉토리 구조를 실제 파일로 구성하여 초기 커밋을 수행하는 단계이다.
• 이 작업은 전체 개발의 출발점이며, 이후 모든 기능 개발의 기반이 된다.

🎯 작업 목적¶

• FastAPI 프로젝트를 버전 관리 체계(Gitea)에 정식 등록한다.

• 디렉토리 구조를 실제 파일로 구성하여 개발 환경을 표준화한다.

• PyCharm과 Gitea를 연동하여 개발-커밋-배포 흐름을 안정적으로 만든다.

• README, .gitignore 등 기본 문서를 포함하여 프로젝트 품질 기반을 마련한다.

📁 진행 내용¶

🗂️ 1. Gitea 저장소 생성¶

Gitea 웹 UI에서 새로운 Repository 생성

Repository Name: mgmt-fastapi-server

Visibility: Private

Description: FastAPI 기반 mgmt 서버 및 MQTT worker 프로젝트

기본 브랜치: main

필요 시 develop 브랜치 추가

🗂️ 2. 로컬 개발 환경에서 프로젝트 초기 구조 생성¶

앞서 Task 1에서 정의한 디렉토리 구조를 실제로 생성한다.

mgmt-fastapi-server/
│
├─ app/
│   ├─ main.py
│   ├─ db.py
│   ├─ models/
│   ├─ routers/
│   ├─ core/
│   └─ schemas/
│
├─ worker/
│   ├─ mqtt_worker.py
│   └─ handlers/
│
├─ scripts/
├─ systemd/
├─ tests/
├─ .env
├─ requirements.txt
└─ README.md

🗂️ 3. .gitignore 구성¶

Python + PyCharm + venv 기준으로 작성한다.

예시:

.venv/
__pycache__/
.idea/
*.log
.env

🗂️ 4. README.md 작성¶

프로젝트 개요, 구조, 실행 방법 등을 간단히 정리한다.

예시:

# mgmt-fastapi-server
FastAPI 기반 mgmt 서버 및 MQTT worker 프로젝트

🗂️ 5. PyCharm에서 Gitea 연동¶

• VCS → Git → Enable Version Control

• Gitea SSH Key 등록

• Remote origin 추가

• 첫 Push 테스트

🗂️ 6. 초기 커밋 수행¶

커밋 메시지 예시:

[Init] FastAPI 프로젝트 초기 구조 생성 (#Task2)

📌 산출물¶

• Gitea 저장소 생성 완료

• FastAPI 프로젝트 초기 구조 생성

• .gitignore, README.md 포함

• 첫 커밋 및 Push 완료

• PyCharm ↔ Gitea 연동 완료