# cloud-wing

**Repository Path**: hgf949075148/cloud-wing

## Basic Information

- **Project Name**: cloud-wing
- **Description**: 没事瞎鼓弄的小项目 哈哈哈
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-05
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# cloud wing 项目总览

cloud wing 是一个基于 FastAPI 的后端与简单前端页面的管理系统。

## 目录结构

```
suit-fit/
├── back-end/           # 后端服务（FastAPI）
│   ├── src/            # 后端源码
│   │   ├── config/     # 配置与工具
│   │   ├── db/         # 数据存储（JSON）
│   │   ├── service/    # 业务逻辑
│   │   └── viewmodel/  # Pydantic 数据模型
│   ├── requirements.txt# 后端依赖
│   └── README.md       # 后端说明
├── front-end/          # 前端页面
│   └── docs            # 前端UI库文档
│   └── packages        # 组件库的包
│   └── playground      # 实际项目    
└── README.md           # 项目总览（本文件）
```

## 快速开始

### 后端（FastAPI）
1. 进入 `back-end` 目录，创建并激活虚拟环境：
	```bash
	poetry install
	windows:
	bash: source .\.venv\Scripts\activate
	powershell:  .\.venv\Scripts\activate
	Mac:
	mac OS: source ./.venv/bin/activate
	```
2. 启动后端服务：
	```bash
	poetry run python -B -m src.main
	```
3. 访问接口：
	- 首页: http://127.0.0.1:8000
	- Swagger 文档: http://127.0.0.1:8000/docs

## 主要依赖

后端依赖（见 `back-end/requirements.txt`）：
- fastapi
- uvicorn
- pydantic
- PyJWT
- python-dotenv

## 主要功能模块

- 用户管理（注册、登录、信息更新，JWT 鉴权）
- 物品管理（增删查改）
- 数据存储采用 JSON 文件

## 目录说明

- `back-end/src/config/`：配置、JWT 工具、数据库路径
- `back-end/src/service/`：API 路由与业务逻辑
- `back-end/src/viewmodel/`：Pydantic 数据模型
- `back-end/src/db/`：数据文件（JSON）

## 参考资料

- FastAPI: https://fastapi.tiangolo.com/zh/

---
如需详细后端接口与开发说明，请参考 [back-end/README.md](back-end/README.md)