From fbb6f6170523c845e10d089333670ec91c5f0c0b Mon Sep 17 00:00:00 2001
From: erik <erik@mosswart.snakedesert.se>
Date: Mon, 22 Sep 2025 18:25:07 +0000
Subject: [PATCH] Updated README.md

---
 README.md | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 93ff64a6..ecc22f92 100644
--- a/README.md
+++ b/README.md
@@ -31,12 +31,22 @@ This project provides:
 - **GET /history**: Retrieve historical telemetry data with optional time filtering.
 - **GET /debug**: Health check endpoint.
 - **Live Map**: Interactive map interface with panning, zooming, and sorting.
-- **Inventory Management**: 
+- **Inventory Management**:
   - Real-time inventory updates via WebSocket on character login/logout
   - Advanced search across all character inventories
   - Filter by character, equipment type, material, stats, and more
   - Sort by any column with live results
   - Track item properties including spells, armor level, damage ratings
+- **Suitbuilder**:
+  - Equipment optimization across multiple character inventories
+  - Constraint-based search for optimal armor combinations
+  - Support for primary and secondary armor sets
+  - Real-time streaming results during long-running searches
+- **Portal Tracking**:
+  - Automatic discovery and tracking of in-game portals
+  - 1-hour retention for discovered portals
+  - Coordinate-based uniqueness (rounded to 0.1 precision)
+  - Real-time portal updates on the map interface
 - **Discord Rare Monitor Bot**: Monitors rare discoveries and posts filtered notifications to Discord channels
 - **Sample Data Generator**: `generate_data.py` sends telemetry snapshots over WebSocket for testing.
 
@@ -82,6 +92,27 @@ Python packages (if using local virtualenv):
 
 ## Usage
 
+### Using Docker (Recommended)
+
+1. Build and start all services:
+   ```bash
+   docker compose up -d
+   ```
+
+2. Rebuild container after code changes:
+   ```bash
+   docker compose build --no-cache dereth-tracker
+   docker compose up -d dereth-tracker
+   ```
+
+3. View logs:
+   ```bash
+   docker logs mosswartoverlord-dereth-tracker-1
+   docker logs dereth-db
+   ```
+
+### Without Docker
+
 Start the server using Uvicorn:
 
 ```bash
@@ -310,6 +341,14 @@ aggregate character statistics, and a separate inventory database for equipment
   - `timestamp` (timestamptz)
   - `ew`, `ns`, `z` (float)
 
+- **portals**:
+  - `id` (PK, serial)
+  - `portal_name` (text)
+  - `ns`, `ew`, `z` (float coordinates)
+  - `discovered_at` (timestamptz, indexed)
+  - `discovered_by` (text)
+  - Unique constraint: `ROUND(ns::numeric, 1), ROUND(ew::numeric, 1)`
+
 ### Inventory Database Tables:
 
 - **items**: