# delivery-record-fronted

**Repository Path**: happydpc/delivery-record-fronted

## Basic Information

- **Project Name**: delivery-record-fronted
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-22
- **Last Updated**: 2025-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实体对象及属性管理系统

基于实体对象分类的信息管理系统，用于管理石楼油库的各专业设备信息。

## ✨ 系统功能

### 📊 核心功能
- **Excel数据解析和分析** - 自动解析01015实体对象分类表和设备对比数据
- **多专业数据管理** - 支持配管、电气、暖通、通信、仪表等5个专业
- **智能数据匹配** - 基于实体对象分类标准的智能匹配算法
- **参数表生成** - 自动生成对象命名、位置信息、基础参数三种表格
- **实时导出功能** - 支持JSON和CSV格式的数据导出

### 🔍 详细分析功能
每个专业的三种表格（对象命名、位置信息、基础参数）都可以点击进入详细分析页面：

#### 对象命名表 (`/[专业]/naming`)
- 实体对象名称和编码管理
- 标准代码匹配和验证
- 命名规则生成和应用
- 分类编码自动分配

#### 位置信息表 (`/[专业]/location`)
- 建筑物、楼层、房间定位
- 具体位置和坐标信息
- 安装位置编码生成
- 所属系统和管理单位

#### 基础参数表 (`/[专业]/basic`)
- 设备基本信息管理
- 制造商、型号、规格记录
- 技术指标和参数配置
- 运行状态和维护计划

## 🏗️ 技术架构

### 前端技术栈
- **Next.js 15** - React全栈框架
- **TypeScript** - 类型安全
- **Tailwind CSS** - 样式框架
- **Shadcn/ui** - 组件库
- **Lucide Icons** - 图标系统

### 后端技术栈
- **Next.js API Routes** - 服务端API
- **SheetJS** - Excel文件处理
- **Node.js文件系统** - 文件读写操作

### 核心组件
- **ExcelAnalyzer** - Excel数据分析引擎
- **ExcelDataService** - 数据服务层
- **Dynamic Routing** - 动态路由系统

## 📁 项目结构

```
delivery-management/
├── app/                          # Next.js App Router
│   ├── [specialty]/             # 动态专业路由
│   │   └── [tableType]/         # 动态表格类型路由
│   │       └── page.tsx         # 详细分析页面
│   ├── api/excel/              # Excel API
│   ├── electrical/             # 电气专业页面
│   ├── hvac/                   # 暖通专业页面
│   ├── communication/          # 通信专业页面
│   ├── instrumentation/        # 仪表专业页面
│   ├── excel-analysis/         # Excel分析工具
│   └── page.tsx               # 配管专业主页
├── components/                 # 可复用组件
│   ├── ui/                    # 基础UI组件
│   └── sidebar.tsx           # 侧边栏导航
├── lib/                       # 核心库文件
│   ├── excel-analyzer.ts     # Excel分析引擎
│   ├── excel-parser.ts       # Excel解析器
│   └── excel-data-service.ts # 数据服务
├── hooks/                     # React Hooks
│   └── use-excel-data.ts     # Excel数据Hook
└── excel/                     # Excel源文件
    ├── 01015-实体对象分类表-0527.xlsx
    └── 石楼油库实体对象与标准对比-0527.xlsx
```

## 🚀 快速开始

### 环境要求
- Node.js 18+
- npm 或 yarn

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd delivery-management
```

2. **安装依赖**
```bash
npm install
```

3. **启动开发服务器**
```bash
npm run dev
```

4. **访问应用**
打开浏览器访问 `http://localhost:3000`

## 📋 使用说明

### 1. 专业数据浏览
- 从侧边栏选择不同专业（配管、电气、暖通、通信、仪表）
- 查看该专业的所有设备和对象信息

### 2. 详细分析
- 在任何专业页面点击"对象命名"、"位置信息"或"基础参数"链接
- 进入基于01015分类表的详细分析页面
- 查看匹配统计和详细字段信息

### 3. 数据导出
- 在详细分析页面点击"导出CSV"按钮
- 下载特定专业和表格类型的数据文件

### 4. Excel分析工具
- 访问 `/excel-analysis` 页面
- 查看完整的数据分析和匹配结果
- 导出综合分析报告

## 🔧 API端点

### Excel数据API
```
GET /api/excel?filename={文件名}
```

支持的文件：
- `01015-实体对象分类表-0527.xlsx` - 分类标准数据
- `石楼油库实体对象与标准对比-0527.xlsx` - 实体对象数据

### 动态路由
```
/[specialty]/[tableType]
```

支持的专业：
- `piping` - 配管专业
- `electrical` - 电气专业  
- `hvac` - 暖通专业
- `communication` - 通信专业
- `instrumentation` - 仪表专业

支持的表格类型：
- `naming` - 对象命名表
- `location` - 位置信息表
- `basic` - 基础参数表

## 🎯 核心算法

### 数据匹配算法
ExcelAnalyzer采用三层匹配策略：

1. **精确匹配** - 基于标准代码的精确匹配
2. **名称匹配** - 基于实体对象名称的模糊匹配  
3. **分类匹配** - 基于分类关键词的智能匹配

### 参数表生成
根据01015分类表自动生成：
- 对象命名规则和编码
- 位置信息模板和编码
- 基础参数字段和默认值

## 🔍 故障排除

### 常见问题

1. **Excel文件无法加载**
   - 检查文件是否存在于 `excel/` 目录
   - 确认文件名编码正确（支持中文）

2. **数据匹配率低**
   - 检查01015分类表数据完整性
   - 验证实体对象名称规范性

3. **页面加载缓慢**
   - 检查Excel文件大小（建议<10MB）
   - 优化数据查询和过滤逻辑

## 📈 系统特色

### 🎨 现代化UI
- 响应式设计，支持多设备访问
- 直观的数据展示和交互体验
- 专业的工业风格界面

### ⚡ 高性能
- 客户端数据缓存
- 智能数据加载策略
- 优化的Excel解析算法

### 🔒 数据安全
- 本地数据存储
- 无外部数据传输
- 完整的数据验证机制

### 📊 智能分析
- 自动数据匹配和验证
- 实时统计和分析报告
- 多维度数据展示

## 🚀 未来规划

- [ ] 支持更多Excel文件格式
- [ ] 添加数据编辑和修改功能
- [ ] 实现数据同步和备份
- [ ] 增加高级搜索和过滤
- [ ] 支持自定义报表生成
- [ ] 添加用户权限管理

## 📞 技术支持

如有技术问题或建议，请联系开发团队。

---

*该系统专为石楼油库实体对象管理设计，基于01015行业标准开发。*