---
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认证系统
- 简化为本地独立运行版本
- 所有功能保持完整