# 7. Deployment View

Describes:

1. Technical infrastructure used to execute your system, with infrastructure elements like geographical locations, environments, computers, processors, channels and net topologies.
2. Mapping of (software) building blocks to that infrastructure elements.

## Infrastructure Level 1

```text
┌────────────────────────────────────────────┐
│  Host / VM                                 │
│  ┌─────────────┐  ┌────────────────────┐   │
│  │  frontend   │  │      backend       │   │
│  │  (Flask)    │  │    (FastAPI)       │   │
│  │  :12016     │  │    :12015          │   │
│  └──────┬──────┘  └─────────┬──────────┘   │
│         │                   │              │
│         └────────┬──────────┘              │
│                  │                         │
│          ┌───────▼────────┐                │
│          │  db (DuckDB)   │                │
│          │  data/app.db   │                │
│          └────────────────┘                │
└────────────────────────────────────────────┘
```

**Motivation:** All three components run on a single VM (or as Docker containers) for simplicity and low operational overhead.

**Quality and/or Performance Features:** The frontend and backend are stateless; DuckDB persists data on the host filesystem.

**Mapping of Building Blocks to Infrastructure:**

| Building Block  | Container / Process          | Port  |
| --------------- | ---------------------------- | ----- |
| Flask frontend  | `frontend`                   | 12016 |
| FastAPI backend | `backend`                    | 12015 |
| DuckDB          | File on host (`data/app.db`) | —     |

## Infrastructure Level 2

### Coolify with Nixpacks (Production)

Both services are deployed as separate Nixpacks resources in Coolify:

```text
┌──────────────────────────────────────────────────────────┐
│  Coolify Server                                          │
│  ┌────────────────────────────┐                          │
│  │ Backend Service (FastAPI)  │                          │
│  │ - Base Dir: /backend       │                          │
│  │ - Port: 12015              │                          │
│  │ - Volume: /app/data        │                          │
│  ├────────────────────────────┤                          │
│  │ Frontend Service (Flask)   │                          │
│  │ - Base Dir: /frontend      │                          │
│  │ - Port: 12016 (public)     │                          │
│  │ - BACKEND_URL: :12015      │                          │
│  └────────────────────────────┘                          │
│                   ▲                                      │
│         Coolify reverse proxy (TLS termination)          │
└──────────────────────────────────────────────────────────┘
                    │
                 Users / Internet
```

**Deployment Steps:**

1. Create backend Nixpacks service in Coolify with Base Directory `/backend`
2. Create frontend Nixpacks service with Base Directory `/frontend`
3. Set environment variables per service
4. Attach domain to frontend on port `12016`
5. Enable Auto HTTPS in Coolify

**See**: [Coolify Deployment Guide](./deployment/coolify.md) for detailed instructions.