# gtsc_dev_playground

**Repository Path**: pipboy492/gtsc_dev_playground

## Basic Information

- **Project Name**: gtsc_dev_playground
- **Description**: 数产研发游乐场，拓展数产研发文化
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-24
- **Last Updated**: 2025-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📝 数产研发游乐场 - 留言板

> 想啥说啥，该喷喷 - 一个开放的技术交流平台

## 📋 项目简介

这是一个完全开放的留言板项目，专注于数产研发相关的技术交流与分享。所有团队成员都可以在这里畅所欲言，分享技术见解、讨论项目进展、提出改进建议。

## 🎯 项目特色

- ✅ **完全开放** - 所有人都能编辑和贡献
- ✅ **技术导向** - 专注于数产研发技术讨论
- ✅ **实时交流** - 支持实时留言和回复
- ✅ **简单易用** - 清晰的界面设计，降低使用门槛
- ✅ **可扩展性** - 模块化设计，便于功能扩展

## 🏗️ 项目结构

```
gtsc_dev_playground/
├── 📁 frontend/                    # 前端资源
│   ├── 📁 components/              # 可复用组件
│   │   ├── 📁 common/             # 通用组件
│   │   └── 📁 message/            # 留言相关组件
│   ├── 📁 pages/                  # 页面组件
│   ├── 📁 assets/                # 静态资源
│   └── 📁 utils/                 # 工具函数
├── 📁 backend/                    # 后端服务
│   ├── 📁 api/                   # API接口
│   ├── 📁 models/                # 数据模型
│   ├── 📁 controllers/           # 控制器
│   ├── 📁 middleware/            # 中间件
│   └── 📁 services/              # 业务逻辑服务
├── 📁 database/                   # 数据库相关
│   ├── 📁 migrations/            # 数据库迁移
│   ├── 📁 seeds/                 # 种子数据
│   └── 📄 schema.sql             # 数据库结构
├── 📁 config/                     # 配置文件
├── 📁 docs/                       # 项目文档
├── 📁 scripts/                    # 脚本文件
├── 📁 tests/                      # 测试文件
├── 📁 public/                     # 公共资源
└── 📄 package.json               # 项目配置
```

## 🚀 快速开始

### 环境要求

- Node.js >= 16.0.0
- npm >= 8.0.0
- MySQL / PostgreSQL / MongoDB

### 安装依赖

```bash
# 安装项目依赖
npm install

# 安装前端依赖
cd frontend && npm install

# 安装后端依赖
cd backend && npm install
```

### 开发环境

```bash
# 启动开发服务器（前端+后端）
npm run dev

# 或者分别启动
npm run dev:frontend  # 启动前端开发服务器
npm run dev:backend   # 启动后端服务器
```

### 生产环境

```bash
# 构建项目
npm run build

# 启动生产服务器
npm start
```

## 📚 文档说明

- 📖 [开发指南](./docs/DEVELOPMENT.md) - 详细的开发规范和流程
- 📁 [目录结构说明](./docs/DIRECTORY_STRUCTURE.md) - 完整的目录结构介绍
- 🔧 [API文档](./docs/API.md) - 接口文档说明
- 🚀 [部署指南](./docs/DEPLOYMENT.md) - 生产环境部署指南

## 🛠️ 技术栈

### 前端技术
- **Vue.js 3** - 现代化的前端框架
- **Vite** - 快速的构建工具
- **Element Plus** - 优秀的UI组件库
- **Pinia** - 状态管理
- **Vue Router** - 路由管理

### 后端技术
- **Node.js** - JavaScript运行环境
- **Express.js** - Web应用框架
- **Sequelize** - ORM数据库操作
- **JWT** - 身份验证
- **Multer** - 文件上传处理

### 开发工具
- **ESLint** - 代码质量检查
- **Prettier** - 代码格式化
- **Jest** - 测试框架
- **Git** - 版本控制

## 🧪 测试

```bash
# 运行所有测试
npm test

# 运行前端测试
npm run test:frontend

# 运行后端测试
npm run test:backend

# 代码检查
npm run lint
```

## 📝 使用指南

### 基本功能
1. **查看留言** - 浏览所有公开的技术讨论
2. **发布留言** - 分享你的技术见解和想法
3. **回复互动** - 参与讨论，回复他人留言
4. **搜索功能** - 快速找到感兴趣的话题

### 代码规范
- 提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/)
- 代码风格遵循 ESLint 配置
- 文件命名采用 kebab-case 或 PascalCase（组件）

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献
1. **Fork** 本项目到你的账户
2. **创建** 功能分支 (`git checkout -b feature/AmazingFeature`)
3. **提交** 你的修改 (`git commit -m 'feat: add some AmazingFeature'`)
4. **推送** 到分支 (`git push origin feature/AmazingFeature`)
5. **创建** Pull Request

### 贡献类型
- 🐛 **Bug修复** - 发现并修复问题
- ✨ **新功能** - 添加新的功能特性
- 📝 **文档改进** - 完善项目文档
- 🎨 **UI优化** - 改进用户界面
- ⚡ **性能优化** - 提升系统性能
- 🧪 **测试增强** - 增加测试覆盖率

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)。

## 📞 联系我们

- 📧 **邮箱**：[项目联系邮箱]
- 💬 **留言板**：[在线留言地址]
- 🐛 **问题反馈**：[GitHub Issues]
- 📖 **项目主页**：[项目主页地址]

---

⭐ 如果这个项目对你有帮助，请给我们一个 Star！

🚀 **Happy Coding!** 🎉