# outsourcing-ms

**Repository Path**: andershsueh/outsourcing-ms

## Basic Information

- **Project Name**: outsourcing-ms
- **Description**: 外包管理系统
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2026-04-23
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 外包管理平台解决方案

> **Outsourcing Management System**
> 版本: 1.0.0
> 日期: 2026-04-22

---

## 1. 项目概述

外包管理平台是一套面向大型企业的外包资源全生命周期管理解决方案，覆盖从供应商准入、人员入场、现场管理、考勤结算到安全合规的完整闭环。

### 1.1 方案组成

| 目录 | 说明 |
|------|------|
| `doc/` | 需求文档、系统设计概要、需求池、待澄清问题、缺失资料 |
| `prototype/` | 静态HTML原型（基于设计规范） |
| `mvp/` | 完整可运行的MVP系统（Flask + SQLite） |
| `test/` | API测试用例、UI测试用例 |

---

## 2. 技术架构

### 2.1 MVP后端

| 技术 | 说明 |
|------|------|
| **Python Flask** | Web框架 |
| **SQLAlchemy** | ORM |
| **SQLite** | 数据库 |
| **Flask-CORS** | 跨域支持 |
| **RESTful API** | 接口风格 |

### 2.2 MVP前端

| 技术 | 说明 |
|------|------|
| **HTML5 + CSS3 + JavaScript** | 原生前端，无框架 |
| **自定义CSS** | 参考 Ant Design 设计风格 |
| **布局** | 侧边栏固定 + 内容区自适应 |
| **响应式** | 1440px+ 桌面端优先 |

---

## 3. 快速启动

### 3.1 环境要求

- Python 3.8+
- pip

### 3.2 安装步骤

```bash
# 1. 进入MVP目录
cd mvp

# 2. 创建虚拟环境（可选）
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate     # Windows

# 3. 安装依赖
pip install -r requirements.txt

# 4. 初始化数据库
python init_db.py

# 5. 启动服务
python app.py
```

### 3.3 访问

- **前端**: http://127.0.0.1:5017
- **API**: http://127.0.0.1:5017/api

### 3.4 默认账户

| 用户名 | 密码 | 角色 |
|-------|------|------|
| admin | admin123 | 系统管理员 |

---

## 4. 功能模块

### 4.1 人员管理
- 入场申请、资质审核、安全培训
- 账号开通、在场管理、离场管理

### 4.2 供应商管理
- 供应商CRUD、履约评价、准入控制

### 4.3 合同管理
- 合同新建、审核、执行监控

### 4.4 订单管理
- 订单管理（包项目/包人模式）

### 4.5 考勤管理
- 考勤数据导入、统计、异常处理

### 4.6 工作量管理
- 工时统计、双方确认

### 4.7 安全事件
- 事件上报、跟踪、闭环

### 4.8 系统管理
- 用户、角色、菜单、部门、日志

---

## 5. 文档目录

| 文档 | 说明 |
|------|------|
| `doc/WB-PRD.md` | 需求文档 |
| `doc/系统设计概要.md` | 系统设计概要 |
| `doc/需求池.md` | 需求条目清单 |
| `doc/待澄清问题.md` | 待澄清问题清单 |
| `doc/缺失资料清单.md` | 缺失资料清单 |
| `doc/设计规范.md` | UI设计规范 |
| `mvp/API.md` | API接口文档 |

---

## 6. 测试

```bash
# API测试
python -m pytest test/test_api.py -v

# UI测试（需安装Playwright）
python -m pytest test/test_ui.py -v --browser=chrome
```

---

*本文档由系统自动生成*