1# Clean Architecture
2
3## Layers
4
5> **Note:** This document describes conceptual architecture layers. The actual project structure uses `internal/` prefixes (e.g., `internal/application/usecase/`, `internal/application/port/`, `internal/infrastructure/`) to organize the code.
6
7| Layer | Contains | Depends On |
8|-------|----------|------------|
9| `app/` | Entry points, CLI/TUI, request handling | usecase |
10| `usecase/` | Business logic, orchestration | domain, boundaries |
11| `domain/` | Entities, value objects, utils | nothing |
12| `boundaries/in` | Inbound interfaces (services) | domain |
13| `boundaries/out` | Outbound interfaces (repos, clients) | domain |
14| `adapters/` | Interface implementations | boundaries, domain |
15
16## Rules
17
18- **app**: Parse input, call usecase, format output. No business logic.
19- **usecase**: All business logic. Use boundaries for I/O.
20- **domain**: Pure functions only. No I/O.
21- **boundaries**: Interfaces only. Mock with `mockery generate`.
22
23## Anti-patterns strictly forbidden
24
25```text
26❌ app doing business logic
27❌ app calling adapters directly
28❌ usecase importing adapters
29❌ domain importing anything
30```
31
32## Commands
33
34Run before committing:
35- `make lint` - golangci-lint
36- `make test` - unit tests
37- `make check` - verify build, tests, tools
38- `go fmt ./...` - format code
39
40## Misc
41
42- vendor dir is gitignored
43- Ignore Chromium's `--ozone-platform=wayland is not compatible with Vulkan` log message. It is a deprecated warning: Dumber's CEF Wayland + ANGLE/Vulkan stack is compatible and functional. Do not cite this message as evidence of a rendering incompatibility or use it as a root-cause hypothesis.