# buban_app

**Repository Path**: ZuoWenTao/buban_app

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 步伴 StepMate MVP

面向老人家属的 Flutter MVP 应用。当前版本使用 Mock Data，完成 Dashboard、Activity、AI、Mine、告警中心和 SOS 紧急模式的可运行产品骨架。

## 结构

```text
buban_app/
  lib/main.dart
  packages/buban_app_shell/
    lib/src/app/
    lib/src/core/
    lib/src/router/
    lib/src/shared/widgets/map/
    lib/src/features/
      home/
      activity/
      ai/
      mine/
      alerts/
      sos/
```

根工程只负责平台壳和启动，本地 package `buban_app_shell` 承载主题、路由、Feature First 页面、Repository 和 Mock 数据。

## 运行

```bash
flutter pub get
flutter run
```

## 验证

```bash
flutter analyze
flutter test
cd packages/buban_app_shell && flutter test
```

## MVP 范围

- Material Design 3，Seed Color `#30E887`
- Riverpod 状态管理
- GoRouter 导航
- Repository Pattern + Mock Data
- 统一 `MapView` 地图封装，iOS 真机使用高德 Flutter 地图插件，非 iOS 使用 Mock 地图
- 预留 SharedPreferences 和 Hive 依赖

## 高德地图接入策略

当前配置优先支持 iOS 真机验证高德原生地图。iOS Key 集中配置在 `packages/buban_app_shell/lib/src/core/amap_config.dart`。Web 服务 Key 不写入客户端，后续逆地理编码、路径规划等能力应放到后端或安全代理层调用。

高德官方 Flutter 地图插件 `3.0.0` 基于地图 SDK `8.1.0`，底层 iOS SDK 通过 CocoaPods 集成。iPhone 17 / iOS 26 模拟器要求 `arm64`，但当前高德底层 Pod 拉取的原生库无法正常链接该模拟器架构；原生高德地图请在 iPhone 真机上验证。