# 算法学习网站

**Repository Path**: zhangming1/algorithm-learning-website

## Basic Information

- **Project Name**: 算法学习网站
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-20
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 算法学习

## README

# AlgoLearn · 交互式算法学习平台

面向算法学习者的 Web 平台：体系化图文课程、算法逐步动画演示、ECharts 数据图表、在线练习评测、学习进度与成就徽章。暗色科技感 UI，桌面与移动端自适应。

## 功能一览

- 📚 课程教学：Markdown 渲染、代码高亮、章节目录、阅读进度
- 🎬 算法可视化：冒泡/选择/插入/快排/归并 + 线性/二分查找，支持播放/单步/调速/拖拽进度/自定义数据，伪代码同步高亮
- 📊 图表分析：复杂度对比曲线、学习趋势、课程完成度雷达、平台统计（ECharts）
- ✍️ 在线练习：单选/判断/填空，即时判分、答案解析、错题本
- 🏅 进度激励：章节完成标记、学习时长统计、连续天数、8 种成就徽章
- 📱 移动端：响应式布局 + 底部 TabBar，触控友好
- 🔐 用户系统：注册/登录（bcrypt + 服务端 Session）、登录限流、管理员角色

## 快速开始

```bash
pip install -r requirements.txt
python run.py
```

浏览器打开 <http://127.0.0.1:8000>

内置账号：

| 账号 | 密码 | 角色 |
| --- | --- | --- |
| test | test | 学员 |
| admin | admin123 | 管理员（可访问 /admin） |

## 配置（环境变量）

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| AM_PORT | 8000 | 服务端口 |
| AM_HOST | 0.0.0.0 | 监听地址 |
| AM_SECRET | 开发默认值 | 生产环境务必修改 |
| AM_DB_PATH | data/app.db | SQLite 数据库路径 |
| AM_RELOAD | 0 | 设为 1 开启热重载 |

## 技术栈

- 后端：Python + FastAPI + SQLite（WAL），Jinja2 模板渲染
- 前端：Vue 3（CDN）+ ECharts + highlight.js，自研暗色玻璃拟态设计系统
- 文档：`docs/01-需求文档.md`（500 条需求，按模块 + P0-P3 优先级）、`docs/02-技术设计文档.md`

## API 文档

启动后访问 <http://127.0.0.1:8000/docs> 查看自动生成的 Swagger UI。

## 生产部署（示例）

```bash
AM_SECRET=<随机密钥> uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 2
```

前置 Nginx 反代并开启 HTTPS 即可。