罗技项目进度看板 - 本地运行版

简介

这是一个完全本地化的项目进度看板系统，已剥离Manus云平台依赖，可以在本地独立运行。

主要变更

• ✅ 移除Manus OAuth认证系统
• ✅ 移除vite-plugin-manus-runtime插件
• ✅ 所有API端点改为公开访问（无需登录）
• ✅ 简化环境变量配置
• ✅ 完全本地化运行

环境要求

• Node.js: 18+ 或 20+
• MySQL数据库: 5.7+ 或 8.0+
• 包管理器: npm 或 pnpm

快速开始

1. 配置数据库

首先需要创建MySQL数据库：

CREATE DATABASE logitech_dashboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 配置环境变量

项目根目录已包含 .env 文件，请根据实际情况修改数据库连接：

# 数据库连接字符串
DATABASE_URL=mysql://root:your_password@localhost:3306/logitech_dashboard

# 端口配置(可选)
PORT=3000

重要: 请将 your_password 替换为你的MySQL密码！

3. 安装依赖

npm install

或使用pnpm（推荐）:

pnpm install

4. 初始化数据库表结构

npm run db:push

这会自动创建所需的数据库表。

5. 启动开发服务器

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/          # 前后端共享代码

构建生产版本

npm run build
npm run start

常见问题

1. 数据库连接失败

• 检查MySQL服务是否启动
• 确认 .env 中的数据库连接信息正确
• 确认数据库已创建

2. 端口被占用

修改 .env 文件中的 PORT 配置

3. 依赖安装失败

尝试清除缓存后重新安装：

rm -rf node_modules package-lock.json
npm install

许可证

MIT

更新日志

v1.0.0 (本地化版本)

• 剥离Manus云平台依赖
• 移除OAuth认证系统
• 简化为本地独立运行版本
• 所有功能保持完整