# Alien Cloud Python (alien_py_cloud)

U宝 V3.0

## 技术栈
- **语言**: Python 3.12+
- **框架**: [FastAPI](https://fastapi.tiangolo.com/)
- **异步**: 基于 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. 安装依赖
```bash
poetry install
```

### 2. 运行项目
```bash
uvicorn main:app --reload
```

### 3. 查看文档
启动后访问：[http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs) (Swagger UI) 或 [/redoc](/redoc)。

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