保存数据运营平台后端API相关的Python代码。

maxiaolong b164a7dc6a 更新n8n-MCP工作流开发规则，简化并优化工作流过程，强调模板优先和多级验证策略，增加错误处理和部署阶段的详细说明。		10 月之前
.cursor	b164a7dc6a 更新n8n-MCP工作流开发规则，简化并优化工作流过程，强调模板优先和多级验证策略，增加错误处理和部署阶段的详细说明。	10 月之前
app	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
database	58bf4e2065 新增数据服务模块。	10 月之前
docs	305f7bfa75 新增一个DDLparse的说明文档。	10 月之前
mcp-servers	9c1b50b163 task-manager 修复bug,更新功能为自动完成任务。	11 月之前
release	49421b587d 修复bug	10 月之前
scripts	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
tests	49421b587d 修复bug	10 月之前
.cursorignore	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
.cursorrules	f63043e640 优化Python开发规则规范和项目依赖。	10 月之前
.flake8	82ecd21817 Python代码规范，用ruff和pyright检查代码。	10 月之前
.gitignore	85034e23ba Prepare to modify the translate module.	1 年之前
BUSINESS_RULES.md	1c266e5c18 去掉DataParse模块。添加BusinessDomain模块。	11 月之前
DataOps-platform.code-workspace	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
MANIFEST.in	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
QUICK_START_N8N_TOOLS.md	a21db74ea8 n8n工作流data-governance调整优化	1 年之前
README.md	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
__init__.py	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
application.py	82ecd21817 Python代码规范，用ruff和pyright检查代码。	10 月之前
cursorssh-143	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
cursorssh-143.pub	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
env.example	05c9ad0bf1 微信注册接口修改	1 年之前
pyproject.toml	f63043e640 优化Python开发规则规范和项目依赖。	10 月之前
requirements.txt	33d147ea03 优化Business Domain的DDLparse功能，扩展支持到SQL，Excel，word，PDF文件。	10 月之前
run_project.bat	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
run_project.py	459f062c7c 新增一个获取黄历信息的API接口	1 年之前
setup.py	459f062c7c 新增一个获取黄历信息的API接口	1 年之前

Python项目模板

这是一个现代化的Python项目模板，使用FastAPI框架构建。

项目特性

🚀 FastAPI: 现代、快速的Web框架
🗄️ SQLAlchemy: 强大的ORM框架
🔧 Alembic: 数据库迁移工具
📊 Pandas & NumPy: 数据处理和分析
🧪 Pytest: 测试框架
🎨 Black: 代码格式化
📝 Loguru: 现代化日志系统

快速开始

1. 安装依赖

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境 (Windows)
venv\Scripts\activate

# 激活虚拟环境 (Linux/Mac)
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

2. 环境配置

复制 .env.example 文件为 .env 并配置环境变量：

cp .env.example .env

3. 运行项目

# 开发模式
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 生产模式
uvicorn app.main:app --host 0.0.0.0 --port 8000

4. 访问API文档

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

项目结构

new-python-project/
├── app/                    # 应用主目录
│   ├── __init__.py
│   ├── main.py            # 应用入口
│   ├── api/               # API路由
│   ├── core/              # 核心配置
│   ├── models/            # 数据模型
│   ├── schemas/           # Pydantic模式
│   ├── services/          # 业务逻辑
│   └── utils/             # 工具函数
├── tests/                 # 测试文件
├── alembic/               # 数据库迁移
├── .env.example           # 环境变量示例
├── requirements.txt        # 项目依赖
└── README.md              # 项目说明

开发指南

代码格式化

# 格式化代码
black .

# 检查代码风格
flake8 .

# 类型检查
mypy .

运行测试

# 运行所有测试
pytest

# 运行特定测试文件
pytest tests/test_api.py

# 生成覆盖率报告
pytest --cov=app tests/

数据库操作

创建迁移

alembic revision --autogenerate -m "描述变更"

应用迁移

alembic upgrade head

贡献指南

Fork 项目
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。