# 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**: 491
- **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>Star Assessment System <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>⭐ End-to-end employee star-rating workflow for railway telecom depots</h3>
    <p>Workshop review · Department audit · Depot final approval · Public notice & appeals · Result settlement</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.md)

</div>

## 💡 Background

This system digitizes the star-employee evaluation process for railway telecom depots (signal specialty). It supports the full lifecycle: batch creation → workshop review → department audit → depot final approval → public notice & appeal → result settlement. The system routes to-dos and operations by tiered permission (workshop / department / depot), auto-scores across four dimensions (Safety / Skill / Performance / Quality), and determines 1–5 star ratings.

## 🚀 5-Minute Quick Start

```bash
# 1. Clone
git clone <internal-repo-url>

# 2. Configure environments
cp backend/env/.env.dev.example backend/env/.env.dev
cp frontend/web/.env.development.example frontend/web/.env.development

# 3. Start backend (auto-creates tables + seed data on first run)
cd backend && uv sync && uv run main.py run --env=dev

# 4. Start frontend
cd ../frontend/web && pnpm install && pnpm run dev

# ✅ Open http://127.0.0.1:5180/web, login with super/123456
```

| Requirements | |
|-------------|------|
| Python ≥ 3.12 | Node.js ≥ 20 + pnpm |
| MySQL 8.0+ / PostgreSQL 14+ | Redis 6.x / 7.x |

## 📦 Structure

```
WorkManage/             # Star Assessment System Monorepo
├─ backend/              # FastAPI backend (Pydantic 2.0 + SQLAlchemy + Alembic)
├─ frontend/
│  ├── web/             # Vue3 Web (Element Plus + TypeScript)
│  ├── app/             # UniApp Mobile (H5 + Mini Program + App)
│  └── docs/            # VitePress documentation
├─ docker/               # Docker Compose deploy (Nginx + SSL)
├─ deploy.sh             # One-click deploy script (Linux/macOS)
└─ deploy.bat            # One-click deploy script (Windows)
```

## 📌 Business Modules

| Module | Capabilities |
|--------|-------------|
| ⭐ Assessment Batch | State machine: draft / workshop review / department audit / depot final / public notice / appeal / settled |
| 📊 Score Entry | 4-dimension score (Safety 35 / Skill 25 / Performance 30 / Quality 10), Excel trial-import + commit |
| 🧮 Auto Scoring | Template-driven total score, 1–5 star assignment, workshop/global ranking |
| 📢 Public Notice & Appeal | Employees view result during notice period, submit appeals; appeal handling reverts or maintains |
| 🏆 Statistics | Star distribution, workshop stacked-bar chart, total / average / max / min score |
| ⚙️ System | Users, Roles, Menus, Departments, Positions, Dicts, Config, Notices |
| 👀 Monitoring | Online users, Server, Cache |
| 📋 Tasks | Scheduled task management |
| 📝 Logs | Operation auditing |
| 📁 Files | Unified file management |

## 📸 Screenshots

| Notice Center | Assessment | Score Entry | Workshop Stats |
| ------------- | ---------- | ----------- | -------------- |
| ![Login](frontend/web/public/login.png) | ![Dashboard](frontend/web/public/dashboard.png) | ![Code Generator](frontend/web/public/gencode.png) | ![AI](frontend/web/public/ai.png) |

> The images above are placeholders; replace `frontend/web/public/*.png` with real screenshots when ready.

## 📖 Documentation

- 📁 Sub-project READMEs: [backend](backend/README.md) · [web](frontend/web/README.md) · [mobile](frontend/app/README.md) · [Docker](docker/README.md)

## 🙏 Acknowledgments

This project is a customized fork of [FastapiAdmin](https://gitee.com/fastapiadmin/FastapiAdmin). Thanks to the upstream team for the open-source contribution.

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