docs: update comments, docstrings, README, REVIEW, and env docs to match current features

templates/admin/dashboard.html

@@ -10,8 +10,8 @@
   <style>
     /*
       Operator dashboard queue.
-      Shows all requests in a table, with status filters,
-      per-row Open/Delete actions, and a topbar Reset System button.
+      Shows all requests in a table with status filters, per-row Open/Delete
+      actions, a Settings link, auto-refresh hint, and logout.
     */
     body{
       font-family:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;

templates/admin/request.html

@@ -6,9 +6,11 @@
   <title>Request #{{ req.id }} — Admin</title>
   <style>
     /*
-      Two-column admin detail page.
-      Left column: customer context + workflow.
-      Right column: operator tools + delivery.
+      Operator detail page for a single request.
+      Two-column layout:
+        left  -> customer info + internal operator notes
+        right -> Suno prompt, song upload, customer notification,
+               payment reference, and file delivery.
     */
     *{box-sizing:border-box;}
     body{

templates/admin/settings.html

@@ -7,8 +7,9 @@
   <style>
     /*
       Admin settings / maintenance page.
-      Two-column layout for revision limit, auto-refresh, SMTP config,
-      MP3 metadata defaults, database backup/restore, health stats, and reset.
+      Two-column layout for booth open/closed status, database health,
+      statistics, revision limit, auto-refresh, SMTP config,
+      MP3 metadata defaults, database backup/restore, and system reset.
     */
     :root{
       --bg:#0b0f19;

templates/player.html

@@ -7,11 +7,11 @@
   <style>
     /*
       Private customer player page.
-      Shows two audio players for Version A and Version B,
-      plus approval buttons or a revision note form.
-      After the customer makes a choice, the controls are hidden
-      and a confirmation/waiting message is shown instead.
-      The number of remaining revisions is shown when available.
+      Shows two audio players for Version A and Version B, plus approval
+      buttons or a revision note form depending on request status.
+      After the customer makes a choice, the controls are hidden and a
+      confirmation/waiting message is shown. The number of remaining
+      customer revisions is displayed when revisions are enabled.
     */
     body{
       font-family:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;

templates/request.html

@@ -7,8 +7,9 @@
   <style>
     /*
       Customer-facing request page.
-      Designed to look fun and inviting on a convention booth tablet or phone.
-      Uses a gradient background, banner image, and a styled card form.
+      Designed for convention booth tablets/phones. Shows the banner image and
+      a styled card form for name, email, hobbies, facts, style, vocal gender,
+      and extra requests. Hidden when the booth is marked closed.
     */
     *{box-sizing:border-box;}
     body{

templates/status.html

@@ -7,7 +7,8 @@
   <style>
     /*
       Public order status lookup page.
-      Customers enter their email to see request status and the private player link.
+      Customers enter their email to see request status, approval choice,
+      and the private player link once two songs have been uploaded.
     */
     *{box-sizing:border-box;}
     body{