这是一个提供API接口的后端服务,用于管理一个简单的待办事项列表。
涉及的3种核心技术
-
Gin Web框架: 提供RESTful API,让前端或客户端能够对“待办事项”进行增删改查。
-
SQLite数据库 (使用GORM): 负责持久化存储所有的“待办事项”数据。
-
钉钉群机器人: 当一个重要事项完成时,把消息发到工作群,告知团队。
涉及的3个核心业务场景
-
创建一个新的待办事项:
-
用户通过API POST /todos 发送一个请求,请求体中包含事项的内容,例如 {"content": "完成第三季度报告"}。
-
系统接收到请求后,在sqlite数据库的todos表中创建一条新记录,默认状态为“待办中(pending)”。
-
-
完成一个待办事项:
-
当用户完成一个任务后,通过API PUT /todos/{id}/complete 发送请求,标记该事项已完成。
-
业务逻辑开始执行:
a. 首先,在sqlite数据库中,将该ID对应的事项状态更新为“已完成(completed)”。
b. 业务规则: 任务完成后,必须向团队的钉钉群机器人通用频道发送一条通知,格式为:“任务‘[事项内容]’已经完成!”
-
-
获取所有“待办中”的事项列表:
-
用户通过API GET /todos/pending 请求,获取所有还未完成的任务。
-
系统查询sqlite数据库,找出所有状态为“待办中”的事项。
-
将查询到的事项列表作为JSON数组返回。
-