从一句话需求到端云一体:AI Agent 驱动鸿蒙员工签到 App 的完整实践

举报
yd_254324137 发表于 2026/11/19 21:01:48 2026/11/19
【摘要】 用 CodeArts Agent 五轮对话完成鸿蒙端云一体员工签到 App 的需求、设计、编码、部署与验收全过程记录。

一、为什么做这个实践

鸿蒙端云一体应用的传统开发路径是:先写 PRD,再做架构设计,然后端侧写 ArkTS 页面、云侧写 Node.js 接口,最后部署联调。一个完整闭环往往要两三天。这次我用 CodeArts Agent 试了一条更短的路径——只用五句话,让它把文档、端侧代码、云侧代码、部署脚本全部产出。

二、五轮对话的骨架

第 1 轮:一句话需求。员工邮箱注册、admin 配置签到位置与班次、员工 GPS 签到、管理员查看签到列表。Agent 产出 PRD,含功能清单、数据模型、接口定义、端云交互时序。

第 2 轮:技术约束。服务端 FlexusL + Node.js + Express + MySQL,端侧通过鸿蒙 SDK 取经纬度。Agent 产出 HLD,确定端云两层架构,API 路径统一加 pjm- 前缀便于 Nginx 反代隔离。

第 3 轮:生成代码。端侧 17 个 .ets 文件(6 页面 + 4 Service + ConfigCenter + AppContext + Util),云侧 22 个 .js 文件(3 路由组 + Services + DAO + Middleware + DB + 部署配置)。

第 4 轮:部署后端。SSH 上机装 Node 20、MySQL 8、Nginx、PM2,建库建用户,上传代码,pm2 start,Nginx 反代 80 到 3000。

第 5 轮:构建安装验收。hvigorw assembleHap 出 HAP,hdc 推送到模拟器安装启动,逐项跑验收表。

三、关键设计点

1. 端云职责边界要在 PRD 阶段定死。端侧只负责 UI 渲染和 GPS 采集,云侧负责业务逻辑与持久化。后期接口不一致导致的返工,八成来自这里没写清。

2. 签到判定用 Haversine 距离。服务端读配置里的签到点经纬度与半径,算出员工上报坐标的球面距离,再叠加班次时间做迟到判定,最后按最早 + 最晚双记录策略落库。

3. ConfigCenter 的默认 BaseUrl 必须是空字符串。这是安全兜底,避免打包进发行版后凭据泄露。

4. network_security_config.json 要显式允许明文 HTTP。默认策略会拦掉 http 请求,联调阶段最容易卡在这里。

四、踩过的坑

• @ohos/hvigor-ohos-plugin 不在公共 npm registry 上。必须先用 DevEco Studio 打开项目一次,让 IDE 把依赖装进 ~/.hvigor/ 全局缓存,之后命令行构建才正常。

• API 24 起 Kit 改名,@kit.ArkDataKit 要写成 @kit.ArkData,否则编译直接报不存在。

• DEVECO_SDK_HOME 要指向 SDK 根目录而不是子目录,且要把 jbrin 加进 PATH,不然会报 spawn java ENOENT。

• Ubuntu apt 源里的 Node 是 v12,太旧。用 NodeSource setup_20.x 装。

• .env 在生产模式是 fail closed 的:密钥缺失或过短会直接 process.exit(1)。这不是 bug,是设计。

五、结果

验收 5 项全过:health 接口返回 {"code":"0","message":"ok"};admin 登录拿到 JWT 并跳转管理台;员工注册返回 userId;员工登录签到返回正常/迟到/超出范围三种结果;管理员查看列表显示全员记录。

一条可复用的经验:Agent 驱动开发不等于"少写代码",而是把人的注意力从语法细节移到契约设计上。需求边界、接口契约、验收标准这三样写清楚,后面的代码生成质量会高一个档次。

附案例公仓:https://gitcode.com/harmony-practice-center/check-in

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。