案例介绍

本案例将基于华为云码道（CodeArts）代码智能体的规范驱动模式快速搭建乒乓球爱好者网站

案例内容

一、概述

1.1 案例介绍

华为云码道（CodeArts）代码智能体是基于智能生成、智能问答两大核心能力构建起一套全方位、多层次的智能开发体系。在智能生成方面，它能够依据开发者输入的需求描述，准确且高效地生成高质量代码；智能问答功能则如同开发者身边的专属技术顾问。

规范驱动模式（Spec-Driven Mode）：以明确的技术或业务规范为基础，指导系统设计、开发及验证的工程方法论。在该模式下，所有开发活动均围绕既定的规范展开，确保最终成果在功能、性能、兼容性等方面与规范高度一致。适用于对一致性、可验证性有高要求的场景。

本案例将基于华为云码道（CodeArts）代码智能体的规范驱动模式快速搭建乒乓球爱好者网站。

1.2 适用对象

• 乒乓球爱好者
• 个人开发者与技术爱好者
• 高校学生和研究人员

1.3 案例时间

本案例总时长预计60分钟。

1.4 案例流程

说明：

• 用户安装 CodeArts 代码智能体。
• 在聊天界面的模式选择中，单击“规范驱动模式”，切换智能体到规范驱动模式。
• 在对话框输入您想要完成的任务，单击发送图标 或使用“Enter”快捷键发送，智能体会按照“需求规格设计 > 实现方案创建 > 编码任务规划 > 任务执行”流程依次执行，确保每一步都高效、有序地推进。
• 运行系统并测试功能

1.5 资源总览

本案例预计花费**0元。

资源名称	规格	单价（元）
华为云码道（CodeArts）代码智能体	AI IDE	免费

二、基础环境与资源准备

2.1 AI IDE华为云码道安装部署

参考案例《Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署》完成Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署。

三、世界乒乓网系统代码实战

3.1 规范驱动模式创建项目

选择“智能体”，并且选择“规范驱动模式”

作为一个乒乓球爱好者，希望有个平台可以同附近球友交流，组织比赛，故此设计了一个乒乓球web网站，该网站设计主要分为四个模块：积分排名系统、赛事管理系统、俱乐部交流模块、用户管理系统。

输入以下提示词创建项目：

c复制代码

使用Python语言设计一个面向乒乓球爱好者的轻量化社区网站，项目名称为：世界乒乓爱好者网站。
网站核心定位：服务业余乒乓球爱好者，提供积分排名查询、赛事报名、俱乐部交流的基础线上平台，整体功能简洁易懂。

技术栈要求：
1. 开发语言：Python
2. 后端框架：轻量级Flask框架
3. 前端展示：基础HTML模板+简洁样式，页面结构清晰易读
4. 数据存储：使用SQLite数据库，预置一些数据进去以在页面上显示。

核心功能模块：
1. 积分排名系统（核心）
   - 选手积分信息展示
   - 按积分从高到低排序生成排名列表
   - 展示选手昵称、当前积分、参赛场次、段位标签
   - 支持查看个人积分概况

2. 赛事管理系统
   - 赛事信息发布与列表展示（保证管理员可以创建乒乓球赛事，每个赛事最多允许50人参加，最少2人）
   - 赛事详情查看（包含赛事名称、时间、地点、组别）
   - 在线报名： 用户可直接在网页端报名（保证用户可以和参加赛事）
   - 自动抽签与编排： 针对每个赛事生成一个自动抽签功能，系统根据报名人数自动进行随机抽签，生成对阵表
   - 已登录用户可在线报名赛事
   - 个人中心查看我的赛事报名记录

3. 俱乐部交流模块
   - 俱乐部信息首页展示
   - 管理员可以创建俱乐部（包含地点、活动时间、联系电话、收费标准）
   - 查看俱乐部简介、规模、活动信息
   - 确保已登录用户可提交俱乐部加入申请，申请后需由管理员进行审批

4. 用户管理系统
   - 用户注册、登录、退出功能
   - 个人信息查看与基础展示
   - 会话管理，未登录用户无法进行报名、申请操作

开发规范要求：
1. 代码结构清晰，注释完整详细，符合小白学习规范
2. 项目可直接运行，无需手动安装依赖
3. 自动生成完整项目文件：主程序、HTML模板、静态文件、依赖清单
4. 确保用户登陆后可以加入俱乐部和参加赛事逻辑不要出现BUG
5. 系统管理员账号：Sysadmin，密码：Huawei_1234
6. 自动生成配套的需求规格、技术设计、任务规划文档
7. 着重注意用户加入赛事和俱乐部的逻辑
8. 在首页直接展示积分排名和赛事等信息，不显示系统说明
9. 全程无复杂业务逻辑，无第三方服务依赖，纯本地运行

因为使用的模式是规范驱动模式（Spec-Driven Mode），所以任务执行过程中会依次生成需求规格、技术设计、任务规划文档，确保最终成果在功能、性能、兼容性等方面与规范高度一致。

如在生成过程中出现需要类似此信息，选择 开始实现 即可。

阶段一：创建规格说明书：定义“做什么”（What），理解项目意图、生成高质量代码的重要依据。

规格说明书内容主要包括：
项目概述：简要描述这个项目是做什么的，解决了什么问题
功能需求：详细列出软件需要实现的功能点
技术栈与约束：指定使用的编程语言、框架、数据库以及必须遵守的技术限制
接口定义：如果是后端项目，通常会包含 API 的输入输出格式
业务逻辑规则：复杂的业务判断逻辑

阶段二：创建技术设计文档：定义“怎么做”（How），告诉代码智能体应该把砖头（代码）砌在哪里，以及砌成什么样子。

技术设计内容主要包括：
系统架构：描述项目的整体结构
目录结构：指定代码文件的物理组织方式
数据模型设计：数据库表结构（Schema）。
核心算法与逻辑：针对复杂功能的详细实现步骤。
流程图描述（例如：用户登录的验证流程）。
接口定义（详细版）：比 spec.md 更具体的 API 定义，包括具体的字段名、数据类型、错误码定义等。

阶段三：创建基于需求规格和技术设计，生成详细的任务规划文档: 指挥它干活的“施工进度表”。

如果出现此提示，可点击 确认无误 让码道继续执行。

任务清单文档主要包括：
任务 ID： 用于排序和引用（如 Task-001, Task-002）。
任务标题： 简短描述（如“实现用户登录接口”）。
详细描述： 具体的开发指令（如“使用 Flask 创建路由，接收 JSON 数据”）
依赖关系： 该任务依赖哪些前置任务（如“必须先完成数据库设计”）。
验收标准： 做到什么程度算完成（如“接口返回 200 状态码”）。
状态： 标记任务是待办、进行中还是已完成。

在三个阶段完成后，可能需要我们输入以下信息进行确认。

bash复制代码

确认开始编码

接下来可以看到，码道正在通过三个阶段的设计规划来生成代码。

3.2 启动项目验收成果

在智能体对话框输入

bash复制代码

启动项目

可直接让智能体启动项目,也可以点击码道提示的地址进行访问，如果有启动问题可以与码道对话进行修复。

启动后，用户注册成功后登录到主页面。
用户可以自行注册账号登录，也可以使用系统管理员账号登录。

bash复制代码

# 系统管理员
账号：Sysadmin
密码：Huawei_1234

登陆后，首页可以查看积分排名，赛事中心，俱乐部以及个人中心等信息。

积分排行页面显示当前不同等级成员的积分排名

赛事中心页面显示当前有哪些赛事，用户可以查看并且报名

俱乐部页面显示附近的俱乐部信息，点击详情可以查看具体信息。

当用户申请加入俱乐部后，需要管理员在管理后台审批后方可加入。

管理员进行登录后可在 管理后台 进行审批。

bash复制代码

# 系统管理员
账号：Sysadmin
密码：Huawei_1234

注意：由于本应用是CodeArts代码智能体自动生成，每次提问生成的代码及最后的运行结果均存在出入，开发者可根据自己的需求，调教模型生成自己想要的结果。若想体验与案例一样的结果，请下载源码进行体验。

至此，年轻人的运动网站！用码道快速开发乒乓球互动平台案例结束。

五、反馈改进建议

如您在案例实操过程中遇到问题或有改进建议，可以到论坛帖评论区反馈即可，我们会及时响应处理，谢谢！