# millet-svr

**Repository Path**: netxtgr/millet-svr

## Basic Information

- **Project Name**: millet-svr
- **Description**: The system developed for an environmental protection technology company specializing in water treatment, They made the dead animals return to nature harmlessly.
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-04
- **Last Updated**: 2025-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Millet 宠物殡葬服务平台

Millet是一个宠物殡葬服务平台，提供宠物丧葬救助、公益捐赠、宠物档案管理、殡葬服务等功能。

## 功能模块

1. 公益捐赠：接受社会团体或个人现金捐赠，用于宠物丧葬救助
2. 合作机构管理：与我们合作的公益救助机构
3. 宠物丧葬救助：接受申请人或举报人申请，无偿处理死亡动物尸体，免于环境污染
4. 宠物档案：记录宠物的基本信息
5. 宠物殡葬套餐：殡葬服务的组合，套餐定义和套餐明细的定义在字典表维护
6. 殡葬订单：预定宠物殡葬的时间、地点、方式等
7. 订单支付：完成殡葬服务订单的收款或退款明细记录
8. 用户管理：用户在本应用中的基本信息
9. 认证授权：采用微信开放平台绑定公众号和小程序，获取用户授权
10. 数据字典：设置常量，维护常量的关系，并在应用中使用
11. 地理位置记录：记录经纬度数据
12. 图片库：保存图片和视频的链接，图片和视频文件保存在本地

## 技术栈

- 后端：Python 3.13+, Flask, SQLAlchemy
- 数据库：MySQL 8.0+
- 会话管理：Flask-Session (基于文件系统)
- 文件存储：本地文件系统

## 环境要求

- Python 3.13+
- MySQL 8.0+
- 虚拟环境工具 (如 venv, virtualenv)

## 安装步骤

1. 克隆项目

```bash
git clone https://github.com/yourusername/millet.git
cd millet
```

2. 创建并激活虚拟环境

```bash
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
```

3. 安装依赖

```bash
pip install -r requirements.txt
```

4. 配置数据库

创建MySQL数据库：

```sql
CREATE DATABASE millet CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

5. 初始化数据库

```bash
python init_db.py
```

6. 运行应用

```bash
python run.py
```

应用将在 http://localhost:5000 运行。

## 项目结构

```
millet/
├── app/                    # 应用主目录
│   ├── blueprints/         # 蓝图 (路由)
│   ├── models/             # 数据模型
│   ├── services/           # 业务逻辑
│   ├── common/             # 公共模块
│   ├── extensions/         # 扩展模块
│   └── __init__.py         # 应用工厂
├── config.py               # 配置文件
├── init_db.py              # 数据库初始化脚本
├── requirements.txt        # 依赖列表
├── run.py                  # 应用入口
└── README.md               # 项目说明
```

## API文档

API接口遵循RESTful风格，主要包括以下几类：

1. 用户管理接口 `/api/v1/user/*`
2. 微信相关接口 `/api/v1/wx/*`
3. 捐赠相关接口 `/api/v1/donation/*`
4. 宠物相关接口 `/api/v1/pet/*`
5. 文件上传接口 `/api/v1/file/*`
6. 数据字典接口 `/api/v1/dict/*`

详细API文档请参考项目文档。

## 配置说明

项目配置在 `config.py` 文件中，主要包括：

- 数据库配置
- 微信配置
- 文件上传配置
- 日志配置

可以通过环境变量覆盖默认配置。

## 开发指南

1. 代码规范遵循PEP 8
2. 使用Git Flow工作流
3. 提交前运行单元测试
4. 遵循模块化和分层设计原则

## 许可证

MIT