aixpand/investigator

Preventics和Optizone前端应用

多租户Flutter应用，服务于Preventics和Optizone产品，并包含共享的hf_flutter设计系统。该仓库包含构建Web和移动捆绑包、本地运行UI以及通过Docker或Helm打包发布所需的所有内容。

前提条件

• Flutter SDK（稳定通道，修订版本4b12645012342076800eb701bcdfe18f87da21cf）。使用FVM或flutter version匹配此修订版本，并通过flutter config --enable-web启用Web支持。
• Dart 3（与匹配的Flutter SDK捆绑）。
• Chrome或基于Chromium的浏览器，用于Web调试。
• 可选：Docker Desktop（用于docker-dev/中定义的镜像），以及Helm/kubectl（如果计划使用charts）。

开发模式运行与测试

bash
cd cavi_investigator
flutter pub get                 # 安装依赖
flutter run -d chrome \
  --dart-define API_ENDPOINT=https://preventix-api-stg.hyperfy.tech \
  --dart-define APP_TYPE=banksight

针对其他环境时，切换--dart-define值（例如，APP_TYPE=optizone、自定义API端点）。使用flutter analyze运行静态检查，通过dart format .强制执行格式化。使用flutter test执行单元测试和组件测试；处理复杂业务逻辑时，附加--coverage参数。

文件夹结构

.
├── cavi_investigator/    # 主Flutter应用，通过路径依赖使用hf_flutter
│   ├── lib/              # 功能优先组织（ai/、authentication/、common/、widgets/）
│   ├── assets/           # 图标、字体、动画、引导媒体
│   ├── android/、ios/、web/  # 平台特定框架
│   └── analysis_options.yaml # Very Good Analysis lint配置
├── hf_flutter/           # 共享UI工具包、HTTP客户端、工具类（参见嵌套README）
├── charts/               # 用于部署Web捆绑包的Helm chart
├── docker-dev/           # 本地docker-compose和辅助工具
├── entrypoint.sh、start.sh、local-wasm.sh # 环境引导脚本
└── README.md             # 当前文档

自定义包文档

hf_flutter包提供可重用的组件、主题和HTTP工具类，供主应用使用。有关设置、导出和使用示例，请参阅hf_flutter/README.md。

示例

更新AI功能文案

1. 打开cavi_investigator/lib/features/ai/presentation，找到渲染文案的组件或bloc。
2. 应用文本或布局更改；当多个功能重用组件时，将共享组件保留在hf_flutter中。
3. 运行flutter analyze和flutter test确认更改。

添加新仪表板卡片

1. 在cavi_investigator/lib/widgets/cards/中创建组件（使用蛇形命名法文件名）。
2. 从相关桶文件（cards/index.dart）导出，并在lib/features/.../presentation/中的目标屏幕中渲染。
3. 如果卡片需要API数据，在lib/features/.../bloc/中添加数据获取逻辑，并使用flutter test进行测试。