# SmartPark3

**Repository Path**: moroks/smart-park3

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartPark3 智慧园区 Android 客户端

> 版本 1.0 · 包名 `com.huluobo.smartpark3` · 更新 2026-06-11

智慧园区 V2 Android 客户端，基于 **Kotlin + Jetpack Compose + Hilt + Retrofit(Flow)** 构建。停车缴费模块已实现车牌绑定、临停缴费、月卡续费、缴费记录等完整业务链路，并支持与外部 WebAPI 联调。

**交付范围说明：** 本仓库交付 **Android 客户端源码与安装包**；后端服务为外部依赖（见下方 API 配置），不在本仓库内。

---

## 环境要求

| 项 | 要求 |
|---|---|
| JDK | 17 |
| Android Studio | Hedgehog 或更高 |
| compileSdk / targetSdk | 34 |
| minSdk | 26 |
| Gradle | 8.0（见 `gradle/wrapper/gradle-wrapper.properties`） |

---

## 快速开始

```powershell
# 1. 配置 Android SDK 路径（首次）
# 在项目根目录创建 local.properties：
# sdk.dir=C\:\\Users\\YourName\\AppData\\Local\\Android\\Sdk

# 2. 编译测试版 APK
.\gradlew :app:assembleDebug

# 3. 运行停车模块单元测试
.\gradlew :parking:testDebugUnitTest

# 4. 安装到设备
adb install -r app\build\outputs\apk\debug\app-debug.apk
```

产物路径：`app/build/outputs/apk/debug/app-debug.apk`

---

## 模块结构

```
SmartPark3/
├── app/           # 应用入口、登录、导航
├── lib_base/      # BaseViewModel、MMKV、路由、通用 UI
├── lib_http/      # Retrofit、ApiService、DTO
├── parking/       # 停车缴费（核心交付模块）
├── home/          # 首页
├── news/          # 资讯
├── repair/        # 报修
├── tenant/        # 租户
├── member/        # 会员
└── profile/       # 个人中心
```

---

## 外部 API 依赖

| 项 | 值 |
|---|---|
| 基址 | `http://10.161.9.80:2209/`（见 `lib_http/Const.kt`） |
| API 文档 | Swagger `/v2/api-docs` |
| 鉴权 | 登录后 Header 携带 `token`、`accessId` |

---

## 停车模块 Fake 模式（离线演示）

在 `parking/build.gradle` 中修改：

```gradle
buildConfigField "boolean", "USE_FAKE_PARKING_API", "true"
```

设为 `true` 后，绑车/临停/月卡/订单全流程可在无后端环境下演示，适合教学与日常巡检。

---

## 文档索引

| 文档 | 说明 |
|---|---|
| [交付物验收报告](docs/交付物验收报告.md) | 1.1/1.2/1.3 产出物核查 + 业务验收对照 |
| [软件设计说明书](docs/软件设计说明书.md) | 架构、流程、算法、接口、运维 |
| [验收测试手册（教学版）](docs/验收测试手册（教学版）.md) | 可执行测试用例（学生/教师） |
| [部署与编译指南](docs/部署与编译指南.md) | 环境、打包、配置、安装 |
| [停车模块开发规划](docs/智慧园区停车缴费模块-完整开发规划.md) | 开发过程与阶段记录 |
| [工单02答辩说明](docs/parking模块-工单02答辩说明.md) | 工单对照与答辩要点 |
| [项目计划](plan.md) | 项目总览 |
| [交付目录说明](deliverables/README.md) | APK 与配置交付清单 |

---

## 权限说明（合规）

应用仅声明以下权限：

- `INTERNET` — 网络请求
- `POST_NOTIFICATIONS` — 缴费成功/续费提醒通知

无定位、通讯录、短信等敏感权限，无第三方恶意 SDK。

---

## 许可证与产权

源码仅供智慧园区项目教学、验收与后续迭代使用。后端 API 版权归服务端提供方所有。