现场移动端 App

功能概述

智建云现场移动端 App 是给工程现场人员用的轻量作业工具，用 Flutter 开发，一套代码覆盖安卓、iOS、鸿蒙三端。它面向施工员、班组长、工程师等每天在现场跑的人，只做现场最高频的一件事：把作业进度和现场照片快速报上去。复杂的计划编制、甘特调整、报表分析、审批配置都放在 Web 端，App 不做。

当前版本已实现的核心功能：

• 登录：用工号（或手机号）+ 密码登录，与安全随手拍共用同一套账号。
• 作业列表：按项目列出所有可填报的作业（WBS 叶子节点），并显示每条作业的当前完成进度。
• 进度填报：选中一条作业，拖动滑块填完成百分比、写可选备注、拍现场照片，一次提交。
• 离线队列：弱网或断网时，填报先存在手机本地不丢，恢复网络后自动补传。

与安全随手拍的关系

智建云 App 与安全随手拍 App 是两个独立安装的应用，各管各的。两者只共享账号体系：同一个工号和密码在两个 App 都能登录，登录凭证互认。装了随手拍不代表装了智建云，需要单独安装智建云 App。

支持平台与安装

App 采用跨平台构建，同一功能在三端表现一致。各端应用标识如下：

平台	应用包名
iOS	cn.uanhon.uanbuild
鸿蒙 HarmonyOS	cn.uanhon.uanbuild
安卓 Android	cn.uanhon.android.uanbuild

安装方式按平台区分：

1. 安卓：从项目实施团队提供的下载页获取安装包（APK），点击安装。首次安装若系统提示「未知来源应用」，需在弹窗中允许本应用安装。
2. 鸿蒙：安装实施团队提供的鸿蒙安装包（HAP）。
3. iOS：通过实施团队提供的企业分发链接或测试渠道安装，并在「设置 - 通用 - VPN与设备管理」中信任对应的企业证书后方可打开。

安装包来源

安装包的下载地址由项目实施团队按客户环境统一下发，请以实施团队发放的链接为准，不要从第三方来源下载。App 默认连接生产服务 build.uanhon.cn，需要现场网络能访问该地址。

首次登录

1. 打开 App，进入登录页。
2. 在「工号 / 手机号」栏输入你的工号，工号和手机号都可以用。
3. 输入密码。初始密码由管理员在 Web 端建号时设置。
4. 点击「登 录」。登录成功后直接进入进度填报首页。

登录须知

• 账号由项目管理员在 Web 端统一开通，App 内没有自助注册。
• 若提示账号或密码错误，请联系项目管理员核对或重置。
• 登录状态会保留在本机，后续打开 App 无需重复登录，直到登录过期或主动退出。

界面构成

App 只有两个主要页面，结构刻意做得简单，方便在现场快速操作。

作业列表页（首页）

登录后进入的首页，标题为「进度填报」，自上而下由这些部分组成：

• 上传状态条：只有当有待上传或上传失败的填报时才出现，用于提示离线数据的补传情况。
• 项目选择器：当你名下有多个项目时出现，用于切换当前查看的项目；只有一个项目时不显示。
• 作业列表：当前项目下所有可填报的作业，每条显示作业编码、名称、所属分部，右侧是当前完成百分比。
• 右上角退出按钮：退出登录，回到登录页。

列表支持下拉刷新，重新拉取最新进度。点击任意一条作业即进入进度填报页。

进度填报页

从列表点进某条作业后打开，自上而下包含：

• 作业编码、名称与所属分部（顶部只读展示，确认你选对了作业）。
• 完成进度滑块：0 到 100 的滑块，右上角实时显示当前拖到的百分比。
• 备注：可选的文字说明，例如「3 号储罐环缝完成 2 道」。
• 现场照片：点加号拍照或从相册选图，可加多张，每张缩略图右上角有删除按钮。
• 提交按钮：底部大按钮，提交本次填报。

操作步骤

填报一条作业进度

1. 在首页作业列表找到要填报的作业，点击进入。
2. 拖动「完成进度」滑块到本次的实际完成百分比。滑块会实时显示数字，方便对准。
3. 如需补充说明，在「备注」栏填写文字（可留空）。
4. 点击照片区的加号，选择「拍照」现场取证，或「从相册选择」补传已有照片。可以连续添加多张。若某张拍错了，点缩略图右上角的叉删除。
5. 点击底部「提交」。
6. 提交后自动返回作业列表，该作业的完成百分比会更新为你刚填的值。

拍照与流量

照片在提交前会自动压缩（长边压到 1600 像素、按中等质量存储），在弱网现场也能较快上传，同时保留看得清的细节。现场作业以「拍照」为主，「从相册选择」主要用于补传之前拍好的照片。

断网 / 弱网下的提交

App 的提交逻辑是「先存本地，再联网发送」，所以现场没信号也能照常填报：

1. 在没有网络或信号很弱时正常填报并点「提交」。
2. 系统会提示「已保存，联网后自动提交」，数据已经安全存到手机本地。
3. 首页顶部会出现黄色状态条，显示还有几条填报等待上传。
4. 手机恢复网络后，App 会在后台自动把这些填报补传上去，最迟约半分钟内触发一次；你也可以点状态条右侧的「立即重试」马上尝试。
5. 全部传完后，黄色状态条自动消失。

关于填报失败

如果某条填报连续多次尝试都传不上去，状态条会变红并提示「请检查后重试」。此时数据仍然保留在手机上不会丢失。请先确认现场网络恢复正常，再点「立即重试」；若仍不成功，可重新打开该作业再提交一次，或联系项目管理员协助排查。

退出登录

点击首页右上角的退出图标，即清除本机登录状态并回到登录页。

退出前先确认已上传

退出登录会清除登录凭证。若此时还有「待上传」的离线填报，补传需要登录状态，请等状态条消失（即离线数据全部传完）后再退出，避免数据积压在本机。

字段与状态说明

作业列表字段

字段	含义
作业编码	WBS 节点编码，如 2.1，唯一标识一条作业
作业名称	该作业的名称，如「储罐组焊」
所属分部	作业所属的分部工程名称
完成百分比	该作业当前累计的实际完成进度，右侧大号数字

为什么列表里只有部分作业？

App 只显示「叶子作业」，也就是进度计划里最末一级、可以直接填数字的具体作业。上层的分部、单位工程等汇总节点不出现在填报列表里，它们的进度由下级叶子作业自动向上加权汇总，不需要也不允许手工在 App 上直接填。

完成百分比颜色

颜色	含义
绿色	实际进度与计划基本同步，正常
橙色	实际进度落后于计划（落后超过约 2 个百分点），需要关注

上传队列状态

状态	界面表现	说明
待上传	黄色状态条「N 条填报待上传，联网后自动提交」	已存本地、尚未传到服务器，联网后自动补传
多次失败	红色状态条「N 条填报多次失败，请检查后重试」	连续尝试仍失败，数据保留在本机不删除，需人工检查处理
已清空	状态条消失	全部填报已成功上传

数据同步与离线机制

离线队列如何工作（供理解与答疑）

• 先落盘再发送：每次点「提交」都会先把这条填报写入手机本地存储，再尝试联网发送。飞行模式或断网时数据一定不会丢。
• 自动补传：App 内置每 30 秒一次的后台补传，以及每次回到作业列表时触发补传。网络恢复后最迟约半分钟自动提交。
• 照片断点续传：一条填报若带多张照片，会逐张上传，已经传成功的照片会被记住；中途断网后重试时只补传还没传的照片，不重复上传，省流量也更快。
• 失败保留不删除：一条填报最多自动尝试 3 次，仍失败则标记为「失败」并停止自动重试，但数据始终保留在本机，不会被系统删掉。是否放弃只能由人来决定。
• App 重启不丢：即使中途退出或重启 App，本地未传完的填报仍在，下次打开继续补传。

注意事项与常见问题

进度不可倒退

• 填报页的滑块无法拖到低于当前已完成的百分比，提交时也会拦截低于当前值的数据。
• 现场只做进度前进。如果确实需要下调（回退）某条作业的进度，须由持有相应权限的人员在 Web 端操作，App 端不提供回退。

常见问题

1. 登录后提示「登录已过期，请重新登录」怎么办？ 登录凭证有有效期，过期后 App 会自动跳回登录页，重新输入工号密码登录即可，不影响已上传的数据。

2. 提交后一直显示「待上传」？ 说明当前网络无法到达服务器。确认现场能上网、且网络能访问 build.uanhon.cn 后，点「立即重试」，或等待后台自动补传。

3. 找不到要填的作业？ 先确认顶部选的项目对不对（多项目时可切换），再下拉刷新列表。若仍没有，可能是该作业尚未在 Web 端进度计划里创建，或它不是可直接填报的末级作业，请联系资料员或计划工程师核对。

4. 同一条作业同一天多次填报会怎样？ 以最后一次提交为准，系统按「作业 + 日期」覆盖更新，不会产生重复记录。

规划中的能力

以下能力在当前 App 版本尚未提供，属后续规划，本文如实标注以免误解：

• 数量与单位填报：目前 App 只填完成百分比，工程量数量与单位的录入暂在 Web 端进行。
• 照片地理位置标注：拍照自动带经纬度定位暂未在 App 端启用。
• 失败填报的一键重传与队列明细管理：目前失败数据保留在本机不丢，尚无独立的失败重传管理界面，处理方式见上文「关于填报失败」。