# 零件库存模块（Parts Inventory Management）

> **负责人**: FFOA 开发团队  
> **模块标识**: `parts`  
> **状态**: ✅ 已完成  
> **最后更新**: 2025-12-25

---

## 📋 文档导航

| 文档 | 状态 | 最后更新 |
|------|------|---------|
| [用户场景](./02-user-journey.md) | ✅ | 2025-12-09 |
| [用户场景](./02-user-journey.md) | ✅ | 2025-12-09 |
| [架构设计](./03-architecture.md) | ✅ | 2025-12-01 |
| [API 接口文档](./07-api.md) | ✅ | 2025-12-01 |
| [权限配置指南](./12-permissions-guide.md) | ✅ | 2025-12-01 |
| [BOM 规格说明](./11-bom-specification.md) | ✅ | 2025-12-01 |

**状态说明**:
- ✅ Completed/Approved - 已完成并通过评审
- 🚧 In Progress/Draft - 编写中
- ❌ Not Started - 未开始
- 📝 Need Update - 需要更新

---

## 📌 概述

零件库存模块是制造业务的核心模块，负责零件信息管理、库存跟踪、BOM（物料清单）管理和供应商信息维护。

### 核心功能

1. **零件管理** - 零件信息、规格、分类
2. **库存管理** - 库存数量、位置、状态跟踪
3. **BOM 管理** - 物料清单、层级结构、版本控制
4. **供应商管理** - 供应商信息、零件关联
5. **权限控制** - 细粒度的零件数据访问控制
6. **批量导入** - Excel/CSV 批量导入零件数据
7. **数据导出** - 支持多种格式的数据导出

### 业务价值

- **库存可视化**: 实时掌握零件库存状态
- **BOM 管理**: 规范化的物料清单管理
- **成本控制**: 准确的零件成本核算
- **供应链协同**: 与供应商信息紧密关联

---

## 🏗️ 技术信息

### 代码位置

- **前端**: `frontend/src/app/parts/` - 零件管理页面
- **后端**: `backend/src/modules/parts/`
  - parts.controller.ts - 控制器
  - parts.service.ts - 服务层
  - parts.module.ts - 模块定义
- **数据库**: `mfg_inventory.parts` Schema

### API 端点

- **Base URL**: `/api/v1/parts`
- **权限前缀**: `parts:`
- **主要接口**: 
  - 零件管理: CRUD 操作
  - BOM 管理: 物料清单操作
  - 库存查询: 库存状态查询
  - 批量操作: 导入/导出
- **总计**: 20+ 接口

### 技术栈

- **前端**: Next.js 14 + TypeScript + Tailwind CSS
- **后端**: NestJS + Prisma + PostgreSQL
- **存储**: PostgreSQL（mfg_inventory Schema）

---

## 🔗 相关模块

### 核心依赖

- [组织架构](../organization/README.md) - 用户和权限管理

### 业务关联

- **生产管理** - 使用零件信息进行生产计划
- **采购管理** - 基于库存进行采购决策
- **质量管理** - 零件质量跟踪

---

## 🚀 快速开始

### 基本概念

- **零件（Part）**: 基本零件信息和规格
- **BOM（Bill of Materials）**: 物料清单，描述产品组成
- **库存（Inventory）**: 零件的库存数量和位置
- **供应商（Supplier）**: 零件供应商信息

### 快速上手

详见下方"开发环境"部分

### 权限配置

零件模块支持细粒度的权限控制：
- 查看权限（`parts:read`）
- 创建权限（`parts:create`）
- 更新权限（`parts:update`）
- 删除权限（`parts:delete`）
- 导入/导出权限

详见 [权限配置指南](./12-permissions-guide.md)

---

## 📊 BOM 管理

### BOM 规格说明

零件库存模块支持 BOM2511 规格的物料清单管理：
- 层级结构支持
- 版本控制
- 成本核算
- 替代件管理

详见 [BOM 规格说明](./11-bom-specification.md)

---

## 🧪 测试

详见架构文档中的测试策略部分。

---

## 📚 详细文档

- [用户场景](./02-user-journey.md) - 用户使用指南和场景
- [架构设计](./03-architecture.md) - 技术架构和数据模型
- [API 接口文档](./07-api.md) - 完整 API 定义
- [BOM 规格说明](./11-bom-specification.md) - BOM2511 规格详解
- [权限配置指南](./12-permissions-guide.md) - 权限管理详解

---

## 🎯 开发状态

### 已完成功能

- ✅ 零件基本信息管理（CRUD）
- ✅ 库存数量跟踪
- ✅ BOM 物料清单管理
- ✅ 供应商信息管理
- ✅ 权限控制体系
- ✅ 批量导入/导出
- ✅ 数据查询和筛选
- ✅ BOM2511 规格支持

### 核心特性

- ✅ **细粒度权限**: 支持零件级别的权限控制
- ✅ **BOM 管理**: 完整的物料清单层级结构
- ✅ **批量操作**: 高效的批量导入导出
- ✅ **实时库存**: 准确的库存状态跟踪

---

## 📊 模块统计

| 指标 | 数量 |
|------|------|
| **API 端点** | 20+ |
| **权限点** | 10+ |
| **文档数** | 6个 |
| **文档行数** | 2,539行 |

---

## 👥 贡献者

- **创建者**: FFOA Team
- **维护者**: Backend Team
- **最后更新**: 2025-12-25

---

**创建时间**: 2025-11-01  
**更新时间**: 2025-12-25  
**状态**: ✅ 已完成  
**版本**: v1.0