# architecture-diagram

**Repository Path**: dkbnull/architecture-diagram

## Basic Information

- **Project Name**: architecture-diagram
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-10
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# architecture-diagram · 架构图绘制 SKILL

按 **C4 Model** 绘制架构图：支持 C1 System Context、C2 Container、C3 Component 与部署图。所有样式都**直接产出 SVG 并导出 PNG**，不生成 DSL/PlantUML/Mermaid 等中间源文件。

本 SKILL 提供 **3 种视觉样式**，建模规则与几何避障准则全部样式共享，差异只在视觉外观。

## 样式总览与叫法对照

使用时可直接说「样式1」「风格1」「style-1」或样式别名，均映射到同一目录：

| 序号 | 目录 | 别名 | 适合场景 |
|------|------|------|----------|
| 样式1（默认） | [style-1](skills/style-1/SKILL.md) | 浅色精确坐标 / 浅色主题 | 通用交付、对外展示 |
| 样式2 | [style-2](skills/style-2/SKILL.md) | 深色精确坐标 / 深色主题 | 深色模式文档、暗色 PPT/大屏 |
| 样式3 | [style-3](skills/style-3/SKILL.md) | Structurizr 风格 / 黑白灰极简 | 工程师审美、文档化交付 |

每个样式的建模规则、视觉规范与示例清单见对应目录的 SKILL.md。

## 用法

1. **指定样式**：说「用样式N画…」或「用 Structurizr 风格画…」；未指定时默认使用样式1。
2. **指定视图层级**：C1 系统上下文 / C2 容器图（默认）/ C3 组件图 / 部署图。
3. **给出节点与关系**：列出系统、服务、数据存储及调用关系；也可以只给业务描述，由 SKILL 先建模再确认。
4. **产物**：SKILL 直接产出 SVG（精确坐标、零交叉、禁穿组件），并导出 2x PNG。

## 示例

同一电商系统模型在 3 种样式下的效果对比（`container-diagram.png` / `deployment-diagram.png`）。

### 场景一：C2 容器图（用户 → Web应用 → API网关 → 订单/用户/库存服务 → MySQL/Redis/RocketMQ）

**样式1（style-1 · 浅色精确坐标）**

![样式1 容器图](skills/style-1/examples/container-diagram.png)

**样式2（style-2 · 深色精确坐标）**

![样式2 容器图](skills/style-2/examples/container-diagram.png)

**样式3（style-3 · Structurizr 黑白灰）**

![样式3 容器图](skills/style-3/examples/container-diagram.png)

### 场景二：多环境部署图（APP/WEB → NGINX 路由 → DEV/TEST/PROD 三环境 → 统一备份服务器）

**样式1（style-1 · 浅色精确坐标）**

![样式1 部署图](skills/style-1/examples/deployment-diagram.png)

**样式2（style-2 · 深色精确坐标）**

![样式2 部署图](skills/style-2/examples/deployment-diagram.png)

**样式3（style-3 · Structurizr 黑白灰）**

![样式3 部署图](skills/style-3/examples/deployment-diagram.png)