| ---
|
| title: 罗技项目进度看板
|
| emoji: 📊
|
| colorFrom: blue
|
| colorTo: purple
|
| sdk: docker
|
| app_port: 7860
|
| pinned: false
|
| license: mit
|
| ---
|
|
|
| # 罗技项目进度看板 - 本地运行版
|
|
|
| ## 简介
|
|
|
| 这是一个完全本地化的项目进度看板系统，已剥离Manus云平台依赖，可以在本地独立运行。
|
|
|
| ## 主要变更
|
|
|
| - ✅ 移除Manus OAuth认证系统
|
| - ✅ 移除vite-plugin-manus-runtime插件
|
| - ✅ 所有API端点改为公开访问（无需登录）
|
| - ✅ 简化环境变量配置
|
| - ✅ 完全本地化运行
|
|
|
| ## 环境要求
|
|
|
| - **Node.js**: 18+ 或 20+
|
| - **MySQL数据库**: 5.7+ 或 8.0+
|
| - **包管理器**: npm 或 pnpm
|
|
|
| ## 快速开始
|
|
|
| ### 1. 配置数据库
|
|
|
| 首先需要创建MySQL数据库：
|
|
|
| ```sql
|
| CREATE DATABASE logitech_dashboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
| ```
|
|
|
| ### 2. 配置环境变量
|
|
|
| 项目根目录已包含 `.env` 文件，请根据实际情况修改数据库连接：
|
|
|
| ```env
|
| # 数据库连接字符串
|
| DATABASE_URL=mysql://root:your_password@localhost:3306/logitech_dashboard
|
|
|
| # 端口配置(可选)
|
| PORT=3000
|
| ```
|
|
|
| **重要**: 请将 `your_password` 替换为你的MySQL密码！
|
|
|
| ### 3. 安装依赖
|
|
|
| ```bash
|
| npm install
|
| ```
|
|
|
| 或使用pnpm（推荐）:
|
|
|
| ```bash
|
| pnpm install
|
| ```
|
|
|
| ### 4. 初始化数据库表结构
|
|
|
| ```bash
|
| npm run db:push
|
| ```
|
|
|
| 这会自动创建所需的数据库表。
|
|
|
| ### 5. 启动开发服务器
|
|
|
| ```bash
|
| npm run dev
|
| ```
|
|
|
| 服务器启动后，在浏览器访问: `http://localhost:3000`
|
|
|
| ## 项目功能
|
|
|
| ### 核心功能
|
| - 📊 **项目进度看板**: 卡片式展示所有项目
|
| - 🔍 **搜索功能**: 按项目名称、模具ID搜索
|
| - 📈 **统计面板**: 已超时/进行中/已完成项目统计
|
| - 📋 **领导层总览**: 三级分组表格视图
|
| - 📁 **Excel导入**: 支持批量上传项目数据
|
|
|
| ### 管理功能（管理员模式）
|
| 访问 `http://localhost:3000/?mode=admin` 即可显示管理按钮：
|
| - 📤 **上传Excel文件**: 批量导入项目数据
|
| - 🗑️ **清空数据**: 删除所有项目记录
|
| - 📥 **加载示例数据**: 快速测试功能
|
|
|
| ## 数据库表结构
|
|
|
| ### users 表
|
| 用于用户管理（本地模式下可选）
|
|
|
| ### projects 表
|
| 存储所有项目数据，包含以下字段：
|
| - 项目基本信息：客户名称、产品名称、工厂位置等
|
| - 里程碑日期：Kickoff、T1、GL、VMP、MP
|
| - 进度状态：当前阶段、当前节点、项目推进细节
|
| - FAI状态：Tooling FAI、Part FAI
|
|
|
| ## 开发说明
|
|
|
| ### 技术栈
|
| - **前端**: React 19 + TypeScript + Tailwind CSS
|
| - **后端**: Express + tRPC
|
| - **数据库**: MySQL + Drizzle ORM
|
| - **构建工具**: Vite
|
|
|
| ### 项目结构
|
| ```
|
| client/ # 前端代码
|
| src/
|
| components/ # React组件
|
| pages/ # 页面组件
|
| lib/ # 工具函数
|
| server/ # 后端代码
|
| _core/ # 核心功能
|
| routers.ts # API路由
|
| db.ts # 数据库查询
|
| drizzle/ # 数据库Schema和迁移
|
| shared/ # 前后端共享代码
|
| ```
|
|
|
| ### 构建生产版本
|
|
|
| ```bash
|
| npm run build
|
| npm run start
|
| ```
|
|
|
| ## 常见问题
|
|
|
| ### 1. 数据库连接失败
|
| - 检查MySQL服务是否启动
|
| - 确认 `.env` 中的数据库连接信息正确
|
| - 确认数据库已创建
|
|
|
| ### 2. 端口被占用
|
| 修改 `.env` 文件中的 `PORT` 配置
|
|
|
| ### 3. 依赖安装失败
|
| 尝试清除缓存后重新安装：
|
| ```bash
|
| rm -rf node_modules package-lock.json
|
| npm install
|
| ```
|
|
|
| ## 许可证
|
|
|
| MIT
|
|
|
| ## 更新日志
|
|
|
| ### v1.0.0 (本地化版本)
|
| - 剥离Manus云平台依赖
|
| - 移除OAuth认证系统
|
| - 简化为本地独立运行版本
|
| - 所有功能保持完整 |
