1.0

Author: tgs9915

.dockerignore

@@ -0,0 +1,11 @@
+.git
+.gitignore
+node_modules
+npm-debug.log
+dist
+.env
+.env.local
+README.md
+.vscode
+.idea
+*.md

.env.example

@@ -0,0 +1,12 @@
+# 服务器端口
+PORT=3001
+
+# 认证密钥（必需）- 请修改为强密码
+AUTH_KEY=your-secret-auth-key-change-this
+
+# 允许的跨域来源（逗号分隔）
+# 生产环境请设置具体的域名，例如：https://your-domain.com,https://www.your-domain.com
+ALLOWED_ORIGINS=*
+
+# 运行环境
+NODE_ENV=production

.eslintrc.json

@@ -0,0 +1,23 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "no-console": "off"
+  },
+  "env": {
+    "node": true,
+    "es2022": true
+  }
+}

.github/workflows/ci-cd.yml

@@ -0,0 +1,76 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+  build-docker:
+    runs-on: ubuntu-latest
+    needs: lint-and-test
+    if: github.event_name == 'push'
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ secrets.DOCKER_USERNAME }}/watch-room-server:latest
+            ${{ secrets.DOCKER_USERNAME }}/watch-room-server:${{ github.sha }}
+          cache-from: type=registry,ref=${{ secrets.DOCKER_USERNAME }}/watch-room-server:buildcache
+          cache-to: type=registry,ref=${{ secrets.DOCKER_USERNAME }}/watch-room-server:buildcache,mode=max
+
+  deploy-fly:
+    runs-on: ubuntu-latest
+    needs: lint-and-test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Fly
+        uses: superfly/flyctl-actions/setup-flyctl@master
+
+      - name: Deploy to Fly.io
+        run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}

.gitignore

@@ -0,0 +1,43 @@
+# Dependencies
+node_modules/
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Build output
+dist/
+build/
+*.tsbuildinfo
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.pid
+*.seed
+*.pid.lock

CONTRIBUTING.md

@@ -0,0 +1,84 @@
+# 贡献指南
+
+感谢你对 Watch Room Server 项目的关注！
+
+## 如何贡献
+
+### 报告问题
+
+如果你发现了 bug 或有功能建议：
+
+1. 检查 [Issues](https://github.com/your-repo/watch-room-server/issues) 是否已有相关问题
+2. 如果没有，创建新的 Issue
+3. 清晰描述问题或建议
+4. 提供复现步骤（如果是 bug）
+
+### 提交代码
+
+1. Fork 本仓库
+2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启一个 Pull Request
+
+### 代码规范
+
+- 使用 TypeScript
+- 遵循 ESLint 规则
+- 添加适当的注释
+- 保持代码简洁清晰
+
+### 提交信息规范
+
+使用语义化的提交信息：
+
+- `feat:` 新功能
+- `fix:` 修复 bug
+- `docs:` 文档更新
+- `style:` 代码格式调整
+- `refactor:` 代码重构
+- `test:` 测试相关
+- `chore:` 构建/工具相关
+
+示例：
+```
+feat: 添加房间密码加密功能
+fix: 修复心跳检测超时问题
+docs: 更新部署文档
+```
+
+### 开发流程
+
+1. 安装依赖：`npm install`
+2. 启动开发服务器：`npm run dev`
+3. 运行 linter：`npm run lint`
+4. 类型检查：`npm run typecheck`
+5. 构建：`npm run build`
+
+### 测试
+
+在提交 PR 之前，请确保：
+
+- [ ] 代码通过 ESLint 检查
+- [ ] TypeScript 类型检查通过
+- [ ] 构建成功
+- [ ] 功能正常工作
+
+## 行为准则
+
+- 尊重他人
+- 保持友善和专业
+- 接受建设性批评
+- 关注项目最佳利益
+
+## 问题和支持
+
+如有疑问，可以：
+
+- 创建 Issue
+- 发送邮件
+- 加入讨论组
+
+## 许可证
+
+通过贡献代码，你同意你的贡献将在 MIT 许可证下发布。

Dockerfile

@@ -0,0 +1,45 @@
+# 使用 Node.js 18 LTS 作为基础镜像
+FROM node:18-alpine AS builder
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制 package.json 和 lock 文件
+COPY package*.json ./
+
+# 安装依赖
+RUN npm ci --only=production
+
+# 复制源代码
+COPY . .
+
+# 构建 TypeScript
+RUN npm run build
+
+# 生产镜像
+FROM node:18-alpine
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制依赖和构建产物
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./
+
+# 创建非 root 用户
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nodejs -u 1001
+
+# 切换到非 root 用户
+USER nodejs
+
+# 暴露端口
+EXPOSE 3001
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD node -e "require('http').get('http://localhost:3001/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
+
+# 启动应用
+CMD ["node", "dist/index.js"]