# sutras

**Repository Path**: jade-dragon_1/sutras

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-26
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 佛经阅读网站

一个前后端分离的佛经阅读网站，使用Django REST Framework作为后端API，Vue3 + Vite作为前端框架。

## 功能特性

- 用户认证系统（注册、登录、JWT认证）
- 佛经浏览和阅读
- 分类管理
- 收藏功能
- 阅读历史记录
- 书签管理
- 阅读进度保存
- 阅读设置（字体大小、夜间模式）
- 管理员后台（分类、佛经、章节管理）

## 技术栈

### 后端
- Django 5.2.8
- Django REST Framework
- Django CORS Headers
- JWT认证（djangorestframework-simplejwt）
- SQLite数据库

### 前端
- Vue 3
- Vue Router
- Pinia（状态管理）
- Axios（HTTP请求）
- Vite（构建工具）

## 项目结构

```
beself/              # Django后端项目
├── beself/          # 项目配置
├── sutras/          # 佛经应用
├── accounts/        # 用户账户应用
└── manage.py

beself_front/        # Vue前端项目
├── src/
│   ├── api/         # API封装
│   ├── router/      # 路由配置
│   ├── stores/      # Pinia状态管理
│   ├── views/       # 页面组件
│   └── components/  # 公共组件
└── vite.config.js
```

## 安装和运行

### 后端设置

1. 进入后端目录：
```bash
cd beself
```

2. 创建虚拟环境（如果还没有）：
```bash
python -m venv .venv
```

3. 激活虚拟环境：
```bash
# Windows
.venv\Scripts\activate

# Linux/Mac
source .venv/bin/activate
```

4. 安装依赖：
```bash
pip install -r requirements.txt
```

5. 运行数据库迁移：
```bash
python manage.py migrate
```

6. 创建超级用户（管理员）：
```bash
python manage.py createsuperuser
```

7. 启动开发服务器：
```bash
python manage.py runserver
```

后端将在 http://localhost:8000 运行

### 前端设置

1. 进入前端目录：
```bash
cd beself_front
```

2. 安装依赖：
```bash
npm install
```

3. 启动开发服务器：
```bash
npm run dev
```

前端将在 http://localhost:5173 运行

## API端点

### 用户认证
- `POST /api/accounts/register/` - 用户注册
- `POST /api/accounts/login/` - 用户登录
- `GET /api/accounts/profile/` - 获取用户信息
- `PUT /api/accounts/profile/` - 更新用户信息

### 佛经相关
- `GET /api/categories/` - 获取分类列表
- `GET /api/sutras/` - 获取佛经列表（支持搜索和筛选）
- `GET /api/sutras/:id/` - 获取佛经详情
- `GET /api/sutras/:id/chapters/` - 获取章节列表
- `POST /api/sutras/:id/favorite/` - 收藏佛经
- `DELETE /api/sutras/:id/favorite/` - 取消收藏
- `GET /api/chapters/:id/` - 获取章节详情
- `POST /api/chapters/:id/reading_history/` - 更新阅读历史
- `GET /api/reading-histories/` - 获取阅读历史
- `GET /api/bookmarks/` - 获取书签列表
- `POST /api/bookmarks/` - 创建书签
- `DELETE /api/bookmarks/:id/` - 删除书签

### 管理员API（需要管理员权限）
- `GET /api/admin/categories/` - 获取分类列表
- `POST /api/admin/categories/` - 创建分类
- `PUT /api/admin/categories/:id/` - 更新分类
- `DELETE /api/admin/categories/:id/` - 删除分类
- `GET /api/admin/sutras/` - 获取佛经列表
- `POST /api/admin/sutras/` - 创建佛经
- `PUT /api/admin/sutras/:id/` - 更新佛经
- `DELETE /api/admin/sutras/:id/` - 删除佛经
- `GET /api/admin/chapters/` - 获取章节列表
- `POST /api/admin/chapters/` - 创建章节
- `PUT /api/admin/chapters/:id/` - 更新章节
- `DELETE /api/admin/chapters/:id/` - 删除章节

## 使用说明

1. **普通用户**：
   - 访问首页浏览佛经
   - 注册/登录账户
   - 收藏喜欢的佛经
   - 阅读佛经并自动保存阅读进度
   - 添加书签
   - 查看阅读历史

2. **管理员**：
   - 访问 `/admin` 登录管理后台
   - 管理分类、佛经和章节
   - 创建、编辑、删除内容

## 注意事项

- 确保后端和前端服务都在运行
- 首次运行需要创建数据库迁移和超级用户
- 管理员账户需要通过 `createsuperuser` 命令创建
- 前端开发服务器已配置代理，API请求会自动转发到后端

## 开发

- 后端API文档：访问 http://localhost:8000/api/ （如果配置了DRF的API文档）
- Django管理后台：http://localhost:8000/admin/
- 前端开发服务器：http://localhost:5173