Alien Cloud Python (alien_py_cloud)

U宝后端 V3.0

技术栈

语言: Python 3.12+
框架: FastAPI
异步: 基于 Python asyncio
依赖管理: Poetry
数据库 ORM: SQLAlchemy 2.0
数据校验: Pydantic v2
认证: JWT (python-jose)

项目结构 (扁平化模块设计)

为了保持原 Java 项目的业务逻辑，我们采用了扁平化的模块化布局：

alien_store/: 核心业务 - 门店管理 (原 alien-store)
alien_store_platform/: 核心业务 - 商户平台 (原 alien-store-platform)
alien_second/: 核心业务 - 二手交易模块 (原 alien-second)
alien_lawyer/: 核心业务 - 律师服务模块 (原 alien-lawyer)
alien_entity/: 业务实体定义 (原 alien-entity)，使用 Pydantic 模型
alien_gateway/: 网关功能 (原 alien-gateway)，包含全局配置、鉴权、中间件
alien_util/: 通用工具类 (原 alien-util)
common/: 跨模块共享的内部组件（如数据库连接池、基类等）
main.py: FastAPI 应用入口

快速开始

1. 安装依赖

poetry install

2. 运行项目

uvicorn main:app --reload

3. 查看文档

启动后访问：http://127.0.0.1:8000/docs (Swagger UI) 或 /redoc。

重构原则

Snake Case: 所有命名从 Java 的 Kebab-case (alien-store) 转换为 Python 的 Snake Case (alien_store)。
异步优先: 充分利用 FastAPI 的 async def 处理 I/O 密集型任务。
职责单一: 每个模块保持高内聚，低耦合。