# WorkManage

**Repository Path**: null_827_6350/WorkManage

## Basic Information

- **Project Name**: WorkManage
- **Description**: FastapiAdmin是一套完全开源的快速开发平台，提供免费使用。它结合了现代、高性能的技术栈，后端采用Fastapi + SQLAlchemy，前端采用基于 vue3 + typescript + vite + pinia + Element-Plus。旨在帮助开发者快速搭建高质量的中后台系统。
官网地址：http://service.fastapiadmin.com
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://service.fastapiadmin.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 467
- **Created**: 2026-08-16
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
    <p align="center">
         <img src="./frontend/web/public/logo.png" width="150" height="150" alt="logo" />
    </p>
    <h1>星级职工评定管理系统 <sup style="background-color: #28a745; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.4em; vertical-align: super; margin-left: 5px;">v1.0.0</sup></h1>
    <h3>⭐ 覆盖车间初评 · 科室审核 · 段办终审 · 公示申诉 · 结果兑现全流程</h3>
    <p>基于 <b>FastAPI + Vue3 + TypeScript</b> 的铁路电务段职工星级评定一体化平台</p>
    <p align="center">
         <img src="https://img.shields.io/badge/Python-≥3.12-blue">
         <img src="https://img.shields.io/badge/NodeJS-≥20.0-blue">
         <img src="https://img.shields.io/badge/MySQL-≥8.0-blue">
         <img src="https://img.shields.io/badge/Redis-≥7.0-blue">
    </p>

简体中文 | [English](./README.en.md)

</div>

## 💡 项目背景

面向铁路电务段（信号专业）的职工星级评定业务，提供从批次创建、车间初评、科室审核、段办终审、公示与申诉、结果兑现的全流程线上化能力。系统按分级权限（车间 / 科室 / 段办）路由待办与操作，按计分模板（安全 / 技能 / 业绩 / 素质四维度）自动计分并判定一星至五星级。

## 🚀 5 分钟本地跑起来

```bash
# 1. 克隆
git clone <内部仓库地址>

# 2. 配置环境
cp backend/env/.env.dev.example backend/env/.env.dev
cp frontend/web/.env.development.example frontend/web/.env.development

# 3. 启动后端（首次自动建表 + 初始化数据）
cd backend && uv sync && uv run main.py run --env=dev

# 4. 启动前端
cd ../frontend/web && pnpm install && pnpm run dev

# ✅ 浏览器打开 http://127.0.0.1:5180/web，用 super/123456 登录
```

| 环境要求 | |
|---------|------|
| Python ≥ 3.12 | Node.js ≥ 20.0 + pnpm |
| MySQL 8.0+ / PostgreSQL 14+ | Redis 6.x / 7.x |

## 📦 工程结构

```
WorkManage/             # 星级职工评定管理系统 Monorepo 全栈工程
├─ backend/              # FastAPI 后端（Pydantic 2.0 + SQLAlchemy + Alembic）
├─ frontend/
│  ├── web/             # Vue3 Web 前端（Element Plus + TypeScript）
│  ├── app/             # UniApp 移动端（H5 + 小程序 + App）
│  └── docs/            # VitePress 文档网站
├─ docker/               # Docker Compose 一键部署（Nginx + SSL）
├─ deploy.sh             # 一键部署脚本
└─ deploy.bat            # Windows 一键部署脚本
```

## 📌 业务模块（核心）

| 模块 | 包含能力 |
|------|---------|
| ⭐ 评定批次 | 草稿/车间初评/科室审核/段办终审/公示/申诉/兑现 状态机流转 |
| 📊 指标录入 | 安全(35)/技能(25)/业绩(30)/素质(10) 四维度加扣分，Excel 试导入+确认落库 |
| 🧮 自动计分 | 按计分模板计算总得分、判定星级（一星 ~ 五星）、车间/全段排名 |
| 📢 公示与申诉 | 公示期内职工查看结果、提交申诉；申诉处理可回退重评或维持结果 |
| 🏆 评定统计 | 星级分布、车间分布堆叠柱状图、参评人数/平均分/最高最低分 |
| ⚙️ 系统管理 | 用户 / 角色 / 菜单 / 部门 / 岗位 / 字典 / 配置 / 公告 |
| 👀 监控管理 | 在线用户 / 服务器监控 / 缓存监控 |
| 📋 任务管理 | 定时任务调度 |
| 📝 日志管理 | 操作日志审计 |
| 📁 文件管理 | 统一文件管理 |

## 📸 业务截图

| 公示中心 | 评定管理 | 指标录入 | 车间统计 |
| -------- | -------- | -------- | -------- |
| ![登录](frontend/web/public/login.png) | ![仪表盘](frontend/web/public/dashboard.png) | ![代码生成](frontend/web/public/gencode.png) | ![AI](frontend/web/public/ai.png) |

> 说明：上表为占位图，待业务截图就绪后请按"公示中心 / 评定管理 / 指标录入 / 车间统计"四类替换 `frontend/web/public/` 下对应图片。

## 📖 文档地址

- 📁 子工程 README：[backend](backend/README.md) · [web](frontend/web/README.md) · [移动端](frontend/app/README.md) · [Docker](docker/README.md)

## 🙏 鸣谢

本项目基于 [FastapiAdmin](https://gitee.com/fastapiadmin/FastapiAdmin) 二次定制，感谢上游团队的开源贡献。

- 后端：[FastAPI](https://fastapi.tiangolo.com/) · [Pydantic](https://docs.pydantic.dev/) · [SQLAlchemy](https://www.sqlalchemy.org/) · [APScheduler](https://github.com/agronholm/apscheduler)
- 前端：[Vue3](https://cn.vuejs.org/) · [TypeScript](https://www.typescriptlang.org/) · [Vite](https://vitejs.dev/) · [Element Plus](https://element-plus.org/)
- 移动端：[UniApp](https://uniapp.dcloud.net.cn/) · [Wot Design Uni](https://wot-ui.cn/)