# sanic-mvc

**Repository Path**: chenbool/sanic-mvc

## Basic Information

- **Project Name**: sanic-mvc
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-11-12
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sanic MVC

基于 [Sanic](https://github.com/sanic-org/sanic) 框架的轻量级 MVC 架构项目。

## 技术栈

| 类别 | 技术 |
|------|------|
| Web 框架 | Sanic |
| ORM | Tortoise-ORM |
| 模板引擎 | Sanic-Jinja2 |
| Session | Sanic-Session |
| 数据库 | MySQL + PyMySQL |
| SQL 执行 | Records |

## 项目结构

```
sanic-mvc/
├── app/                    # 应用核心目录
│   ├── controller/         # 控制器层
│   │   ├── admin/          # 后台管理模块
│   │   ├── api/            # API 接口模块
│   │   └── index/          # 前台首页模块
│   ├── model/              # 数据模型层
│   ├── view/               # 视图模板目录
│   ├── __init__.py         # 应用初始化
│   └── config.py           # 配置文件
├── util/                   # 工具函数
│   ├── __init__.py         # 工具模块导出
│   └── help.py             # 辅助函数
├── main.py                 # 应用入口
├── requirements.txt        # 依赖列表
└── moji.sql                # 数据库表结构
```

## 快速开始

### 1. 安装依赖

```bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt
```

### 2. 配置数据库

在 `.env` 文件中配置数据库连接信息：

```env
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASS=your_password
DB_NAME=moji
DB_CHARTSET=utf8mb4
PORT=8000
```

### 3. 启动服务

```bash
python main.py
```

服务启动后访问 `http://127.0.0.1:8000`

## 路由说明

| 模块 | 路径 | 说明 |
|------|------|------|
| 前台首页 | `/` `/index` | 展示页面 |
| 后台管理 | `/admin` | 管理后台 |
| API 接口 | `/api` | 数据接口 |

## API 示例

```bash
# 获取列表
GET /api/

# 获取详情
GET /api/edit/<id>
```

## License

MIT License