w:defaultTabStop w:val="720"/>

OutfallIQ — 排污口在线监测联网 · 开发文档

1. 产品概述

| 项 | 说明 |

|---|---|

**英文名称**

| OutfallIQ |

**App Store 分类**

| 效率 (Productivity) |

**最低系统**

| iOS 15.0 |

**界面语言**

| 瑞典语 (Svenska) |

**架构入口**

`AppDelegate`

创建根视图 ·

`SceneDelegate`

最小 Scene 生命周期 |

**视觉范式**

| 美术馆导览 · 策展卡片 |

OutfallIQ 面向环保运维、排水管网与排污口监管人员，提供排污口在线监测点联网状态、实时水质指标、告警闭环与阈值配置。数据层采用本地演示数据集 +

`UserDefaults`

持久化阈值，模拟与监测平台同步，形成可演示的完整业务闭环。

---

2. 功能模块与闭环

```

┌─────────────┐ ┌──────────────┐ ┌─────────────────┐

│ Πινακας │────▶│ Σημείο │────▶│ Ειδοποιήσεις │

│ (仪表盘) │ │ (排口详情) │ │ (关联告警) │

└──────┬──────┘ └──────────────┘ └────────┬────────┘

│ │

▼ ▼

┌─────────────┐ ┌──────────────┐ ┌─────────────────┐

│ Συλλογή │────▶│ Δίκτυο │────▶│ Ρυθμίσεις │

│ (排口馆藏) │ │ (联网诊断) │ │ (阈值→告警逻辑) │

└─────────────┘ └──────────────┘ └─────────────────┘

```

###

2.1 仪表盘 (Πινακας Ελέγχου)

Hero 全幅「今日联网概览」卡片：在线率、告警数、最近同步时间。

交替布局：左图右文 KPI 卡片（非统一高度）。

点击 KPI / 推荐排口 → 排口详情或告警列表。

###

2.2 排口馆藏 (Συλλογή Αποχετεύσεων)

策展式卡片流（

`UIScrollView`

+ 自定义卡片，

**非**

标准

`UITableView`

外观）。

馆藏编号 micro label：

`OUT-042`

、

`PRT-118`

等。

搜索（化学需氧量/COD、氨氮、站点名）与状态筛选（在线/离线/告警）。

进入详情：实时参数、24h 趋势简图、合规状态、跳转关联告警。

###

2.3 告警中心 (Κέντρο Συναγερμών)

按时间排序的告警卡片（serif 标题 + sans 正文）。

详情：阈值对比、建议操作、标记「已确认」→ 本地持久化，仪表盘未确认数同步减少。

###

2.4 联网诊断 (Δίκτυο & Συγχρονισμός)

各排口通讯延迟、协议（模拟 HJ212 / MQTT）、上次握手。

「强制同步」按钮 → 更新全局

`lastSyncDate`

，刷新仪表盘与列表。

###

2.5 设置 (Ρυθμίσεις)

COD、NH₃-N、pH、流量上限阈值编辑（希腊语表单标签）。

恢复默认阈值；单位说明。

关于 OutfallIQ、App Store 描述摘要。

**闭环验证路径**

：设置阈值 → 返回馆藏查看超标排口 → 告警确认 → 联网同步刷新 → 仪表盘指标更新。

---

3. UI / UX 规范（美术馆导览）

| 元素 | 规范 |

|------|------|

| 背景 | 米白

`#F7F4EE`

| 标题 | Serif（Georgia / New York） |

| 正文 | System Sans，支持多行、

`numberOfLines = 0`

| 强调色 |

**深墨绿**

`#1B4332`

（唯一主 accent；金色仅作 micro 徽章点缀） |

| 分割线 | 1px

`#E0DAD0`

| 卡片 | 展品说明牌：阴影轻、圆角 12–16pt，左图右文 / Hero 交替 |

| 动效 | Push 时轻 slide + fade（自定义

`UINavigationControllerDelegate`

） |

| 深色模式 |

**禁用**

：

`Info.plist`

`UIUserInterfaceStyle = Light`

`window.overrideUserInterfaceStyle = .light`

| 键盘 | 全局点击空白

`endEditing`

| 引导页 | 无 |

---

4. 技术架构

```

AppDelegate

└── MainTabBarController (自定义 Tab 外观)

├── NavigationController → DashboardViewController

├── NavigationController → OutletGalleryViewController → OutletDetailViewController

├── NavigationController → AlertsViewController → AlertDetailViewController

└── NavigationController → SettingsViewController

└── NetworkStatusViewController (push)

MonitoringDataStore (单例)

├── outlets: [MonitoringOutlet]

├── alerts: [MonitoringAlert]

├── thresholds: ThresholdConfig (UserDefaults)

└── sync() / acknowledgeAlert(id:)

```

**无**

`PrivacyInfo.xcprivacy`

**无**

SceneDelegate / Main.storyboard 依赖（纯代码 UI）

插图：程序绘制渐变 + SF Symbol；App Icon 为定制生成资源

---

5. 资源与命名

**Bundle Display Name**

: OutfallIQ（写入 Xcode

`INFOPLIST_KEY_CFBundleDisplayName`

）

**排口编号规则**

`OUT-`

+ 三位数字；部分展示牌使用

`PRT-`

前缀（管网终端）

---

6. App Store 专业描述（英文，用于提交）

**OutfallIQ — Online Outfall Monitoring Network**

OutfallIQ is a productivity workspace for environmental operators who manage networked sewage outfall monitoring points. The app presents your fleet like a curated gallery: each site is an exhibit card with catalog IDs, live water-quality metrics, and compliance context—designed for clarity in the field, not generic table lists.

**What you can do**

**Control dashboard**

: See online rate, active alarms, and last platform sync at a glance; open any KPI to drill into sites or alerts.

**Outfall collection**

: Browse alternating hero and split cards with COD, ammonia nitrogen, pH, and flow; search and filter by status (online, offline, alarm).

**Alarm center**

: Review threshold breaches with recommended actions; acknowledge events so your team’s open count stays accurate.

**Network diagnostics**

: Inspect per-site latency and protocol hints; run a manual sync to refresh timestamps across the app.

**Threshold settings**

: Tune regulatory limits locally and immediately reflect them in alarm logic and site compliance badges.

OutfallIQ keeps the entire workflow on-device for demonstration and training: configure limits, observe violations, acknowledge alarms, and sync—without dead ends. Interface in Greek for operator teams in Hellenic deployments. Requires iOS 15.0 or later. Light appearance only for consistent readability outdoors.

---

7. 测试清单

[ ] iOS 15 Simulator 编译运行

[ ] 浅色模式强制，切换系统外观仍为浅色

[ ] 设置页 TextField 失焦、点击空白收键盘

[ ] 长希腊语文案无截断（动态高度卡片）

[ ] 告警确认后仪表盘数字变化

[ ] 强制同步更新「Τελευταία συγχρονισμός」

[ ] 全路径无 SceneDelegate

---

8. 版本

| 版本 | 日期 | 说明 |

|------|------|------|

| 1.0.0 | 2026-10-13 | 初始策展 UI + 功能闭环 |