collabdocchat 1.1.2 → 1.2.1

package/QUICK_START.md

@@ -0,0 +1,144 @@
+# CollabDocChat 快速启动指南 🚀
+
+## 方法一：使用一键启动脚本（推荐）
+
+### Windows 用户
+
+1. 下载启动脚本：
+   ```bash
+   curl -O https://raw.githubusercontent.com/shijinghao/collabdocchat/main/install-and-start.bat
+   ```
+
+2. 双击运行 `install-and-start.bat`
+
+或者在命令行中运行：
+```bash
+install-and-start.bat
+```
+
+### Linux/Mac 用户
+
+1. 下载启动脚本：
+   ```bash
+   curl -O https://raw.githubusercontent.com/shijinghao/collabdocchat/main/install-and-start.sh
+   chmod +x install-and-start.sh
+   ```
+
+2. 运行脚本：
+   ```bash
+   ./install-and-start.sh
+   ```
+
+---
+
+## 方法二：手动安装并启动
+
+### 1. 安装（跳过 postinstall 脚本）
+
+```bash
+npm install collabdocchat --ignore-scripts
+```
+
+### 2. 启动
+
+```bash
+cd node_modules/collabdocchat
+node scripts/quick-start.js
+```
+
+或者手动分别启动：
+
+**启动后端：**
+```bash
+cd node_modules/collabdocchat
+node server/index.js
+```
+
+**启动前端（新终端）：**
+```bash
+cd node_modules/collabdocchat
+npm run client
+```
+
+**打开浏览器：**
+访问 `http://localhost:5173`
+
+---
+
+## 方法三：一行命令
+
+### Windows (PowerShell)
+
+```powershell
+npm install collabdocchat --ignore-scripts; cd node_modules\collabdocchat; Start-Process node -ArgumentList "server/index.js" -WindowStyle Hidden; Start-Sleep -Seconds 3; Start-Process npm -ArgumentList "run","client" -WindowStyle Hidden; Start-Sleep -Seconds 8; Start-Process "http://localhost:5173"
+```
+
+### Linux/Mac
+
+```bash
+npm install collabdocchat --ignore-scripts && cd node_modules/collabdocchat && node server/index.js & sleep 3 && npm run client & sleep 8 && open http://localhost:5173
+```
+
+---
+
+## 停止服务
+
+### Windows
+
+```bash
+taskkill /F /IM node.exe
+```
+
+### Linux/Mac
+
+```bash
+pkill -f node
+```
+
+或者：
+
+```bash
+cd node_modules/collabdocchat
+npm run stop
+```
+
+---
+
+## 注意事项
+
+- 确保 MongoDB 已启动
+- 确保端口 3000 和 5173 未被占用
+- 首次运行需要配置 `.env` 文件（可选）
+
+---
+
+## 常见问题
+
+### Q: 安装卡住了怎么办？
+
+A: 使用 `--ignore-scripts` 选项：
+```bash
+npm install collabdocchat --ignore-scripts
+```
+
+### Q: 浏览器没有自动打开？
+
+A: 手动访问 `http://localhost:5173`
+
+### Q: 如何查看是否启动成功？
+
+A: 检查端口占用：
+```bash
+# Windows
+netstat -ano | findstr :3000
+netstat -ano | findstr :5173
+
+# Linux/Mac
+lsof -i:3000
+lsof -i:5173
+```
+
+---
+
+**提示**: 推荐使用一键启动脚本，最简单快捷！
+

package/README.md

@@ -1,538 +0,0 @@
-# CollabDocChat
-
-<div align="center">
-
-![CollabDocChat Logo](https://img.shields.io/badge/CollabDocChat-v1.0.0-blue)
-![License](https://img.shields.io/badge/license-MIT-green)
-![Node](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)
-![MongoDB](https://img.shields.io/badge/MongoDB-%3E%3D5.0-green)
-
-**开源的实时协作文档聊天平台**
-
-集成任务管理 · 多人文档编辑 · 智能点名 · 即时通讯
-
-[快速开始](#快速开始) · [功能特性](#功能特性) · [技术栈](#技术栈) · [贡献指南](#贡献指南)
-
-</div>
-
----
-
-## 📖 项目简介
-
-**CollabDocChat** 是一个轻量级的开源协作平台，专为学习和办公场景设计。它将即时通讯、多人实时文档编辑、任务管理和互动点名功能整合在一起，提供一站式的群体协作解决方案。
-
-### 🎯 核心定位
-
-- **轻量级**：相比飞书、钉钉等重型工具，更加简洁易用
-- **开源免费**：完全开源，可自由部署和定制
-- **实时协作**：基于 WebSocket 的实时同步技术
-- **双端权限**：管理员和用户角色分离，权限清晰
-
----
-
-## ✨ 功能特性
-
-### 👨‍💼 管理员端
-
-- **群组管理**
-  - 创建/管理群组
-  - 添加/移除成员
-  - 查看成员在线状态
-
-- **任务管理**
-  - 发布/编辑/终止任务
-  - 关联文档到任务
-  - 查看任务完成进度
-
-- **文档管理**
-  - 上传/共享文档
-  - 设置文档权限（只读/可编辑）
-  - 查看文档编辑日志
-
-- **随机点名**
-  - 单次/批量随机点名
-  - 查看点名历史记录
-  - 实时响应提醒
-
-### 👥 用户端
-
-- **任务接收**
-  - 实时接收任务通知
-  - 查看待完成/已完成任务
-  - 更新任务状态
-
-- **文档协作**
-  - 多人实时编辑文档
-  - 自动同步内容
-  - 查看版本历史
-  - 显示其他用户编辑状态
-
-- **即时通讯**
-  - 群组聊天
-  - 实时消息推送
-  - 点名响应
-
-- **个人中心**
-  - 查看个人任务
-  - 编辑记录
-  - 群组列表
-
----
-
-## 🛠 技术栈
-
-### 后端
-- **Node.js** + **Express** - 服务器框架
-- **MongoDB** + **Mongoose** - 数据库
-- **WebSocket (ws)** - 实时通信
-- **JWT** - 身份认证
-- **Yjs** - CRDT 实时协作算法
-
-### 前端
-- **原生 JavaScript** - 无框架依赖
-- **Vite** - 构建工具
-- **CSS3** - 现代化 UI 设计
-- **WebSocket API** - 实时通信
-
-### 核心技术
-- **CRDT (Conflict-free Replicated Data Type)** - 无冲突文档同步
-- **WebSocket** - 双向实时通信
-- **JWT** - 无状态身份验证
-
----
-
-## 🚀 快速开始
-
-### 环境要求
-
-- Node.js >= 16.0.0
-- MongoDB >= 5.0
-- npm 或 yarn
-
-### 安装步骤
-
-#### 方式一：通过 npm 安装（推荐）
-
-```bash
-# 安装包
-npm install collabdocchat
-
-# 进入安装目录
-cd node_modules/collabdocchat
-
-# 启动应用（自动打开浏览器）
-npm start
-```
-
-#### 方式二：从源码安装
-
-1. **克隆项目**
-
-```bash
-git clone https://github.com/shijinghao/collabdocchat.git
-cd collabdocchat
-```
-
-2. **安装依赖**
-
-```bash
-npm install
-```
-
-3. **配置环境变量**
-
-复制 `.env.example` 为 `.env` 并修改配置：
-
-```bash
-cp .env.example .env
-```
-
-编辑 `.env` 文件：
-
-```env
-PORT=3000
-MONGODB_URI=mongodb://localhost:27017/collabdocchat
-JWT_SECRET=your_super_secret_jwt_key_change_this
-CLIENT_URL=http://localhost:5173
-```
-
-4. **启动 MongoDB**
-
-```bash
-# Windows
-mongod
-
-# macOS/Linux
-sudo systemctl start mongod
-```
-
-5. **启动项目**
-
-```bash
-# 快速启动（推荐）- 自动启动服务器和客户端，并打开浏览器
-npm run quick-start
-
-# 或使用完整启动脚本
-npm start
-
-# 开发模式（同时启动前后端，使用 nodemon 自动重启）
-npm run dev
-
-# 或分别启动
-npm run server  # 后端服务器
-npm run client  # 前端开发服务器
-```
-
-6. **访问应用**
-
-运行 `npm start` 后，浏览器会自动打开并访问 `http://localhost:5173`
-
-或手动访问：`http://localhost:5173`
-
-7. **停止服务**
-
-```bash
-# 停止所有 CollabDocChat 服务
-npm run stop
-
-# 或手动停止（Windows）
-taskkill /F /IM node.exe
-
-# 或手动停止（Linux/Mac）
-pkill -f "node.*server/index.js"
-pkill -f vite
-```
-
----
-
-## 📁 项目结构
-
-```
-CollabDocChat/
-├── server/                 # 后端代码
-│   ├── models/            # 数据模型
-│   │   ├── User.js
-│   │   ├── Group.js
-│   │   ├── Document.js
-│   │   └── Task.js
-│   ├── routes/            # API 路由
-│   │   ├── auth.js
-│   │   ├── groups.js
-│   │   ├── documents.js
-│   │   └── tasks.js
-│   ├── middleware/        # 中间件
-│   │   └── auth.js
-│   ├── websocket/         # WebSocket 处理
-│   │   └── index.js
-│   └── index.js           # 服务器入口
-├── src/                   # 前端代码
-│   ├── pages/            # 页面组件
-│   │   ├── login.js
-│   │   ├── admin-dashboard.js
-│   │   └── user-dashboard.js
-│   ├── services/         # 服务层
-│   │   ├── api.js
-│   │   ├── auth.js
-│   │   └── websocket.js
-│   ├── styles/           # 样式文件
-│   │   └── main.css
-│   └── main.js           # 前端入口
-├── package.json
-├── vite.config.js
-├── .env.example
-└── README.md
-```
-
----
-
-## 🔌 API 文档
-
-### 认证接口
-
-#### 注册
-```http
-POST /api/auth/register
-Content-Type: application/json
-
-{
-  "username": "string",
-  "email": "string",
-  "password": "string",
-  "role": "admin" | "user"
-}
-```
-
-#### 登录
-```http
-POST /api/auth/login
-Content-Type: application/json
-
-{
-  "email": "string",
-  "password": "string"
-}
-```
-
-### 群组接口
-
-#### 获取群组列表
-```http
-GET /api/groups
-Authorization: Bearer {token}
-```
-
-#### 创建群组（管理员）
-```http
-POST /api/groups
-Authorization: Bearer {token}
-Content-Type: application/json
-
-{
-  "name": "string",
-  "description": "string",
-  "members": ["userId1", "userId2"]
-}
-```
-
-#### 随机点名（管理员）
-```http
-POST /api/groups/:id/call
-Authorization: Bearer {token}
-Content-Type: application/json
-
-{
-  "count": 1
-}
-```
-
-### 文档接口
-
-#### 获取群组文档
-```http
-GET /api/documents/group/:groupId
-Authorization: Bearer {token}
-```
-
-#### 创建文档
-```http
-POST /api/documents
-Authorization: Bearer {token}
-Content-Type: application/json
-
-{
-  "title": "string",
-  "content": "string",
-  "groupId": "string",
-  "permission": "readonly" | "editable"
-}
-```
-
-#### 更新文档
-```http
-PATCH /api/documents/:id
-Authorization: Bearer {token}
-Content-Type: application/json
-
-{
-  "content": "string"
-}
-```
-
-### 任务接口
-
-#### 获取我的任务
-```http
-GET /api/tasks/my
-Authorization: Bearer {token}
-```
-
-#### 创建任务（管理员）
-```http
-POST /api/tasks
-Authorization: Bearer {token}
-Content-Type: application/json
-
-{
-  "title": "string",
-  "description": "string",
-  "groupId": "string",
-  "assignedTo": ["userId1"],
-  "relatedDocument": "documentId",
-  "deadline": "2024-12-31"
-}
-```
-
----
-
-## 🔄 WebSocket 事件
-
-### 客户端发送
-
-```javascript
-// 认证
-{ type: 'auth', token: 'jwt_token' }
-
-// 加入群组
-{ type: 'join_group', groupId: 'group_id' }
-
-// 发送聊天消息
-{ type: 'chat_message', groupId: 'group_id', username: 'user', content: 'message' }
-
-// 同步文档
-{ type: 'document_sync', documentId: 'doc_id', content: 'text', cursorPosition: 0 }
-
-// 响应点名
-{ type: 'call_response', groupId: 'group_id', username: 'user' }
-
-// 输入状态
-{ type: 'typing', documentId: 'doc_id', username: 'user', isTyping: true }
-```
-
-### 服务器推送
-
-```javascript
-// 认证成功
-{ type: 'auth_success', userId: 'user_id', role: 'admin' }
-
-// 聊天消息
-{ type: 'chat_message', groupId: 'group_id', userId: 'user_id', username: 'user', content: 'message', timestamp: 'ISO8601' }
-
-// 文档更新
-{ type: 'document_update', documentId: 'doc_id', content: 'text', userId: 'user_id', timestamp: 'ISO8601' }
-
-// 用户离线
-{ type: 'user_offline', userId: 'user_id' }
-```
-
----
-
-## 🎨 界面预览
-
-### 登录页面
-- 现代化渐变背景
-- 流畅的动画效果
-- 登录/注册切换
-
-### 管理员仪表板
-- 群组管理面板
-- 任务发布界面
-- 文档权限控制
-- 随机点名功能
-
-### 用户仪表板
-- 任务列表
-- 实时文档编辑器
-- 群组聊天
-- 在线状态显示
-
----
-
-## 🤝 贡献指南
-
-我们欢迎所有形式的贡献！
-
-### 如何贡献
-
-1. Fork 本项目
-2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
-3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
-4. 推送到分支 (`git push origin feature/AmazingFeature`)
-5. 开启 Pull Request
-
-### 代码规范
-
-- 使用 ES6+ 语法
-- 遵循 ESLint 规则
-- 添加必要的注释
-- 编写清晰的提交信息
-
----
-
-## 📦 发布到 npm
-
-### 准备发布
-
-1. **更新版本号**
-
-```bash
-npm version patch  # 1.0.0 -> 1.0.1
-npm version minor  # 1.0.0 -> 1.1.0
-npm version major  # 1.0.0 -> 2.0.0
-```
-
-2. **登录 npm**
-
-```bash
-npm login
-```
-
-3. **发布包**
-
-```bash
-npm publish
-```
-
-### 使用 npm 包
-
-```bash
-npm install collabdocchat
-```
-
----
-
-## 📄 开源协议
-
-本项目采用 [MIT License](LICENSE) 开源协议。
-
----
-
-## 🙏 致谢
-
-感谢以下开源项目：
-
-- [Express](https://expressjs.com/) - Web 框架
-- [MongoDB](https://www.mongodb.com/) - 数据库
-- [Yjs](https://github.com/yjs/yjs) - CRDT 算法
-- [Vite](https://vitejs.dev/) - 构建工具
-
----
-
-## 📞 联系方式
-
-- **项目主页**: [https://github.com/yourusername/collabdocchat](https://github.com/yourusername/collabdocchat)
-- **问题反馈**: [Issues](https://github.com/yourusername/collabdocchat/issues)
-- **邮箱**: your.email@example.com
-
----
-
-## 🗺 路线图
-
-### v1.1.0 (计划中)
-- [ ] 文件上传功能
-- [ ] 富文本编辑器
-- [ ] 消息通知系统
-- [ ] 移动端适配
-
-### v1.2.0 (计划中)
-- [ ] 视频会议集成
-- [ ] 屏幕共享
-- [ ] 白板功能
-- [ ] 插件系统
-
-### v2.0.0 (未来)
-- [ ] 微服务架构
-- [ ] Docker 部署
-- [ ] 多语言支持
-- [ ] AI 助手集成
-
----
-
-<div align="center">
-
-**⭐ 如果这个项目对你有帮助，请给我们一个 Star！⭐**
-
-Made with ❤️ by CollabDocChat Team
-
-</div>
-
-

package/index.html

@@ -4,6 +4,8 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>CollabDocChat - 协作文档聊天平台</title>
+  <link href="https://cdn.quilljs.com/1.3.6/quill.snow.css" rel="stylesheet">
+  <script src="https://cdn.quilljs.com/1.3.6/quill.js"></script>
   <link rel="stylesheet" href="/src/styles/main.css">
 </head>
 <body>

package/install-and-start.bat

@@ -0,0 +1,47 @@
+@echo off
+echo ========================================
+echo   CollabDocChat 一键安装并启动
+echo ========================================
+echo.
+
+echo [1/3] 正在安装 CollabDocChat...
+call npm install collabdocchat@latest --ignore-scripts
+if %errorlevel% neq 0 (
+    echo 安装失败！
+    pause
+    exit /b 1
+)
+
+echo.
+echo [2/3] 安装完成！正在启动应用...
+cd node_modules\collabdocchat
+
+echo.
+echo [3/3] 启动服务器和客户端...
+start /B node server/index.js
+timeout /t 3 /nobreak >nul
+start /B cmd /c "npm run client"
+
+echo.
+echo 等待服务器启动...
+timeout /t 8 /nobreak
+
+echo.
+echo 正在打开浏览器...
+start http://localhost:5173
+
+echo.
+echo ========================================
+echo   启动完成！
+echo ========================================
+echo.
+echo 浏览器已打开，访问: http://localhost:5173
+echo.
+echo 提示：
+echo   - 服务器运行在端口 3000
+echo   - 客户端运行在端口 5173
+echo   - 关闭此窗口不会停止服务
+echo   - 要停止服务，请关闭所有 node 进程
+echo.
+pause
+

package/install-and-start.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+
+echo "========================================"
+echo "  CollabDocChat 一键安装并启动"
+echo "========================================"
+echo ""
+
+echo "[1/3] 正在安装 CollabDocChat..."
+npm install collabdocchat@latest --ignore-scripts
+if [ $? -ne 0 ]; then
+    echo "安装失败！"
+    exit 1
+fi
+
+echo ""
+echo "[2/3] 安装完成！正在启动应用..."
+cd node_modules/collabdocchat
+
+echo ""
+echo "[3/3] 启动服务器和客户端..."
+node server/index.js &
+sleep 3
+npm run client &
+
+echo ""
+echo "等待服务器启动..."
+sleep 8
+
+echo ""
+echo "正在打开浏览器..."
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    open http://localhost:5173
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    xdg-open http://localhost:5173
+fi
+
+echo ""
+echo "========================================"
+echo "  启动完成！"
+echo "========================================"
+echo ""
+echo "浏览器已打开，访问: http://localhost:5173"
+echo ""
+echo "提示："
+echo "  - 服务器运行在端口 3000"
+echo "  - 客户端运行在端口 5173"
+echo "  - 按 Ctrl+C 停止服务"
+echo ""
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "collabdocchat",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "description": "开源的实时协作文档聊天平台 - 集成任务管理、多人文档编辑、智能点名功能",
   "main": "./server/index.js",
   "type": "module",
@@ -13,7 +13,10 @@
     "package.json",
     "vite.config.js",
     "index.html",
-    ".gitignore"
+    ".gitignore",
+    "install-and-start.bat",
+    "install-and-start.sh",
+    "QUICK_START.md"
   ],
   "keywords": [
     "collaboration",
@@ -47,6 +50,8 @@
     "postinstall": "node scripts/postinstall.js",
     "dev": "concurrently \"npm run server\" \"npm run client\" \"npm run open-browser\"",
     "start": "node scripts/start-app.js",
+    "quick-start": "node scripts/quick-start.js",
+    "stop": "node scripts/stop-app.js",
     "server": "nodemon server/index.js",
     "client": "vite",
     "open-browser": "node scripts/open-browser.js",
@@ -57,13 +62,12 @@
   },
   "dependencies": {
     "bcryptjs": "^2.4.3",
-    "collabdocchat": "^1.0.0",
     "cors": "^2.8.5",
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
     "jsonwebtoken": "^9.0.2",
     "mongoose": "^8.0.3",
-    "quill": "^2.0.3",
+    "quill": "^1.3.7",
     "quill-cursors": "^4.0.2",
     "ws": "^8.14.2",
     "y-websocket": "^1.5.0",
@@ -73,6 +77,6 @@
     "concurrently": "^8.2.2",
     "nodemon": "^3.0.2",
     "open": "^11.0.0",
-    "vite": "^7.3.1"
+    "vite": "^5.0.8"
   }
 }

package/src/pages/admin-dashboard.js

@@ -1,7 +1,7 @@
 import { ApiService } from '../services/api.js';
 import { AuthService } from '../services/auth.js';
-import Quill from 'quill';
-import 'quill/dist/quill.snow.css';
+// import Quill from 'quill/dist/quill.js';
+// import 'quill/dist/quill.snow.css';
 import 'emoji-picker-element';
 
 export function renderAdminDashboard(user, wsService) {