Finalize first Python release

.env.example

@@ -1,22 +1,32 @@
+# Required: bootstrap and core app settings.
+# These values should be set before the container starts.
 APP_NAME=Home Automation Backend (Python)
 APP_ENV=production
-APP_DEBUG=false
 APP_HOSTNAME=home-automation.example.com
-APP_DATABASE_URL=sqlite:///./data/app.db
+APP_DATABASE_URL=sqlite:////app/data/app.db
+LOCATION_DATABASE_URL=sqlite:////app/data/locationRecorder.db
+POO_DATABASE_URL=sqlite:////app/data/pooRecorder.db
 AUTH_BOOTSTRAP_USERNAME=admin
-AUTH_BOOTSTRAP_PASSWORD=admin
-AUTH_SESSION_COOKIE_NAME=home_automation_session
-AUTH_SESSION_TTL_HOURS=12
-AUTH_COOKIE_SECURE_OVERRIDE=true
-LOCATION_DATABASE_URL=sqlite:///./data/locationRecorder.db
-POO_DATABASE_URL=sqlite:///./data/pooRecorder.db
+AUTH_BOOTSTRAP_PASSWORD=change-me
+
+# Optional: runtime overrides.
+# Leave these commented out to use the application's built-in defaults.
+# APP_DEBUG=
+# AUTH_SESSION_COOKIE_NAME=
+# AUTH_SESSION_TTL_HOURS=
+# AUTH_COOKIE_SECURE_OVERRIDE=
+
+# Optional: Home Assistant integration.
+# Leave these empty when Home Assistant integration is not needed.
+HOME_ASSISTANT_BASE_URL=
+HOME_ASSISTANT_AUTH_TOKEN=
 POO_WEBHOOK_ID=
-POO_SENSOR_ENTITY_NAME=sensor.test_poo_status
-POO_SENSOR_FRIENDLY_NAME=Poo Status
+POO_SENSOR_ENTITY_NAME=
+POO_SENSOR_FRIENDLY_NAME=
+
+# Optional: TickTick integration.
+# APP_HOSTNAME is used to derive the OAuth callback URI automatically.
 TICKTICK_CLIENT_ID=
 TICKTICK_CLIENT_SECRET=
 TICKTICK_TOKEN=
-HOME_ASSISTANT_BASE_URL=http://localhost:8123
-HOME_ASSISTANT_AUTH_TOKEN=
-HOME_ASSISTANT_TIMEOUT_SECONDS=1.0
 HOME_ASSISTANT_ACTION_TASK_PROJECT_ID=