快速入门指南

本指南将帮助您在几分钟内在 Archyl 中创建您的第一个架构图。

步骤 1：创建帐户

1. 前往 app.archyl.com
2. 使用电子邮件注册或通过 GitHub、GitLab 或 Bitbucket 连接
3. 如果使用电子邮件注册，请验证您的电子邮件

登录后，您将进入仪表板——管理所有项目的指挥中心：

步骤 2：创建您的第一个项目

1. 在仪表板上点击 "新建项目"
2. 输入项目名称（例如"我的电商平台"）
3. 可选添加描述和标签
4. 点击 "创建项目"

步骤 3：添加您的第一个系统

1. 在新项目中，您将从 系统上下文 级别开始
2. 点击 "+" 按钮或在画布上右键点击
3. 选择 "添加系统"
4. 输入名称（例如"电商平台"）
5. 添加系统功能描述

步骤 4：添加外部系统

真实系统不是孤立存在的。添加您的软件与之交互的外部系统：

1. 点击 "+" 并选择 "添加外部系统"
2. 添加如"支付网关"、"邮件服务"、"CDN"等系统
3. 这些将以不同的样式显示，表明它们是外部的

步骤 5：创建关系

展示系统之间的通信方式：

1. 点击源系统
2. 从连接点拖动到目标系统
3. 添加描述关系的标签（例如"通过 API 处理支付"）

下面是一个完整的系统上下文视图——人员、系统和外部提供方通过带标签的关系相连：

点击任意元素即可打开其详细信息——描述、负责人、关联的决策、文档和 API 契约：

步骤 6：深入容器层级

双击您的主系统以深入到容器层级：

1. 添加如"Web 应用程序"、"API 服务器"、"数据库"等容器
2. 展示它们之间的通信方式
3. 将它们连接到外部系统

后续步骤

恭喜！您已创建了第一个架构图。接下来可以探索：

• 连接仓库 - 让 AI 自动发现您的架构
• AI 发现 - 了解 AI 如何分析您的代码库
• 团队协作 - 邀请您的团队成员
• 导出和分享 - 与利益相关者分享您的图表

成功秘诀

• 从高层开始：先从系统上下文开始，再深入细节
• 使用清晰的名称：为系统和容器取描述性名称
• 添加描述：未来的您（和您的团队）会感谢您的
• 持续迭代：架构文档是动态的——随着系统演进不断更新