---
title: "Service Architecture Reference"
description: "- **Purpose:** Primary database - **Port:** 5432 - **Credentials:** polar/polar - **Volume:** postgres_data - **Health check:** pg_isready (2s interval)"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/service-architecture
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:46:42.307Z
license: CC-BY-4.0
attribution: "Service Architecture Reference — Claudary (https://claudary.paisolsolutions.com/skills/service-architecture)"
---

# Service Architecture Reference
- **Purpose:** Primary database - **Port:** 5432 - **Credentials:** polar/polar - **Volume:** postgres_data - **Health check:** pg_isready (2s interval)

## Overview

---
title: Service Architecture Reference
category: Reference
tags: architecture, services, infrastructure
---

# Service Architecture Reference

## Infrastructure Services

### db (PostgreSQL 15.1)

- **Purpose:** Primary database
- **Port:** 5432
- **Credentials:** polar/polar
- **Volume:** postgres_data
- **Health check:** pg_isready (2s interval)

### redis (Redis Alpine)

- **Purpose:** Cache and job queue backend
- **Port:** 6379
- **Health check:** redis-cli ping

### minio (S3-Compatible Storage)

- **Purpose:** File storage
- **Ports:** 9000 (API), 9001 (Console)
- **Credentials:** polar/polarpolar
- **Volume:** minio_data
- **Buckets:** polar-s3, polar-s3-public

## Application Services

### api (FastAPI Backend)

- **Purpose:** REST API server
- **Port:** 8000
- **Image:** Python 3.14 + uvicorn
- **Hot-reload:** Enabled
- **Startup tasks:**
    - Sync dependencies
    - Build email templates
    - Run migrations
    - Load seed data

### worker (Background Jobs)

- **Purpose:** Async task processing
- **Image:** Same as API
- **Queues:** high_priority, medium_priority, low_priority
- **Hot-reload:** Enabled
- **Depends on:** API (waits for initialization)

### web (Next.js Frontend)

- **Purpose:** User interface
- **Port:** 3000
- **Image:** Node 24 + Turbopack
- **Memory limit:** 4GB
- **Hot-reload:** Enabled

## Optional Monitoring

### prometheus

- **Purpose:** Metrics collection
- **Port:** 9090
- **Retention:** 1 day
- **Enable:** --monitoring flag

### grafana

- **Purpose:** Dashboards
- **Port:** 3001
- **Credentials:** polar/polar
- **Enable:** --monitoring flag

## Container Dependencies

```
minio-setup → minio (healthy)
api → db (healthy), redis (healthy), minio-setup (complete)
worker → db, redis, minio-setup, api (started)
web → api (started)
grafana → prometheus (started)
```

## Volume Persistence

| Volume           | Purpose            |
| ---------------- | ------------------ |
| postgres_data    | Database           |
| minio_data       | Files              |
| server_uv_cache  | Python packages    |
| api_venv         | API virtual env    |
| worker_venv      | Worker virtual env |
| pnpm_store       | Node packages      |
| web_node_modules | Frontend deps      |
| web_next_cache   | Build cache        |

## Network

All services on internal Docker network using service names:

- `db:5432`
- `redis:6379`
- `minio:9000`
- `api:8000`

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/service-architecture) · https://claudary.paisolsolutions.com