# ancientPoems

**Repository Path**: sauida/ancient-poems

## Basic Information

- **Project Name**: ancientPoems
- **Description**: 《古诗文专题学习》教学网站后台管理系统
- **Primary Language**: TypeScript
- **License**: MulanPSL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-08-30
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ancientPoems

## 介绍
《古诗文专题学习》教学网站后台管理系统

## 软件架构
前端采用 Vue 3 + TypeScript + Vite 开发，模块化设计，支持国际化语言配置。  
后端采用 Express.js + MySQL，提供 JWT 认证和基于 Joi 的参数校验。

## 功能模块

### 管理系统
- 用户管理：管理员和学生账户的增删改查
- 古诗管理：古诗信息的添加、编辑、删除
- 试题管理：题库维护与随机出题功能
- 成绩管理：测试成绩记录与查询
- 权限控制：基于角色的访问控制

### 学生端
- 登录/注册：学生账户管理
- 在线测试：古诗相关题目作答
- 成绩查询：查看历史测试记录
- 个人中心：管理个人信息和头像

## 安装教程
1. 确保已安装 Node.js 和 pnpm
2. 安装服务端依赖：`cd ancient-poems-server && pnpm install`
3. 安装管理端依赖：`cd ancient-poems-admin && pnpm install`
4. 安装网站端依赖：`cd ancient-poems-web && pnpm install`
5. 配置 MySQL 数据库，导入 `ancient_poems.sql`

## 使用说明
1. 启动服务端：`cd ancient-poems-server && pnpm dev`
2. 启动管理端：`cd ancient-poems-admin && pnpm dev`
3. 启动网站端：`cd ancient-poems-web && pnpm dev`
4. 访问管理端：`http://localhost:5173`
5. 访问学生端：`http://localhost:5174`

## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 特技
1. 支持多语言 README，如 Readme_en.md, Readme_zh.md
2. 使用 Gitee 探索页面发现优秀开源项目
3. 关注 Gitee 官方博客获取最新动态
4. 参考 Gitee 帮助文档了解平台使用方法
5. 展示 Gitee 会员风采的封面人物栏目