Polish README for public release

- Quick Start: docker run as primary, docker compose as alternative
- Generalize FritzBox references to Modem in descriptions
- Add ADMIN_PASSWORD to env var table
- Add auth and light/dark mode to features list
- Fix Reference Values column header (Bad -> Poor)
- Add Contributing and License links
- Remove hardcoded auto-refresh interval

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

Author: itsDNNS

README.md

@@ -12,57 +12,76 @@
 
 ## Features
 
-- **Per-Channel Sensors**: Every downstream/upstream DOCSIS channel becomes its own Home Assistant sensor with full attributes (frequency, modulation, SNR, errors, DOCSIS version)
+- **Web Dashboard**: Real-time channel data with health assessment, trend charts, and calendar navigation
+- **Per-Channel Sensors**: Every downstream/upstream DOCSIS channel becomes its own Home Assistant sensor with full attributes
 - **Summary Sensors**: Aggregated metrics (power min/max/avg, SNR, error counts, overall health)
-- **Health Assessment**: Automatic traffic-light evaluation based on industry-standard thresholds
-- **Web UI**: Built-in dashboard on port 8765 with timeline navigation and light/dark mode
+- **Health Assessment**: Automatic traffic-light evaluation with actionable recommendations
 - **Setup Wizard**: Browser-based configuration - no .env file needed
 - **Settings Page**: Change all settings at runtime, test connections, toggle themes
 - **Internationalization**: English and German UI
-- **LLM Export**: Generate structured reports for AI analysis
+- **LLM Export**: Generate structured reports for AI analysis (ChatGPT, Claude, Gemini, etc.)
 - **MQTT Auto-Discovery**: Zero-config integration with Home Assistant
+- **Optional Authentication**: Password-protected web UI with scrypt hashing
+- **Light/Dark Mode**: Persistent theme toggle
 
 ## Quick Start
 
+```bash
+docker run -d --name docsight -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latest
+```
+
+Open `http://localhost:8765` - the setup wizard guides you through configuration.
+
+### Using Docker Compose
+
 ```bash
 git clone https://github.com/itsDNNS/docsight.git
 cd docsight
 docker compose up -d
 ```
 
-Open `http://localhost:8765` - the setup wizard guides you through configuration.
-
 ## Configuration
 
-Configuration is stored in `config.json` inside the Docker volume and persists across restarts. You can also use environment variables (they override config.json values).
+Configuration is stored in `config.json` inside the Docker volume and persists across restarts. Environment variables override config.json values.
 
 ### Via Web UI (recommended)
 
 1. Start the container - the setup wizard opens automatically
-2. Enter FritzBox URL, username, and password - test the connection
-3. Optionally enter MQTT broker details - test the connection
-4. Set poll interval and history retention
+2. Enter your modem URL, username, and password - test the connection
+3. Optionally configure MQTT broker for Home Assistant integration
+4. Set poll interval, history retention, and language
 5. Done - monitoring starts immediately
 
-Access `/settings` at any time to change configuration or toggle light/dark mode.
+Access `/settings` at any time to change configuration, set an admin password, or toggle light/dark mode.
 
 ### Via Environment Variables (optional)
 
 Copy `.env.example` to `.env` and edit:
 
 | Variable | Default | Description |
 |---|---|---|
-| `FRITZ_URL` | `http://192.168.178.1` | FritzBox URL |
-| `FRITZ_USER` | - | FritzBox username |
-| `FRITZ_PASSWORD` | - | FritzBox password |
-| `MQTT_HOST` | `localhost` | MQTT broker host |
+| `FRITZ_URL` | `http://192.168.178.1` | Modem URL |
+| `FRITZ_USER` | - | Modem username |
+| `FRITZ_PASSWORD` | - | Modem password |
+| `MQTT_HOST` | - | MQTT broker host (optional) |
 | `MQTT_PORT` | `1883` | MQTT broker port |
 | `MQTT_USER` | - | MQTT username (optional) |
 | `MQTT_PASSWORD` | - | MQTT password (optional) |
 | `MQTT_TOPIC_PREFIX` | `docsight` | MQTT topic prefix |
 | `POLL_INTERVAL` | `300` | Polling interval in seconds |
 | `WEB_PORT` | `8765` | Web UI port |
 | `HISTORY_DAYS` | `7` | Snapshot retention in days |
+| `ADMIN_PASSWORD` | - | Web UI password (optional) |
+
+## Screenshots
+
+| Dashboard (Dark) | Dashboard (Light) | Setup Wizard |
+|---|---|---|
+| ![Dark](docs/screenshots/dashboard-dark.png) | ![Light](docs/screenshots/dashboard-light.png) | ![Setup](docs/screenshots/setup.png) |
+
+| Trend Charts | Health Banner |
+|---|---|
+| ![Trends](docs/screenshots/trends.png) | ![Health](docs/screenshots/health-banner.png) |
 
 ## Created Sensors
 
@@ -87,37 +106,21 @@ Copy `.env.example` to `.env` and edit:
 
 ## Reference Values
 
-| Metric | Good | Marginal | Bad |
+| Metric | Good | Marginal | Poor |
 |---|---|---|---|
 | DS Power | -7..+7 dBmV | +/-7..+/-10 | > +/-10 dBmV |
 | US Power | 35..49 dBmV | 50..54 | > 54 dBmV |
 | SNR / MER | > 30 dB | 25..30 | < 25 dB |
 
-## Screenshots
-
-| Dashboard (Dark) | Dashboard (Light) | Setup Wizard |
-|---|---|---|
-| ![Dark](docs/screenshots/dashboard-dark.png) | ![Light](docs/screenshots/dashboard-light.png) | ![Setup](docs/screenshots/setup.png) |
-
-| Trend Charts | Health Banner |
-|---|---|
-| ![Trends](docs/screenshots/trends.png) | ![Health](docs/screenshots/health-banner.png) |
-
-## Web UI
-
-Access at `http://<host>:8765`. Auto-refreshes every 60 seconds. Shows:
-- Health status with actionable recommendations
-- Summary metrics and tariff info
-- Full downstream/upstream channel tables with per-row health indicators
-- Trend charts (day/week/month)
-- Calendar navigation for historical snapshots
-- LLM export for AI-powered analysis
-
 ## Requirements
 
 - AVM FRITZ!Box Cable router (tested with 6690 Cable)
 - MQTT broker (e.g., Mosquitto) - optional, for Home Assistant integration
 
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
 ## License
 
-MIT
+[MIT](LICENSE)