company-celebration/CLAUDE.md

Company Celebration 项目指南

项目概述

年会庆典系统，包含投票、抽奖、大屏展示等功能。

技术栈

• 前端: Vue 3 + TypeScript + Vite
• 后端: Node.js + Express + Socket.IO
• 数据库: MySQL + Redis
• 部署: PM2

项目结构

packages/
├── client-mobile/   # 移动端（投票、扫码登录）
├── client-screen/   # 大屏端（展示、管理控制台）
├── server/          # 后端服务
└── shared/          # 共享类型和常量

---

运维部署流程

服务器信息

• SSH 别名: vote
• 项目目录: /root/company-celebration
• 进程管理: PM2 (gala-server)

标准部署流程

# 1. 本地提交并推送
git add <files>
git commit -m "commit message"
git push origin main

# 2. SSH 到服务器拉取代码
ssh vote "cd /root/company-celebration && git pull"

# 3. 构建项目
ssh vote "cd /root/company-celebration && pnpm build"

# 4. 重启服务
ssh vote "pm2 restart all && pm2 status"

常见问题处理

服务器有本地修改冲突

ssh vote "cd /root/company-celebration && git stash && git pull"

构建失败

1. 检查 TypeScript 类型错误
2. 本地修复后重新提交推送
3. 服务器重新拉取构建

查看服务状态

ssh vote "pm2 status"
ssh vote "pm2 logs gala-server --lines 50"

---

开发规范

类型定义

• 共享类型定义在 packages/shared/src/types/
• 修改类型后需确保所有引用处同步更新

提交规范

使用 Conventional Commits:

• feat: 新功能
• fix: 修复
• chore: 杂项
• refactor: 重构