root 164326ce76 docs: add comprehensive documentation
- Add docstrings to models and main.py
- Create API.md with detailed endpoint documentation
- Create CHANGELOG.md for version tracking
- Enhance FastAPI app metadata (description, version, tags)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-07 08:35:44 +08:00

19 lines
438 B
Python

"""数据模型定义。
定义 API 请求和响应使用的 Pydantic 模型。
"""
from pydantic import BaseModel
from typing import Optional
class Item(BaseModel):
"""项目完整数据模型,包含 ID。"""
id: Optional[int] = None
name: str
description: Optional[str] = None
class ItemCreate(BaseModel):
"""创建项目的请求模型,不包含 ID。"""
name: str
description: Optional[str] = None