# t7cr

**Repository Path**: HyPerCoding/t7cr

## Basic Information

- **Project Name**: t7cr
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-26
- **Last Updated**: 2026-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# T7CR 餐厅评分系统

T7CR 是一个基于 Django 开发的异步餐厅评分系统，提供菜品、商户、标签、评分等管理功能，支持用户权限控制和 API 接口交互。

## 项目简介

T7CR (T7 Classification Rating) 是一个为餐厅评价场景设计的 Web 后端系统，采用 Django 框架开发，支持异步操作。系统包含完整的用户权限体系、商户菜品管理、评分系统以及问题反馈机制。

## 技术栈

- **框架**: Django
- **异步支持**: Django 异步视图
- **数据库**: SQLite (默认，可切换)
- **Python**: 3.10+

## 功能特性

### 用户系统
- 用户注册与登录
- 会话 token 管理
- 权限控制 (管理员、普通用户、终端用户、评分权限等)
- 用户封禁机制

### 商户管理
- 创建、修改、删除商户
- 商户列表查询 (分页)

### 菜品管理
- 创建、修改、删除菜品
- 菜品与商户关联
- 菜品列表查询 (分页)
- 菜品统计查询

### 标签系统
- 创建、修改、删除标签
- 标签分为正向和负向
- 评分时关联标签

### 评分系统
- 菜品评分 (1-5分)
- 每日评分去重机制
- 评分统计更新

### 问题反馈
- Wanted: 想要的菜品类型
- Unfair: 不公平的评分申诉

### 餐饮计划
- 餐饮方案创建与管理
- 关联多道菜品

## 项目结构

```
t7cr/
├── main/                    # 主应用
│   ├── api/                # API 接口
│   │   ├── base/           # 基础组件 (异常、工具、参数定义)
│   │   ├── dish/           # 菜品相关 API
│   │   ├── issue/          # 问题反馈 API
│   │   ├── meal/           # 餐饮方案 API
│   │   ├── merchant/       # 商户相关 API
│   │   ├── rating/         # 评分相关 API
│   │   ├── tag/            # 标签相关 API
│   │   └── user/           # 用户相关 API
│   └── tests/              # 单元测试
├── rating/                 # 评分数据模型
│   ├── models.py           # 数据模型定义
│   └── util/               # 工具函数
├── user/                   # 用户模型与应用
│   ├── models.py           # 用户与权限模型
│   └── tools/              # 用户工具函数
├── template/               # 前端模板
├── t7cr/                   # Django 项目配置
└── manage.py               # 管理脚本
```

## 快速开始

### 安装依赖

```bash
pip install django
```

### 数据库初始化

```bash
python manage.py migrate
```

### 创建管理员

```bash
python manage.py createsuperuser
```

### 运行开发服务器

```bash
python manage.py runserver
```

## API 接口

### 用户接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/user/register` | POST | 用户注册 | 公开 |
| `/api/user/login` | POST | 用户登录 | 公开 |
| `/api/user/logout` | POST | 用户登出 | 需认证 |
| `/api/user/alter` | POST | 修改用户信息 | 需认证 |

### 商户接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/merchant/create` | POST | 创建商户 | 员工 |
| `/api/merchant/alter` | POST | 修改商户 | 员工 |
| `/api/merchant/remove` | POST | 删除商户 | 员工 |
| `/api/merchant/getlist` | POST | 获取商户列表 | 需认证 |

### 菜品接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/dish/create` | POST | 创建菜品 | 员工 |
| `/api/dish/alter` | POST | 修改菜品 | 员工 |
| `/api/dish/remove` | POST | 删除菜品 | 员工 |
| `/api/dish/getlist` | POST | 获取菜品列表 | 需认证 |
| `/api/dish/tag_issue_query` | POST | 标签问题查询 | 员工 |

### 标签接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/tag/create` | POST | 创建标签 | 员工 |
| `/api/tag/alter` | POST | 修改标签 | 员工 |
| `/api/tag/remove` | POST | 删除标签 | 员工 |
| `/api/tag/getlist` | POST | 获取标签列表 | 需认证 |

### 评分接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/rating/create` | POST | 创建评分 | 评分权限 |
| `/api/rating/remove` | POST | 删除评分 | 员工 |

### 问题接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/issue/create` | POST | 创建问题 | 需认证 |

### 餐饮方案接口

| 接口 | 方法 | 说明 | 权限 |
|------|------|------|------|
| `/api/meal/create` | POST | 创建餐饮方案 | 需认证 |
| `/api/meal/alter` | POST | 修改餐饮方案 | 需认证 |
| `/api/meal/remove` | POST | 删除餐饮方案 | 需认证 |
| `/api/meal/getlist` | POST | 获取餐饮方案列表 | 需认证 |
| `/api/meal/getall` | POST | 获取所有餐饮方案 | 需认证 |

## 权限说明

系统定义了以下权限:

- `Root`: 超级管理员，拥有所有权限
- `Admin`: 管理员，可管理所有数据
- `Staff`: 员工，可创建、修改、删除数据
- `Rater`: 评分权限，可进行评分
- `Terminal`: 终端权限，可绕过部分限制
- `Merchant`: 商户权限

## 测试

运行测试:

```bash
python manage.py test
```

## 许可证

别用，容易坏。