# Kylin Engineer

Kylin 智慧工程项目系统核心扩展包，提供工程项目管理、安全检查、隐患管理、挣值分析等核心功能。

## 功能特性

- **项目管理**：项目编号规范（`PRJ-YYYYMMDD-NNN`）、WBS 工作分解结构（最大 6 层）
- **安全检查**：按 JGJ 59-2011 标准三级评分（优良 >=80 / 合格 70-80 / 不合格 <70）
- **隐患管理**：隐患整改超期自动提醒（默认 3 天）
- **挣值分析**：CPI/SPI 成本与进度双重预警（阈值 0.9）
- **材料管理**：库存预警（低于计划量 20% 触发）

## 安装

```bash
composer require kylin/engineer
```

## 配置发布

```bash
php artisan vendor:publish --tag=engineer-config
```

## 配置项

| 配置键 | 默认值 | 说明 |
|------|------|------|
| `project_code_prefix` | `PRJ` | 项目编号前缀 |
| `wbs_max_depth` | `6` | WBS 最大层级深度（PMBOK 建议 ≤6） |
| `safety_grading.excellent.min` | `80` | 优良评分下限 |
| `safety_grading.excellent.label` | `优良` | 优良等级标签 |
| `safety_grading.qualified.min` | `70` | 合格评分下限 |
| `safety_grading.qualified.max` | `80` | 合格评分上限 |
| `safety_grading.qualified.label` | `合格` | 合格等级标签 |
| `safety_grading.unqualified.max` | `70` | 不合格评分上限 |
| `safety_grading.unqualified.label` | `不合格` | 不合格等级标签 |
| `hazard_remind_days` | `3` | 隐患整改超期提醒天数 |
| `evm_threshold.cpi_warning` | `0.9` | CPI 成本超支预警阈值 |
| `evm_threshold.spi_warning` | `0.9` | SPI 进度滞后预警阈值 |
| `inventory_warning_ratio` | `0.2` | 材料库存预警比例 |

## 法律合规

本包严格遵循以下法律法规和行业标准：

- 《中华人民共和国建筑法》（2019 修订）
- 《建设工程安全生产管理条例》（2004）
- 《建设工程质量管理条例》（2019 修订）
- 《中华人民共和国安全生产法》（2021 修订）
- JGJ 59-2011《建筑施工安全检查标准》
- PMBOK 项目管理知识体系指南
- GB/T 50326-2017《建设工程项目管理规范》

详见 [LEGAL.md](./LEGAL.md)。

## 依赖

- PHP ^8.5
- Laravel ^13.0
- kylin/core

## 许可证

私有软件，未经授权禁止使用。