# CppServer

**Repository Path**: wwwcyyy/cpp-server

## Basic Information

- **Project Name**: CppServer
- **Description**: No description available
- **Primary Language**: C++
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<<<<<<< HEAD
# CourseManager 项目文档索引

欢迎来到 CourseManager 项目！这是一个基于 C++11 的客户端 - 服务器架构系统。

## 📚 文档导航

### 快速开始
- **[QUICK_START.md](QUICK_START.md)** ⭐ **推荐先看** - 5 分钟快速上手指南
  - 一键编译和运行
  - 常用命令速查
  - 典型使用场景

### 开发指南
- **[docs/BUILD_GUIDE.md](docs/BUILD_GUIDE.md)** - 详细构建指南
  - 完整的编译配置说明
  - 故障排查方法
  - 高级构建选项

- **[docs/BUILD_VERIFICATION.md](docs/BUILD_VERIFICATION.md)** - 构建验证文档
  - 构建输出验证
  - 配置检查清单

### 系统文档
- **[docs/LOG_SYSTEM_GUIDE.md](docs/LOG_SYSTEM_GUIDE.md)** - 日志系统说明
  - 日志输出位置
  - 日志格式和配置
  - 故障排查指南

- **[docs/README_FORMAT.md](docs/README_FORMAT.md)** - 代码格式化指南
  - VSCode 插件安装
  - 一键格式化配置
  - 格式化规则说明

## 🚀 快速开始

```bash
# 1. 编译项目
./build.sh -c

# 2. 启动服务器
./run.sh server

# 3. 启动客户端（新终端）
./run.sh client
```

## 📁 项目结构

```
CourseManager/
├── src/           # 源代码目录
├── bin/           # 可执行文件输出目录
├── build/         # CMake 构建中间文件
├── conf/          # 配置文件目录
├── log/           # 日志文件输出目录
├── docs/          # 📚 项目文档目录
├── build.sh       # 自动化构建脚本
├── run.sh         # 快速启动脚本
└── QUICK_START.md # 快速入门指南
```

## 🛠️ 核心功能

- ✅ **C/S 架构**: 基于 TCP 的客户端 - 服务器通信
- ✅ **线程池**: 高效的任务调度和并发处理
- ✅ **事件驱动**: epoll 实现的高性能事件循环
- ✅ **数据库支持**: MySQL 数据库访问
- ✅ **日志系统**: 按日期轮转的日志记录
- ✅ **TLV 协议**: 标准化的数据包格式
- ✅ **跨平台**: 支持 Linux 系统

## 📖 推荐阅读顺序

1. **新手用户**: [QUICK_START.md](QUICK_START.md) → [docs/BUILD_GUIDE.md](docs/BUILD_GUIDE.md)
2. **开发者**: [docs/README_FORMAT.md](docs/README_FORMAT.md) → [docs/BUILD_GUIDE.md](docs/BUILD_GUIDE.md)
3. **运维人员**: [docs/LOG_SYSTEM_GUIDE.md](docs/LOG_SYSTEM_GUIDE.md)

## 🔧 开发环境配置

### 必需工具
- CMake 3.10+
- GCC/G++ 7.0+
- Make
- MySQL 客户端库

### 推荐工具
- VSCode + C/C++ 插件
- clang-format（代码格式化）

详细配置请参考 [docs/README_FORMAT.md](docs/README_FORMAT.md)

## 💡 常见问题

### Q: 如何清理构建？
```bash
./build.sh -c
```

### Q: 日志文件在哪里？
默认在项目根目录的 `log/` 子目录中，按日期自动分割。

### Q: 如何查看帮助信息？
```bash
./build.sh -h    # 查看编译帮助
./run.sh -h      # 查看运行帮助
```

## 📝 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

**祝你使用愉快！** 🎉

如有问题，请查阅相关文档或联系项目维护者。