# 鸿蒙技术服务智慧预约平台

**Repository Path**: Dracowyn/harmony-technology-service

## Basic Information

- **Project Name**: 鸿蒙技术服务智慧预约平台
- **Description**: 鸿蒙教学项目
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 技术服务智慧预约平台

> 基于 HarmonyOS NEXT + ArkTS 构建的技术服务预约应用，适用于企业、社区、机构等各类组织的设施报修与技术支持场景。专为软件技术相关专业
> HarmonyOS 应用开发课程设计。

---

## 📖 项目简介

**技术服务智慧预约平台**是一个通用型设施报修预约系统，覆盖从预约提交到服务完成的完整业务闭环。用户发现设备或设施故障后，可通过本应用在线提交预约申请，全程跟踪处理进度，服务完成后进行满意度评价。

项目以真实业务场景驱动知识点教学，适合软件技术相关专业的 HarmonyOS 应用开发课程的核心教学项目，也可作为毕业设计参考。

**适用场景**：企业 IT 支持、楼宇设施管理、社区物业报修、机构后勤服务等。

---

## ✨ 功能特性

| 功能模块           | 描述                         |
|----------------|----------------------------|
| 🔐 **用户登录**    | 账号密码登录，支持记住密码，内置演示账号       |
| 🏠 **首页概览**    | 工单统计卡片、快捷入口、系统公告           |
| 📋 **在线预约**    | 故障地点、类型、紧急程度、现场照片，支持草稿自动保存 |
| 🤖 **AI 智能助手** | 自然语言描述故障，AI 自动识别类型并一键填写预约单 |
| 📄 **工单管理**    | 多状态筛选工单列表，可查看处理进度时间轴       |
| ⭐ **服务评价**     | 星级评分、标签评价、文字描述，完成服务闭环      |
| 👤 **个人中心**    | 用户信息、预约记录统计、AI 助手入口        |

---

## 🛠️ 技术栈

| 技术                 | 说明                    |
|--------------------|-----------------------|
| **HarmonyOS NEXT** | API 22+，Stage 模型      |
| **ArkTS**          | 应用开发语言（TypeScript 超集） |
| **ArkUI**          | 声明式 UI 框架             |
| **AppStorage**     | 全局状态管理                |
| **Router**         | 页面路由                  |
| **promptAction**   | 轻提示与对话框               |
| **SymbolGlyph**    | 系统矢量图标                |

---

## 📁 项目结构

```
school_services/
├── AppScope/
│   ├── app.json5                           # 应用全局配置（BundleName、版本）
│   └── resources/                          # 全局资源（应用图标等）
├── entry/
│   └── src/main/
│       ├── ets/
│       │   ├── entryability/
│       │   │   └── EntryAbility.ets        # UIAbility 入口，控制启动页路由
│       │   ├── entrybackupability/
│       │   │   └── EntryBackupAbility.ets  # 备份扩展能力
│       │   ├── pages/
│       │   │   ├── Login.ets               # 登录页
│       │   │   ├── Index.ets               # 主框架（底部 Tab 导航）
│       │   │   ├── OrderDetail.ets         # 工单详情页
│       │   │   ├── AIChat.ets              # AI 智能助手聊天页
│       │   │   └── Evaluate.ets            # 服务评价页
│       │   ├── tabs/
│       │   │   ├── HomeTab.ets             # 首页 Tab
│       │   │   ├── RepairFormTab.ets       # 预约表单 Tab
│       │   │   ├── OrderListTab.ets        # 工单列表 Tab
│       │   │   └── ProfileTab.ets          # 个人中心 Tab
│       │   ├── components/
│       │   │   ├── OrderCard.ets           # 工单卡片
│       │   │   ├── StatusBadge.ets         # 状态徽章
│       │   │   ├── StarRating.ets          # 星级评分组件
│       │   │   ├── WorkerCard.ets          # 技术人员信息卡
│       │   │   └── StatusTimeline.ets      # 处理进度时间轴
│       │   ├── model/
│       │   │   └── RepairOrder.ets         # 数据模型与枚举定义
│       │   └── mock/
│       │       └── MockData.ets            # Mock 数据与服务（模拟后端）
│       └── resources/                      # 模块资源文件
├── build-profile.json5                     # 构建配置
├── hvigorfile.ts                           # 构建脚本（Hvigor）
└── oh-package.json5                        # 依赖配置
```

---

## 🚀 快速开始

### 环境要求

- **DevEco Studio** 6.0.0 及以上
- **HarmonyOS SDK** API 22+

### 运行步骤

1. 使用 DevEco Studio 打开项目根目录
2. 等待 IDE 自动同步依赖（ohpm install）
3. 连接真机或启动模拟器
4. 点击 **Run** 或按 `Shift + F10` 运行

### 演示账号

| 字段 | 值         |
|----|-----------|
| 账号 | `user001` |
| 密码 | `123456`  |

---

## 🏗️ 核心设计说明

### 状态管理

项目使用 `AppStorage` 管理跨页面全局状态：

| Key                | 类型      | 用途                |
|--------------------|---------|-------------------|
| `isLoggedIn`       | boolean | 登录状态，控制启动页跳转      |
| `switchTab`        | number  | Tab 切换信号（0~3）     |
| `aiFormSuggestion` | string  | AI 预填数据（JSON 字符串） |
| `repairDraft`      | string  | 预约表单草稿            |

### 业务流程

```
提交预约 → 待受理 → 已派单 → 服务中 → 待评价 → 已完成
```

### AI 助手能力

| 意图   | 触发词示例           | 响应               |
|------|-----------------|------------------|
| 查询预约 | "查我的预约"、"进度"    | 列出当前进行中工单        |
| 智能填单 | "灯不亮"、"漏水"、"断网" | 识别故障类型，一键跳转填写预约单 |
| 故障诊断 | 描述具体现象          | 细化询问，给出初步判断      |
| 使用帮助 | "你好"、"能做什么"     | 功能介绍             |

---

## 📄 许可证

本项目仅供教学使用，代码开源，请勿用于商业用途。