initial, step 2 already

PORTS.md

@@ -0,0 +1,53 @@
+# Port Configuration
+
+This document describes the port allocation for the home automation services.
+
+## Port Scan Results (31. Oktober 2025)
+
+### Ports in Use
+- **8000**: In use (likely API server)
+- **8021**: In use (system service)
+- **8080**: In use (system service)
+- **8100**: In use (system service)
+- **8200**: In use (system service)
+- **8770**: In use (system service)
+
+### Free Ports Found
+- **8001**: FREE ✓
+- **8002**: FREE ✓
+- **8003**: FREE ✓
+- **8004**: FREE ✓
+- **8005**: FREE ✓
+
+## Service Port Allocation
+
+| Service | Port | Purpose |
+|---------|------|---------|
+| API     | 8001 | FastAPI REST API for capabilities and health checks |
+| UI      | 8002 | FastAPI web interface with Jinja2 templates |
+| (Reserved) | 8003 | Available for future services |
+| (Reserved) | 8004 | Available for future services |
+| (Reserved) | 8005 | Available for future services |
+
+## Access URLs
+
+- **API**: http://localhost:8001
+  - Health: http://localhost:8001/health
+  - Spec: http://localhost:8001/spec
+  - Docs: http://localhost:8001/docs
+
+- **UI**: http://localhost:8002
+  - Main page: http://localhost:8002/
+
+## Starting Services
+
+```bash
+# Start API
+poetry run uvicorn apps.api.main:app --reload --port 8001
+
+# Start UI
+poetry run uvicorn apps.ui.main:app --reload --port 8002
+
+# Start Abstraction Worker (no port - MQTT client)
+poetry run python -m apps.abstraction.main
+```