# AutoWiki

**Repository Path**: pei6/AutoWiki

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 车百科 (AutoWiki)

车控术语众筹百科网站，面向汽车控制领域的轻量化术语参考平台。

## 项目简介

车百科是一个采用维基众筹模式的汽车控制术语百科网站，通过用户贡献内容 + AI自动优化的方式，解决行业术语不统一、解释不标准的问题。

### 核心特性

- 📚 **术语百科** - 轻量型术语解释 + 案例说明
- 👥 **众筹模式** - 任何人可以提交术语、发表评论
- 🤖 **AI驱动** - AI自动审核评论，有效内容实时合并
- 💾 **数据持久化** - 完整的关系型数据库存储
- ⏪ **版本回退** - 记录所有变更，支持管理员回退

## 技术栈

### 前端
- **Vue 3** - 渐进式JavaScript框架
- **Vite** - 下一代前端构建工具
- **Element Plus** - Vue 3 UI组件库
- **Vue Router** - 官方路由管理器
- **Axios** - HTTP客户端

### 后端
- **FastAPI** - 高性能Python Web框架
- **SQLAlchemy** - ORM框架
- **Pydantic** - 数据验证库
- **JWT** - JSON Web Token认证
- **bcrypt** - 密码加密

### 数据库
- **SQLite** (开发) / **MySQL** (生产)

### AI集成
- **通义千问 API** - AI评论审核与内容合并

## 项目结构

```
AutoWiki/
├── backend/              # 后端服务
│   ├── app/             # 应用代码
│   │   ├── core/        # 核心模块（日志、配置等）
│   │   ├── models/      # 数据模型
│   │   ├── routers/     # API路由
│   │   ├── schemas/     # Pydantic模式
│   │   └── services/    # 业务服务
│   ├── database/        # 数据库初始化
│   ├── scripts/         # 工具脚本
│   └── tests/           # 测试代码
├── frontend/            # 前端应用
│   ├── src/
│   │   ├── components/  # Vue组件
│   │   ├── views/       # 页面视图
│   │   ├── router/      # 路由配置
│   │   └── api/         # API调用
└── doc/                 # 文档
```

## 快速开始

### 环境要求

- Python 3.8+
- Node.js 16+
- npm 或 yarn

### 后端启动

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

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

# 复制环境变量示例
cp .env.example .env
# 编辑 .env 配置文件

# 初始化数据库
python app/database.py

# 创建管理员账号
python scripts/create_admin.py

# 导入术语数据
python scripts/import_terms.py

# 启动服务
python run.py
# 或
uvicorn app.main:app --reload
```

后端服务将在 `http://localhost:8000` 启动

### 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

前端服务将在 `http://localhost:5173` 启动

## 默认账号

- **管理员账号**: admin / admin123

## API文档

后端启动后，访问以下地址查看API文档：
- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

## 开发指南

### 编码规范

请参考 `.trae/rules/编码规范.md` 了解详细的编码规范。

### 测试

```bash
cd backend
pytest
```

## 文档

更多详细文档请查看 `doc/` 目录：
- [需求分析](doc/需求分析.md)
- [软件架构与实现](doc/软件架构与实现.md)
- [部署指南](doc/部署指南.md)
- [重构计划](doc/重构计划.md)

## 许可证

本项目仅供学习和研究使用。

## 贡献

欢迎提交 Issue 和 Pull Request！