# nextpilot-lifecycle-system

**Repository Path**: nextpilot/nextpilot-lifecycle-system

## Basic Information

- **Project Name**: nextpilot-lifecycle-system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-06
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <strong style="font-size:26px">🛩 NextPilot LifeCycle Management System</strong><br/>
  <em>NextPilot LCMS · 无人机装备全生命周期管理系统</em>
</p>

<p align="center">
  <img alt="License" src="https://img.shields.io/badge/License-BSD--3--Clause-blue.svg"/>
  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5.x-3178c6.svg"/>
  <img alt="NestJS" src="https://img.shields.io/badge/NestJS-10-e0234e.svg"/>
  <img alt="Next.js" src="https://img.shields.io/badge/Next.js-15-000000.svg"/>
  <img alt="Prisma" src="https://img.shields.io/badge/Prisma-5-2d3748.svg"/>
  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-3-003b57.svg"/>
</p>

> 从采购到报废，**一物一码全程可追溯**，支持无人机**动态套件装配、换件**与**资产外寄审批追溯**。
> 面向无人机整机、机载零部件、试飞装备的**全栈 TypeScript 开源系统**（**BSD 3-Clause**）。

---

## ✨ 四大核心能力

| # | 能力 | 说明 |
|---|---|---|
| 1 | **项目 / 采购 / IQC / WMS** | 立项 → 采购 → 来料检验 → 入库，生成一物一码资产 |
| 2 | **动态套件 BOM（MES）** | 装配 / 拆解 / 零件更换工单，套件为**动态可变结构** |
| 3 | **BOM 历史快照** | 每次装配/换件自动存档，**可回溯任意时间点整机配置** |
| 4 | **只读电子履历 + 审批流** | 所有操作仅追加不可篡改；**外寄/报废等高风险操作必经审批** |

---

## 🎯 为什么做这个系统

通用资产管理系统只管理"一台设备"的静态台账，无法回答这三个问题：

- 这架无人机**当前装了哪些电机/桨叶/飞控**？（动态 BOM）
- 一个月前它的整机配置**是什么样的**？（BOM 快照回溯）
- 它外送检修、换过哪些零件、谁审批的、**整个过程可追溯吗**？（电子履历 + 审批留痕）

NextPilot LCMS 用"**三级资产模型 + 动态套件 BOM + 只读履历 + 审批流**"把仓库管理、生产装配、采购、运维外寄**串成一个闭环**。

---

## 🗺 业务闭环

```
项目立项 → 采购 → IQC 检验 → 入库(一物一码) → 套件装配
   → 领用 → 试飞 → 维修 / 换件 / 外寄(审批) / 报废 → 归还
            └── 全程审批 + 只读电子履历 + BOM 快照
```

- **套件 KIT / 独立设备 DEVICE / 零部件 PART** 三级资产模型
- 高风险操作（装配 / 拆解 / 换件 / 外寄 / 报废）**单人审批**，驳回零变更
- 维修免审批，完工后闭环

---

## 🧱 技术栈

| 层 | 选型 |
|---|---|
| 工程 | **PNPM Monorepo**（全 TS 类型共享） |
| 后端 | **NestJS 10** + **Prisma 5** |
| 前端 | **Next.js 15**（App Router） |
| 数据库 | **SQLite**（开发/演示） / **PostgreSQL**（生产） |
| 协议 | **BSD 3-Clause** |

---

## 📁 仓库结构

```
nextpilot-lifecycle-system/
├── prototype/          # 可交互快速原型（零依赖，浏览器直接打开）
│   ├── index.html
│   ├── data.js         # Mock 数据与枚举
│   ├── store.js        # 状态与业务逻辑（审批/装配/换件/外寄）
│   ├── app.js          # 渲染与交互
│   └── style.css
├── apps/
│   ├── api/            # NestJS 后端（/api/v1）
│   └── web/            # Next.js 15 前端
├── packages/
│   ├── prisma-schema/  # 统一数据模型（15 表）与迁移
│   └── shared-types/   # 前后端共享 TS 枚举 / DTO
├── docs/
│   └── 总体方案.md     # 核心计划活文档（随迭代持续优化）
└── LICENSE             # BSD 3-Clause
```

---

## 🚀 快速开始

### 方式一：快速原型（无需安装，推荐先体验）

```bash
# 直接双击 prototype/index.html 打开；或启动静态服务：
cd prototype && python3 -m http.server 8000
# 访问 http://localhost:8000
```

演示账号：`admin`（管理员） / `warehouse`（仓库员） / `member`（项目成员）

> 💡 推荐体验：**工单管理 → 外寄工单 → 审批通过/驳回**，观察资产状态与电子履历联动。
> 原型数据已持久化到浏览器本地（刷新不丢），支持一键重置演示数据。

### 方式二：正式工程

```bash
# 前置：Node.js ≥ 20、pnpm ≥ 9
pnpm install
# 数据库：生成 Client + 迁移
pnpm db:generate
pnpm db:migrate        # 首次需交互确认迁移名
# 启动后端（NestJS，:3000）
pnpm --filter @nextpilot/api dev
# 启动前端（Next.js，:3001）
pnpm --filter @nextpilot/web dev
```

后端健康检查：`http://localhost:3000/api/v1/health`

---

## 📄 文档

📖 **`docs/总体方案.md`** 是项目的**核心计划活文档**，随开发持续优化调整。
内容覆盖：业务需求 / 数据库 / API 接口 / 页面原型 / 审批流 / 里程碑 / 风险 / 开源运营。

> 本项目"**方案先行、活文档驱动**"：任何新增决策、业务调整都同步更新该文档（含变更记录）。

---

## 🗺 Roadmap

- [x] 可交互快速原型（业务闭环 + 审批流 + H5 扫码 + 持久化 + 导出）
- [x] Monorepo 工程初始化（NestJS + Next.js + Prisma + SQLite）
- [x] Prisma 数据模型（15 表）+ 迁移
- [x] 平台化能力原型：全局审计日志 / 数据权限（行级项目隔离）/ 表格排序分页 / 物料批量导入 / 深色主题
- [x] P3 深化：技术状态记实报告（GJB 记实自动化）/ 质量闭环（检验不合格自动 NCR + 质量看板）/ H5 移动工作台
- [x] P4 平台化：鉴权（账号密码+停用）/ 用户 CRUD / 可编辑角色权限（hasPerm 实时生效）/ 项目里程碑全生命周期 / 质量趋势图+检验导出 / 消息中心（顶栏角标 + 消息页 + H5 消息卡）
- [x] P5 PDM 深化：文档版本履历 / 在线浏览预览（密级水印）/ 签出签入+手动升版 / EBOM 结构树 / 变更影响分析 / 发布→消息联动
- [x] 电子签名（审批同步手写签名字迹）+ 文档二维码（一码一物）+ 移动端入口移入顶栏（桌面/移动切换）
- [x] 业务逻辑层：资产状态机（非法迁移拒绝+原因留痕）/ 领料出库 FIFO 扣批次库存 / 采购闭环（签合同→到货→质检合格→入库生成批次）/ 入库必须有来源
- [x] 业务旅程化：工作台 13 阶段生命周期闭环时间线（前置解锁+当前环节）/ 目录树按 8 业务域逻辑重构（资产台账独立域）/ 采购 6 步流程条 / 质量 IQC 闭环流程条
- [ ] 鉴权、用户、项目模块
- [ ] 采购 / IQC / WMS 模块
- [ ] MES 套件 BOM / 换件 / 快照
- [ ] 资产履历 + 审批流（ApprovalService）
- [ ] H5 扫码、看板、导出
- [ ] Docker 一键部署，V1.0 Release

---

## 🤝 参与贡献

欢迎提交 Issue / PR，共同完善：

- 在 `docs/总体方案.md` 的变更记录中登记你的决策
- 遵循 `main` + `dev` + `feature/*` 分支规范
- 遵守 **BSD 3-Clause** 协议

---

## 📜 License

[BSD 3-Clause License](./LICENSE) · Copyright (c) 2026 NextPilot