# Architecture Diagrams

Visual representations of the CV website architecture, data flow, and component relationships.

## Available Diagrams

1. [System Architecture](./01-system-architecture.md) - Overall system design
2. [Request Flow](./02-request-flow.md) - HTTP request lifecycle
3. [Middleware Chain](./03-middleware-chain.md) - Middleware execution order
4. [Handler Organization](./04-handler-organization.md) - Handler file structure
5. [Data Models](./05-data-models.md) - CV and UI data structures
6. [Error Handling Flow](./06-error-handling-flow.md) - Error propagation and handling
7. [Template Rendering](./07-template-rendering.md) - Template compilation and rendering
8. [PDF Generation](./08-pdf-generation.md) - PDF export process

## Diagram Format

All diagrams are created using ASCII art for:
- Easy version control (text-based)
- Universal compatibility (no special tools needed)
- Fast loading and rendering
- Copy-paste friendly

## Reading Diagrams

```
┌─────┐
│ Box │  = Component or module
└─────┘

  ↓     = Data flow direction
  →

┌─┬─┐
│A│B│   = Multiple components side by side
└─┴─┘

┌───────┐
│   ┌───┤  = Nested components
│   └───┘
└───────┘
```

## Conventions

- **Solid lines** (`─`, `│`): Direct dependencies
- **Arrows** (`→`, `↓`): Data flow direction
- **Boxes** (`┌─┐`): Components, modules, files
- **Double lines** (`═`, `║`): Important/critical paths
- **Dotted** (`:`, `.`): Optional or conditional paths