用一句话需求，让 Agent 生成鸿蒙端云一体员工签到 App：一次实践笔记

今天在华为云鸿蒙开发实践中心体验了一个进阶案例：只向 CodeArts Agent 讲一句话需求，让它生成一个鸿蒙端云一体的员工签到 App。本文把这次实践的流程、端云分工和需要注意的点记下来。

一、从一句话到文档

需求本身并不复杂：员工用邮箱注册账号，密码至少六位，云端预置一个管理员账号；员工签到时要做定位、位置判定和时间判定；管理员可以配置签到位置、班次时间与提示语，并查看全员的签到记录。Agent 先把这些需求整理成一份需求文档，再据此给出架构设计，接口、数据表和端云的职责边界都在动手写代码之前先定好。

二、端云如何分工

端侧用 HarmonyOS ArkTS 实现，包含登录、注册、签到、历史记录和管理台等多个页面，以及负责网络请求、登录态、签到业务和管理员能力的服务；配置中心负责保存服务器地址等公开配置，地理工具负责计算签到点与当前位置的距离。云侧用 Node.js 加 Express 实现，分为认证、管理与员工三组路由，用 JWT 做鉴权，数据存在 MySQL 的用户表、配置表和签到记录表里；前端请求先经过反向代理再到达后端服务，后端进程由进程守护工具管理。

三、部署与验收

后端先部署到云服务器上并完成数据库初始化，确认健康检查接口返回正常；端侧工程在模拟器里构建并安装，管理员登录后进入管理台，员工完成注册、登录与签到，管理员再查看全员记录，几项验收都通过了。整个过程里，Agent 按轮次推进：第一轮提需求出文档，第二轮出架构，第三轮生成端侧与云侧代码，第四轮部署后端，第五轮在模拟器上构建、安装并截图验收。

四、几个需要注意的点

第一，端侧默认的服务器地址是空的，首次启动需要在登录页先设置好服务器地址才能通信。第二，演示里用的是明文通信，只适合学习与调试，正式使用要配置域名与加密传输。第三，有一个构建插件不在公共仓库里，需要先用开发工具打开一次工程来初始化依赖。第四，数据库密码、签名密钥这类敏感信息不要提交到代码仓，截图和日志发布前也要先脱敏。

这次体验让我印象最深的是，需求、文档、代码与部署可以由 Agent 一轮轮衔接起来，人主要负责提清需求和逐项验收；但要把演示做成可用的产品，安全、证书与密钥管理这些环节仍然要自己补齐。