Add infrastructure documentation and project setup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -1,2 +1,61 @@
-# otivm
+# OTIVM
 
+*otium* — Latin: leisure, rest, creative withdrawal. The condition under which civilisation advances.
+
+OTIVM is a browser-based idle game with a Classical Roman motif. It is a standalone light-hearted project under TheRON, intended as a low-pressure development activity and a public-facing entry point to the Roman world shared across TheRON projects.
+
+---
+
+## Concept
+
+You are a Roman merchant. You start with a single trade route and a handful of denarii. You build a network spanning the known world — from Ostia to Alexandria — one dispatch at a time. The narrative unfolds through the goods you trade and the journal entries they unlock.
+
+The core tension is Roman in origin: *otium* versus *negotium* — leisure versus productive work. Active trading accumulates wealth. Rest and reflection accumulate *auctoritas* — the reputation and wisdom that unlocks what comes next.
+
+---
+
+## Where It Runs
+
+| Property | Value |
+|----------|-------|
+| URL | https://otium.civicus.us |
+| Container | LXC 1105 (otivm-dev) on srv-a |
+| WireGuard | 10.110.0.18 |
+| LAN IP | 10.0.0.23 |
+| App port | 3000 |
+| App user | otivm |
+| Process manager | PM2 (pm2-otivm systemd service) |
+| Proxy | Nginx on wg-pk (198.58.111.109) |
+
+---
+
+## Stack
+
+- **Frontend:** React 19, Vite
+- **Runtime:** Node.js v22
+- **Process manager:** PM2 under otivm user
+- **Python:** venv at /home/otivm/venv (auto-activates on login)
+
+---
+
+## Repository
+
+- **Gitea:** https://gitea.barternetwork.us/TheRON/OTIVM
+- **Branch:** main
+- **Push node:** otivm@otivm-dev (10.0.0.23)
+- **License:** BSD 2-Clause
+
+---
+
+## Design Principles
+
+- One screen, one resource loop — ship fast
+- Narrative unfolds through goods and journal entries, not cutscenes
+- Roman vocabulary throughout — Latin terms, Roman place names, Roman motifs
+- Atmosphere carries quiet references to Mesolithic cultures and trade routes — the deep prehistory beneath the Roman world
+- Never academic, always entertaining
+- No backend required initially — React artifact first
+
+---
+
+*OTIVM is part of TheRON — The Residential Owner-operated Network.*