从一句话需求到端云一体:AI 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
- 点赞
- 收藏
- 关注作者
评论(0)