# TMS

**Repository Path**: sunlinVeikly/tms

## Basic Information

- **Project Name**: TMS
- **Description**: TMS运输管理系统 ，2025实训项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-23
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 实训, Serverless, HarmonyOS

## README

# 🚚 TMS 运输管理系统

## 📖 项目简介

**TMS 运输管理系统** 是一款现代化的物流运输解决方案，旨在通过数字化和智能化的方式，全面提升货物运输流程的效率、透明度和可控性。项目原型设计涵盖了 **管理后台**、**司机端APP** 和 **站点APP**，形成了一个完整的业务闭环。

本项目最大的特色是采用 **Serverless** 架构，完全专注于前端应用的开发与交互体验。所有数据均通过 **LeanCloud** 的结构化存储服务进行管理，实现了前后端的彻底分离，大大降低了后端开发与运维的成本。

项目原型设计参考高保真原型设计:https://www.axureshop.com/a/2328998.html
## ✨ 功能特性

系统根据不同用户角色的需求，划分了三大核心功能模块：

### 🖥️ 管理后台 (Web)

为企业管理者、调度人员和客服人员提供一站式的中心化管理平台。

-   📊 **数据看板 (Dashboard):** 核心运营指标可视化，实时掌握业务动态。
-   📦 **订单管理:** 全流程订单追踪，从创建、分配到签收，状态一目了然。
-   🚚 **运力管理:** 包括车辆信息、司机信息、实时位置监控和调度分配。
-   🗺️ **路线规划:** 智能规划最优运输路线，降低运输成本。
-   💰 **财务结算:** 运费计算、账单管理与在线对账。
-   👥 **客户管理:** 维护客户信息，管理合同与服务记录。
-   ⚙️ **系统设置:** 角色权限管理、系统参数配置等。

### 📱 司机端 (鸿蒙 APP)

为一线司机量身打造的移动工作终端，让运输任务执行更高效、更便捷。

-   ✅ **任务中心:** 清晰展示待接收、执行中和已完成的运输任务列表。
-   📍 **智能导航:** 内置地图导航功能，引导司机按规划路线行驶。
-   ✍️ **状态上报:** 一键更新提货、发运、抵达、签收等关键节点状态。
-   📸 **电子回单:** 支持拍照上传签收凭证，实现无纸化交付。
-   💬 **即时通讯:** 与调度中心保持实时沟通，处理突发异常。
-   📈 **个人业绩:** 查看个人运输数据统计与收入情况。

### 🏢 站点端 (鸿蒙 APP)

为仓库、分拨中心等线下站点操作人员设计的移动应用。

-   📥 **入库管理:** 扫描货物码，快速办理货物入库登记。
-   📤 **出库管理:** 核对出库清单，与司机进行货物交接。
-   📋 **库存盘点:** 便捷地进行库存核对与盘点，确保账实相符。
-   ⚠️ **异常上报:** 及时上报货物破损、丢失等异常情况。

## 🏗️ 技术架构

项目完全基于 **Serverless** 理念构建，不涉及传统后端应用的开发。

-   **后端即服务 (Backend as a Service):**
    -   **LeanCloud:** 作为核心后端服务，提供：
        -   **结构化数据存储:** 存储所有业务数据（如订单、用户、车辆等）。
        -   **文件存储:** 存储电子回单、用户头像等非结构化数据。
        -   **用户认证:** 管理用户账户体系。
        -   **REST API:** 前端通过标准 RESTful 接口与 LeanCloud 进行数据交互。

-   **前端 (Frontend):**
    -   **Web 管理后台:**
        -   **Vue 3:** 采用最新的 Vue `组合式 API` (`<script setup>`) 进行开发。
        -   **TypeScript:** 提供强类型支持，提升代码健壮性。
        -   **Element-Plus:** 基于 Vue 3 的高质量 UI 组件库。
        -   **Pinia:** 新一代轻量级状态管理库。
        -   **Axios:** 成熟的网络请求库，用于调用 LeanCloud API。
        -   **Vite:** 提供极速的开发服务器与打包体验。
    -   **移动端 (APP):**
        -   **HarmonyOS (鸿蒙):** 使用 ArkTS 语言进行原生应用开发，充分利用华为生态能力，打造流畅的用户体验。

## 🚀 快速开始

### 环境准备

-   `Node.js` >= 18.x
-   `pnpm` (推荐), `npm` 或 `yarn`
-   `DevEco Studio` (用于鸿蒙 APP 开发)
-   一个 [LeanCloud](https://leancloud.cn/) 账号

### 安装与启动 (Web 端)

1.  **克隆项目到本地**
    ```bash
    git clone https://gitee.com/sunlinVeikly/tms
    ```

2.  **进入 Web 项目目录并安装依赖**
    ```bash
    cd tms-management-web
    pnpm install
    ```

3.  **配置 LeanCloud**
    -   登录 LeanCloud 并创建应用。
    -   在 `src/config/leancloud.ts` (或类似文件) 中，填入你的 `AppID`, `AppKey` 和 `Server URL`。
    ```typescript
    export const LC_APP_ID = 'YOUR_APP_ID';
    export const LC_APP_KEY = 'YOUR_APP_KEY';
    export const LC_SERVER_URL = 'YOUR_SERVER_URL';
    ```

4.  **启动开发服务器**
    ```bash
    pnpm dev
    ```

### 安装与启动 (APP 端)

1.  使用 **DevEco Studio** 打开项目中的鸿蒙工程目录。
2.  配置 `AppID` 等相关信息。
3.  通过模拟器或真实设备运行应用。

## 🤝 贡献

欢迎所有形式的贡献！如果您有任何想法、建议或发现了 Bug，请随时提交 Pull Request 或创建 Issue。

## 📄 许可证

本项目采用 [MIT](https://opensource.org/licenses/MIT) 许可证。