# 线缆计算oc

**Repository Path**: lsplong4399/cable-calculation-oc

## Basic Information

- **Project Name**: 线缆计算oc
- **Description**: 适用于OC项目线缆计算工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-14
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



该项目是一个用于电缆计算和项目信息管理的 Web 应用程序，后端采用 Python 编写，前端基于 Vue.js 框架开发。以下是 README 的建议内容：

---

# Cable-Calculation-OC

**Cable-Calculation-OC** 是一个用于协助计算和管理线缆连接项目的工具，主要功能包括线缆长度计算、机柜查找、线缆连接关系统计等。该项目分为前后端，后端用于业务逻辑处理，前端提供用户交互界面。

## 功能概述

- **线缆计算**：根据机柜和设备信息自动计算线缆长度。
- **机柜查找**：支持多种查找方式，包括 NFV、镜像等场景。
- **线缆关系统计**：对计算结果进行汇总与展示。
- **文件上传与下载**：支持上传数据文件并下载计算结果。
- **项目管理**：提供添加、删除项目文件以及保存 JSON 配置的功能。

## 技术栈

- **后端**: Python (Flask 框架)
- **前端**: Vue.js (使用 Vite 构建工具)
- **数据存储**: JSON 文件和 Excel 文件

## 目录结构

```
├── server/               # 后端代码目录
│   ├── index.py            # 主程序，包含所有 API 接口
│   ├── cfg.txt             # 配置文件
│   └── mode.json           # JSON 模式定义文件
├── web/                  # 前端代码目录
│   ├── public/             # 静态资源
│   ├── src/                # 源码目录
│   │   ├── api/            # API 请求封装
│   │   ├── assets/         # CSS 样式和静态资源
│   │   ├── components/     # Vue 组件
│   │   ├── views/          # 页面视图
│   │   ├── config/         # 配置文件
│   │   ├── main.js         # 应用入口文件
│   │   └── router/         # 路由定义
│   ├── package.json        # 项目依赖文件
│   ├── vite.config.js      # Vite 配置文件
│   └── README.md           # 前端开发说明
```

## 安装与运行

### 后端运行

1. 确保安装了 Python 3.x。
2. 安装依赖（如果有的话）。
3. 启动服务：
   ```bash
   python server/index.py
   ```

### 前端运行

1. 安装 Node.js 和 npm。
2. 进入 `web/` 目录：
   ```bash
   cd web
   ```
3. 安装依赖：
   ```bash
   npm install
   ```
4. 启动开发服务器：
   ```bash
   npm run dev
   ```

## 使用说明

- 打开前端页面后，可以通过 `/getlist` 获取项目列表。
- 上传文件后，通过 `/comput` 接口进行线缆计算。
- 使用 `/statistics` 接口进行线缆关系的汇总统计。
- 所有计算结果可导出为 Excel 文件并下载。

## API 文档

| 接口          | 方法 | 描述                    |
|---------------|------|-------------------------|
| `/getlist`    | GET  | 获取所有项目列表         |
| `/getprojectinfo` | POST | 获取具体项目信息         |
| `/operate`    | POST | 添加或删除项目文件       |
| `/comput`     | POST | 执行线缆计算             |
| `/upload`     | POST | 文件上传                 |
| `/downloadfile` | GET  | 下载指定文件             |
| `/savejson`   | POST | 保存 JSON 配置文件       |
| `/statistics` | POST | 汇总计算结果并展示       |

## 贡献指南

欢迎为项目提供贡献，包括优化功能、修复 Bug 或改进文档。请遵循以下步骤：
1. Fork 项目仓库。
2. 创建新分支。
3. 提交 Pull Request。

## 许可证

本项目遵循 MIT 许可证，详细信息请查看 `LICENSE` 文件。

---

请根据实际需求补充更详细的配置说明或功能描述。