你的首个项目

本指南将带你通过民宿管理系统中的“房间预订及积分下单”需求进行实战，快速上手 Toco AI 的核心流程，了解其中的AI时代建模驱动开发的思路。

业务背景: 会员将房型和数量加入购物车后一次性下单。系统需验证房源：房源充足确认支付生成预约支付成功的订单，扣减积分并记录消费详情。

前提条件

已安装并配置 Toco AI IntelliJ IDEA 插件。VS Code 插件正在开发中。

新建 Toco 项目

Toco 独特的 建模驱动开发 (MDD) 能力仅限在 Toco Project 中使用。目前支持 Java Spring 体系，更多语言持续更新中。

注：在普通项目中，Toco 仍可作为传统 AI Coding 助手 使用。

输入需求文档

在 Agent Chat 窗口中，通过附件输入需求文档。

领域建模

AI 架构师 (Domain Architect) 会自动生成需求的 领域模型（包含 ER 图、值对象、聚合对象等）。

本例核心： 聚合对象包含“订单信息”（包含订单主表booking_order、订单项表order_item等）。
灵活修改： 你可以通过对话要求 Toco 修改，或直接在可视化编辑器中手动调整。

小贴士：随时查看设计模型

点击对话框中的 Toco 图标，即可随时进入查看或编辑所有模块的领域模型、服务模型等。

需求拆解

Toco Agent 会将需求拆解为多个 API。

你可以选择在当前会话批量完成这些API，或将其放入 待办清单 稍后处理，待办清单中的API支持手动编辑。

小贴士：管理待办

通过对话框的 待办图标，可以随时查看所有的待办。完成的待办需要手动标注。

开启独立会话完成 API

从待办清单中针对“基于购物车创建订单”接口开启 独立会话。

注：你也可以将多个API放在一个会话中解决。但不建议在一个会话中放入过多复杂接口，以保证减少上下文以提升会话质量。

设计方案规划

Planner Agent 规划初步细节。包含API出入参数、流程、读写链路初步设计等。
确认后无误后，Designer Agent 基于规划，完成相关服务建模：
- 读模型 (Read Model)：
  - Toco-DTO（服务传输对象）：基于外键扩展的多表聚合形成的数据结构。例如：在“房型详情DTO”中组装该房型下的订单项列表（通过外键room_type_id进行对象扩展）。
  - 读方案：基于DTO作为返回值，面向对象的查询方式，支持高效的跨表检索。例如：
    - 可根据 ID、编码、总房间数等条件筛选房型：id in #roomTypeIdList AND room_type_code in #roomTypeCodeIn AND total_quantity >= #totalQuantityBiggerThanEqual
    - 并同步获取该房型在特定日期范围内的有效订单明细：filter orderItemList: order_item_status in #orderItemListOrderItemStatusIn AND order.check_in_date >= checkInDateBiggerThanEqual AND order.check_out_date <= checkOutDateLessThanEqual
  - 读方案是高效的读建模表达：将同时确认返回值、查询方式、组装数据方式、入参、对应Service/API。
- 写模型 (Write Model)：用于定义面向聚合对象的业务变更与事务逻辑。例如：在“下单”流程中，通过写方案同步执行创建订单及其明细（写方案1）、扣减积分并记录消费详情（写方案2）等操作。
  - 【写方案1】创建订单及其明细：描述同时创建两张表（booking_order, order_item）的记录。
  - 【写方案2】扣减积分并记录消费详情：描述更新member的积分同时创建对应的points_transaction记录。
- 写方案是高效的写服务建模表达：将同时确认入参，对应Service/API，定位业务对象和变更方式。

代码生成：80/20 原则

Toco 内置 M2C (Model To Code) 引擎，将代码分为两部分：

结构性代码 (约 80%)： 由引擎根据上述所有建模信息直接生成。遵循 DDD 和 CQRS 规范，架构标准且 100% 准确，无需人工 Review。
胶水代码 (约 20%)： 由 Developer Agent 编写剩余的业务逻辑。你仅需 Review 这部分“胶水代码”（如：预订的房型数量是否可用、积分是否充足的判断、生日优惠逻辑等）。

运行与测试

数据库同步： 自动/手动进行 Schema 同步 与管理。
Mock 测试：直接通过 Toco 内置工具验证 API 逻辑。