快速入门指南 - Archyl Docs

5 分钟内开始使用 Archyl - 创建您的第一个架构图

快速入门指南

本指南将帮助您在几分钟内在 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 处理支付")

步骤 6:深入容器层级

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

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

后续步骤

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

成功秘诀

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