openapi.yaml 버전 업데이트 및 API 태그 추가, README.md에 openapi.yaml 설명 추가, Python 코드에서 Pydantic 모델 적용 및 API 응답 형식 개선, 불필요한 정적 파일 삭제

Author: tykimos

.gitignore

@@ -403,4 +403,6 @@ FodyWeavers.xsd
 
 # python example
 sns.db
-.DS_Store
+.DS_Store
+
+.venv

README.md

@@ -73,3 +73,31 @@ Contoso 아웃도어 컴파니는 회사의 다양한 아웃도어용 제품 홍
 | Java       | [java](./java/)             |
 | .NET       | [dotnet](./dotnet/)         |
 
+### openapi.yaml에 대한 설명
+
+openapi.yaml 파일은 우리가 만들 웹 API의 설계도라고 생각하면 됩니다. 마치 건물을 짓기 전에 건축 도면이 필요한 것처럼, API를 개발하기 전에 이 파일로 전체 구조를 미리 계획합니다.
+
+이 파일에서는 다음과 같은 내용을 정의합니다:
+- 어떤 기능들(포스트 작성, 댓글 달기, 좋아요 등)을 만들지
+- 각 기능을 사용하려면 어떤 주소(URL)로 요청해야 하는지
+- 요청할 때 어떤 정보가 필요한지(예: 포스트 내용, 사용자 이름)
+- 요청 후 어떤 응답이 돌아오는지
+
+초보자에게 가장 큰 장점은:
+- 개발 전에 API 구조를 명확히 볼 수 있어 전체 그림을 이해하기 쉽습니다
+- 여러 개발자가 같은 규칙으로 작업할 수 있습니다
+- 자동으로 API 문서와 테스트 페이지가 생성됩니다
+- 클라이언트(앱이나 웹) 개발자와 서버 개발자 간의 소통이 쉬워집니다
+
+마치 레고 조립 설명서처럼, 어떤 부품이 어디에 들어가는지 미리 알려주는 역할을 합니다.
+
+openapi.yaml은 SNS 앱을 위한 API 설계도로, 다음 기능들을 정의합니다:
+
+* 포스트 관련 API (5개)
+** 포스트 목록 조회, 작성, 상세 조회, 수정, 삭제
+* 댓글 관련 API (5개)
+** 댓글 목록 조회, 작성, 상세 조회, 수정, 삭제
+* 좋아요 관련 API (2개)
+** 좋아요 추가, 취소
+
+각 API는 필요한 요청 정보와 응답 형식, 오류 처리 방법이 명확히 정의되어 있어 개발 시 일관된 인터페이스를 구현할 수 있습니다.

docs/01-python.md

@@ -2,17 +2,80 @@
 
 ## 시나리오
 
-Contoso 아웃도어 컴파니의 마케팅 팀에서는 제품 홍보를 위한 마이크로 소셜 미디어 웹사이트를 빠르게 론칭하고 싶어 합니다. 개발팀의 Python 개발자인 당신은 GitHub Codespaces 안에서 GitHub Copilot을 이용해 간단한 백엔드 API를 만들어 달라는 요청을 받았습니다.
+Contoso 아웃도어 컴파니의 마케팅 팀에서는 제품 홍보를 위한 마이크로 소셜 미디어 웹사이트를 빠르게 론칭하고 싶어 합니다. 개발팀의 Python 개발자인 당신은 GitHub Codespaces 안에서 GitHub Copilot을 이용해 간단한 백엔드 API를 만들어 달라는 요청을 받았습니다. 이에 따라 FastAPI를 사용하여 SNS 기능을 구현하고, 간단히 SQLite 데이터베이스를 연동해 CRUD를 수행하려고 합니다.
 
 ## 사전 준비사항
 
 [README](../README.md) 문서를 참조하여 개발 환경을 준비합니다.
 
 ## 개발 과정 프롬프트
 
-TBD
+아래는 FastAPI 앱을 개발하여 간단한 SNS 기능을 구현하는 과정입니다.
 
+* FastAPI 앱 프로젝트 준비
+* CRUD API 구현
+* 가상환경으로 앱 실행
+* API 확인
+* 기본 데이터베이스 테이블 생성
 
----
+### FastAPI 앱 프로젝트 준비
+
+1. 가상환경 생성
+
+Python 프로젝트 디렉토리를 생성하고, 다음 명령어로 가상환경(venv)을 만듭니다:
+
+```bash
+python -m venv .venv
+```
+
+2. 가상환경 활성화 및 FastAPI 설치
+
+# Windows
+
+```bash
+.venv\Scripts\activate
+```
+
+# macOS / Linux
+```bash
+source .venv/bin/activate
+```
+
+```bash
+pip install fastapi uvicorn
+```
+
+3. main.py 빈 파일 생성
+
+### CRUD API 구현
+
+FastAPI를 활용하여 소셜 네트워크 서비스의 모든 핵심 기능을 REST API로 구현합니다.
+
+```text
+FastAPI를 사용하여 openapi.yaml 명세를 기반으로 소셜 네트워크 서비스의 백엔드 API를 구현해. openapi.yaml의 정의에 따라 포스트, 댓글, 좋아요 기능을 포함하는 모든 엔드포인트를 구현한다. 명세에 맞게 적절한 HTTP 메소드, 상태 코드, 요청/응답 형식을 구현하낟. Pydantic 모델을 사용하여 데이터 검증을 구현하고, 예외 처리도 포함해주세요. 데이터는 데이터베이스 없이 간단한 메모리로 관리한다.
+```
+
+### 가상환경으로 앱 실행
+
+```bash
+source .venv/bin/activate
+```
+
+```bash
+uvicorn python.main:app --reload
+```
+
+### API 확인
+
+브라우저에서 http://127.0.0.1:8000/docs 접속
+
+### 기본 데이터베이스 테이블 생성
+
+애플리케이션에 필요한 데이터를 저장할 SQLite 데이터베이스 스키마를 구성합니다.
+
+```text
+SQLite 데이터베이스를 사용하여 openapi.yaml 명세를 참고하여 현재 정의된 API를 구현한다. 애플리케이션 시작 시 자동으로 데이터베이스와 테이블을 생성하는 코드를 구현하되, 테이블이 이미 존재하는 경우 다시 생성하지 않도록 'CREATE TABLE IF NOT EXISTS' 구문을 사용하세요. 
+```
+
+서버를 재시작한 후에도 SQLite 데이터베이스에 저장된 포스트 데이터가 유지되는지 확인합니다.
 
-축하합니다! **Python 앱 개발** 실습이 끝났습니다. 이제 [STEP 02: JavaScript 앱 개발](./02-javascript.md) 단계로 넘어가세요.