# WorkloadEstimationSheet

**Repository Path**: andershsueh/workload-estimation-sheet

## Basic Information

- **Project Name**: WorkloadEstimationSheet
- **Description**: 老付的表格设计的很管用，我们来把它做成系统。
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工时评估系统

一个基于Golang + Gin后端和Flutter前端的工时评估系统，用于项目工时评估和报价计算。

## 项目概述

本项目是一个工时评估系统，能够将传统的Excel工时评估表格转换为在线系统。系统支持项目管理、数据输入、实时统计计算和公式维护功能，旨在提高工时评估效率和准确性。

## 技术栈

### 后端
- **语言**: Golang
- **框架**: Gin
- **数据库**: SQLite
- **依赖**:
  - github.com/gin-gonic/gin
  - github.com/mattn/go-sqlite3
  - gorm.io/gorm
  - github.com/golang-jwt/jwt

### 前端
- **框架**: Flutter
- **语言**: Dart
- **依赖**:
  - http: 用于API调用
  - provider: 状态管理
  - fl_chart: 图表显示

## 项目结构

```
workload-estimation-sheet/
├── temp.xlsx                    # 源Excel文件
├── analyze_excel.py            # Excel分析脚本
├── detailed_analysis.py        # 详细分析脚本
├── excel_analysis.json         # 分析结果
├── 表格分析报告.md              # Excel分析报告
├── dbscripts/                  # 数据库脚本
│   └── create_tables.sql
├── db/                         # 数据库文件
│   └── workload_estimation.db
├── backend/                    # 后端代码
│   ├── main.go
│   ├── config/
│   ├── models/
│   ├── controllers/
│   ├── routes/
│   ├── services/
│   ├── middleware/
│   ├── utils/
│   └── be_start.sh             # 后端启动脚本
├── front_end/                  # 前端代码
│   ├── lib/
│   │   ├── main.dart
│   │   ├── models/
│   │   ├── providers/
│   │   ├── screens/
│   │   ├── widgets/
│   │   └── services/
│   ├── pubspec.yaml
│   └── fe_start.sh             # 前端启动脚本
└── back_end/                   # 后端文档
    └── be.md                   # 后端开发说明文档
```

## 功能特点

### 后端功能
1. **用户管理**: 简化登录，以用户名作为数据筛选条件
2. **项目管理**: 支持项目的创建、选择和管理
3. **配置管理**: 支持岗位单价、工作性数据等基础配置
4. **数据管理**: 需求条目的CRUD操作
5. **实时计算**: 自动计算总价、毛利、成本等统计信息
6. **公式管理**: 支持计算公式的维护和修改
7. **健康检查**: 提供健康检查端点

### 前端功能
1. **登录界面**: 输入用户名进行身份识别
2. **主界面**: 包含项目、配置、需求、公式四个功能模块
3. **项目管理**: 选择已有项目或创建新项目
4. **配置面板**: 设置岗位单价和工作性数据
5. **数据输入**: 需求条目输入界面
6. **实时统计**: 动态显示总价、毛利、成本等统计信息
7. **公式维护**: 公式编辑和管理界面

## 数据库设计

系统使用SQLite数据库，包含以下主要表：
- `users`: 用户信息
- `projects`: 项目信息
- `config_params`: 配置参数
- `requirement_items`: 需求条目
- `calculation_results`: 计算结果
- `formulas`: 计算公式

## 安装和运行

### 环境要求
- Go 1.19+
- Flutter 3.0+
- SQLite 3+

### 后端设置
1. 安装依赖:
```bash
go mod init workload-estimation-backend
go get github.com/gin-gonic/gin
go get github.com/mattn/go-sqlite3
go get gorm.io/gorm
go get gorm.io/driver/sqlite
go get github.com/golang-jwt/jwt
```

2. 启动后端:
```bash
cd backend
./be_start.sh
# 或者直接运行
go run main.go
```

### 前端设置
1. 安装Flutter SDK
2. 获取依赖:
```bash
cd front_end
flutter pub get
```

3. 运行应用:
```bash
cd front_end
./fe_start.sh
# 或者直接运行
flutter run
```

## 使用说明

1. 启动后端服务
2. 在前端界面输入用户名登录
3. 选择或创建项目
4. 配置岗位单价和工作性数据
5. 输入需求条目
6. 查看实时统计信息
7. 根据需要调整毛利率等参数
8. 可在公式维护模块中修改计算公式

## 许可证

本项目使用木兰宽松许可证，第2版 (Mulan PSL v2)

## 开发说明

- 后端开发参考 `backend/be.md` 文档
- 前端开发参考 `front_end/fe.md` 文档
- Excel表格分析参考 `表格分析报告.md`