alien_py_cloud

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_database/: 核心库模块 - 数据库 ORM 模型与持久层基础设施
• alien_entity/: 业务实体定义 (原 alien-entity)，使用 Pydantic 模型 (Schema)
• 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。

重构原则

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