add whole project
This commit is contained in:
parent
3eac3b1e3b
commit
fe56c5274e
GPG key ID:
ADC4815BFE960182
97 changed files with 15837 additions and 0 deletions
297
USER_GUIDE.md
Normal file
297
USER_GUIDE.md
Normal file
|
|
@ -0,0 +1,297 @@
|
|||
# 用户使用指南
|
||||
|
||||
欢迎使用 Dream-Machine 采购清单管理系统！本指南将帮助你快速上手并充分利用系统的所有功能。
|
||||
|
||||
## 📋 目录
|
||||
|
||||
1. [快速开始](#快速开始)
|
||||
2. [界面介绍](#界面介绍)
|
||||
3. [核心功能](#核心功能)
|
||||
4. [高级功能](#高级功能)
|
||||
5. [数据管理](#数据管理)
|
||||
6. [故障排除](#故障排除)
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 第一次使用
|
||||
|
||||
1. **启动应用**
|
||||
```bash
|
||||
# 推荐方式 - 使用快速启动脚本
|
||||
./start.sh # Linux/macOS
|
||||
start.bat # Windows
|
||||
|
||||
# 或使用 Makefile
|
||||
make dev
|
||||
|
||||
# 或使用 npm
|
||||
npm install && npm run dev
|
||||
```
|
||||
|
||||
2. **访问应用**
|
||||
- 打开浏览器访问 `http://localhost:5173`
|
||||
- 应用会自动加载示例数据
|
||||
|
||||
3. **开始使用**
|
||||
- 浏览现有的采购项目
|
||||
- 尝试添加新的采购项目
|
||||
- 体验筛选和排序功能
|
||||
|
||||
## 🖥 界面介绍
|
||||
|
||||
### 主界面布局
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 页面标题 │
|
||||
│ Dream-Machine 采购清单 │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ 数据管理按钮 │ 添加项目 │ 打印 │ 励志图片 │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ 筛选和排序面板 │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ 采购清单表格 │
|
||||
│ ✓ 已购买项目 (绿色背景) │
|
||||
│ ○ 待购买项目 (白色背景) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ 预算统计卡片区域 │
|
||||
│ 总预算 │ 已购买 │ 待购买 │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 界面元素说明
|
||||
|
||||
- **🎯 重要程度颜色编码**:
|
||||
- 🔴 **必须的必** (深红色粗体): 最高优先级
|
||||
- 🔴 **必须** (红色): 高优先级
|
||||
- 🟡 **可买** (黄色): 中等优先级
|
||||
- 🟢 **不急** (绿色): 低优先级
|
||||
|
||||
- **📊 状态显示**:
|
||||
- ✅ 绿色背景: 已购买项目
|
||||
- ⭕ 白色背景: 待购买项目
|
||||
|
||||
## ✨ 核心功能
|
||||
|
||||
### 1. 添加新项目
|
||||
|
||||
1. 点击 **"添加项目"** 按钮
|
||||
2. 填写项目信息：
|
||||
- **产品代码**: 设备型号 (如: UCG-FIBER)
|
||||
- **产品名称**: 设备名称 (如: Ubiquiti Cloud Gateway Ultra)
|
||||
- **价格**: 人民币价格
|
||||
- **原价**: 原始价格和币种
|
||||
- **重要程度**: 选择优先级
|
||||
- **平台**: 购买平台
|
||||
- **备注**: 附加说明
|
||||
- **分类**: 设备分类
|
||||
- **站点**: 购买地区
|
||||
- **批次**: 批次编号
|
||||
- **重量**: 设备重量(kg)
|
||||
- **购买链接**: 产品链接
|
||||
|
||||
3. 点击 **"添加"** 保存
|
||||
|
||||
### 2. 编辑项目
|
||||
|
||||
1. 在表格中找到要编辑的项目
|
||||
2. 点击该行的 **"编辑"** 按钮 (铅笔图标)
|
||||
3. 修改需要的信息
|
||||
4. 点击 **"保存"** 确认修改
|
||||
|
||||
### 3. 标记购买状态
|
||||
|
||||
- 点击项目行前的 **圆圈图标** 切换购买状态
|
||||
- 已购买项目会显示绿色背景和 ✅ 图标
|
||||
- 待购买项目显示白色背景和 ⭕ 图标
|
||||
|
||||
### 4. 删除项目
|
||||
|
||||
1. 找到要删除的项目
|
||||
2. 点击 **"删除"** 按钮 (垃圾桶图标)
|
||||
3. 确认删除操作
|
||||
|
||||
## 🔍 高级功能
|
||||
|
||||
### 筛选和排序
|
||||
|
||||
#### 筛选选项
|
||||
- **分类筛选**: 按设备分类筛选 (路由器、交换机、配件等)
|
||||
- **状态筛选**: 按购买状态筛选 (全部/已购买/待购买)
|
||||
- **重要程度筛选**: 按优先级筛选
|
||||
- **批次筛选**: 按批次编号筛选
|
||||
|
||||
#### 排序选项
|
||||
- **产品名称**: 按字母顺序
|
||||
- **价格**: 按价格高低
|
||||
- **重量**: 按重量轻重
|
||||
- **重要程度**: 按优先级排序
|
||||
- **分类**: 按分类排序
|
||||
- **批次**: 按批次排序
|
||||
|
||||
#### 筛选记忆功能
|
||||
- 系统会自动保存你的筛选和排序偏好
|
||||
- 下次打开应用时会恢复上次的设置
|
||||
|
||||
### 批量编辑
|
||||
|
||||
1. 在表格中选择多个项目 (勾选复选框)
|
||||
2. 点击 **"批量编辑"** 按钮
|
||||
3. 选择要修改的字段 (通常是批次)
|
||||
4. 输入新值
|
||||
5. 点击 **"更新选中项目"** 应用更改
|
||||
|
||||
### 打印功能
|
||||
|
||||
1. 点击 **"打印清单"** 按钮
|
||||
2. 系统会生成专业的打印版本:
|
||||
- 包含公司 Logo
|
||||
- 显示筛选后的项目
|
||||
- 包含预算统计
|
||||
- 无水印设计
|
||||
3. 使用浏览器打印功能输出
|
||||
|
||||
## 📊 数据管理
|
||||
|
||||
### 导出数据
|
||||
|
||||
#### JSON 格式导出
|
||||
1. 点击 **"数据管理"** 按钮
|
||||
2. 选择 **"导出为 JSON"**
|
||||
3. 下载格式: `购买清单_YYMMDDHHMMSS.json`
|
||||
|
||||
#### Excel 格式导出
|
||||
1. 点击 **"数据管理"** 按钮
|
||||
2. 选择 **"导出为 EXCEL"**
|
||||
3. 下载格式: `购买清单_YYMMDDHHMMSS.xlsx`
|
||||
|
||||
### 导入数据
|
||||
|
||||
#### 支持格式
|
||||
- **JSON**: 系统原生格式，完整数据支持
|
||||
- **Excel**: 支持标准表格格式，自动转换
|
||||
|
||||
#### 导入模式
|
||||
- **替换模式**: 清空现有数据，导入新数据
|
||||
- **追加模式**: 保留现有数据，添加新数据
|
||||
|
||||
#### 导入步骤
|
||||
1. 点击 **"数据管理"** 按钮
|
||||
2. 选择 **"导入 JSON"** 或 **"导入 EXCEL"**
|
||||
3. 选择导入模式
|
||||
4. 选择文件并上传
|
||||
5. 系统会验证数据格式并导入
|
||||
|
||||
### 模板下载
|
||||
|
||||
1. 点击 **"数据管理"** 按钮
|
||||
2. 选择 **"下载Excel模板"**
|
||||
3. 使用模板填写数据后导入
|
||||
|
||||
### 清空数据
|
||||
|
||||
1. 点击 **"数据管理"** 按钮
|
||||
2. 选择 **"清空所有数据"**
|
||||
3. 确认操作 (此操作不可撤销)
|
||||
|
||||
## 💡 实用技巧
|
||||
|
||||
### 1. 快速添加类似项目
|
||||
- 编辑现有项目时，可以复制其信息
|
||||
- 创建新项目时参考相似配置
|
||||
|
||||
### 2. 批次管理
|
||||
- 使用批次功能对采购项目分组
|
||||
- 便于按阶段管理采购计划
|
||||
|
||||
### 3. 重量计算
|
||||
- 精确输入设备重量，支持小数点后3位
|
||||
- 表格底部显示总重量，便于物流计算
|
||||
|
||||
### 4. 价格管理
|
||||
- 支持 SGD、USD 自动转换为 RMB
|
||||
- 在原价字段记录原始币种信息
|
||||
|
||||
### 5. 链接管理
|
||||
- 在购买链接字段保存产品页面URL
|
||||
- 点击链接图标直接跳转购买页面
|
||||
|
||||
## 🔧 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
#### 1. 数据丢失
|
||||
**症状**: 刷新页面后数据消失
|
||||
**解决**:
|
||||
- 数据保存在浏览器本地存储中
|
||||
- 清理浏览器数据可能导致丢失
|
||||
- 建议定期导出备份数据
|
||||
|
||||
#### 2. 导入失败
|
||||
**症状**: Excel 或 JSON 导入时报错
|
||||
**解决**:
|
||||
- 检查文件格式是否正确
|
||||
- 下载最新模板重新填写
|
||||
- 确保必填字段不为空
|
||||
|
||||
#### 3. 筛选不生效
|
||||
**症状**: 筛选条件设置后无效果
|
||||
**解决**:
|
||||
- 刷新页面重试
|
||||
- 清除筛选条件后重新设置
|
||||
- 检查数据中是否存在对应的值
|
||||
|
||||
#### 4. 打印格式异常
|
||||
**症状**: 打印预览显示不正常
|
||||
**解决**:
|
||||
- 使用 Chrome 浏览器打印
|
||||
- 设置为 A4 纸张
|
||||
- 选择 "更多设置" → "适合页面"
|
||||
|
||||
### 性能优化
|
||||
|
||||
#### 大数据量处理
|
||||
- 项目数量超过 100 时，考虑分批次管理
|
||||
- 定期清理不需要的历史数据
|
||||
- 使用筛选功能减少显示数量
|
||||
|
||||
#### 浏览器兼容性
|
||||
- 推荐使用 Chrome 90+ 或 Firefox 88+
|
||||
- 避免使用 IE 浏览器
|
||||
- 移动端推荐使用原生浏览器
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
### 获取帮助
|
||||
|
||||
1. **查看文档**:
|
||||
- [README.md](README.md) - 项目说明
|
||||
- [DEPLOYMENT.md](DEPLOYMENT.md) - 部署指南
|
||||
- [CHANGELOG.md](CHANGELOG.md) - 更新日志
|
||||
|
||||
2. **调试信息**:
|
||||
- 按 F12 打开开发者工具
|
||||
- 查看控制台错误信息
|
||||
- 检查网络请求状态
|
||||
|
||||
3. **数据备份**:
|
||||
- 定期导出 JSON 格式备份
|
||||
- 重要数据建议多地备份
|
||||
- 升级前务必备份数据
|
||||
|
||||
### 版本信息
|
||||
|
||||
- **当前版本**: 1.0.0
|
||||
- **发布日期**: 2025-01-20
|
||||
- **支持浏览器**: Chrome 90+, Firefox 88+, Safari 14+
|
||||
- **Node.js 要求**: v18.0.0+
|
||||
|
||||
---
|
||||
|
||||
## 🎉 开始使用
|
||||
|
||||
现在你已经了解了所有功能，开始体验 Dream-Machine 采购清单管理系统吧！
|
||||
|
||||
如果在使用过程中遇到任何问题，请参考故障排除部分或查看相关文档。
|
||||
|
||||
**祝你使用愉快！** 🚀
|
||||
Loading…
Add table
Add a link
Reference in a new issue