Files
cv-site/_go-learning/diagrams/README.md
T
juanatsap faf3a2ca45 docs: Add comprehensive system architecture diagrams
Created detailed ASCII diagrams documenting the entire system architecture:

1. System Architecture (_go-learning/diagrams/01-system-architecture.md)
   - Overall system architecture with client/server/storage layers
   - Layered architecture (Presentation → Application → Business → Data)
   - Component interaction and HTTP request flow
   - Data flow from app start through per-request lifecycle
   - Package dependencies and file organization
2025-11-20 20:17:29 +00:00

51 lines
1.6 KiB
Markdown

# 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