Add comprehensive comments to all source files and expand documentation

requirements.txt

@@ -1,3 +1,13 @@
+# requirements.txt
+# ================
+#
+# Python dependencies for the Theme Song Booth Flask app.
+#
+# flask        - web framework
+# gunicorn     - production WSGI server used by Dockerfile
+# python-dotenv - loads .env files in development
+# werkzeug     - utilities for file uploads and password hashing
+
 flask
 gunicorn
 python-dotenv