Features: 1) Expand .gitignore to include comprehensive rules for Python, Node, Docker, IDEs, test artifacts, and distribution files;

Fixes: None;

Extra: 1) Add comments and structure to `.gitignore` for improved readability and maintainability; 2) Update placeholder comments in `docker-compose.yml` for future services.

.gitignore

@@ -1,89 +1,159 @@
-*.log
+# ──────────────────────────────────────────────────────────────────────────
-*.pot
+# Python bytecode, caches, and compiled artifacts
-*.pyc
+# ──────────────────────────────────────────────────────────────────────────
-__pycache__/
+# Byte-compiled / optimized / DLL files
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-.idea
-.env
 *.py[cod]
 *$py.class
 *.so
-.Python
+
-build/
+# Cache directories
-develop-eggs/
+__pycache__/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-*.manifest
-*.spec
-pip-log.txt
-pip-delete-this-directory.txt
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
 .pytest_cache/
-cover/
+.hypothesis/
-instance/
+.pyre/
-.webassets-cache
+.pytype/
-.scrapy
-docs/_build/
-.pybuilder/
-target/
-.ipynb_checkpoints
-profile_default/
-ipython_config.py
-.pdm.toml
-__pypackages__/
-celerybeat-schedule
-celerybeat.pid
-*.sage.py
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-.spyderproject
-.spyproject
-.ropeproject
-/site
 .mypy_cache/
 .dmypy.json
 dmypy.json
-.pyre/
-.pytype/
 cython_debug/
-db_backups
+
-services_data
+# Python environments
-services_data/postgres/*
+.Python
-services_data/redis/*
+env/
-static
+env.bak/
-!core/static
+venv/
-!payments/static
+venv.bak/
-!vibes_auth/static
+ENV/
-media
+.venv/
+__pypackages__/
+
+# Local Django settings and database
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Django backups and metadata
+instance/
+db_backups/
+
+# ──────────────────────────────────────────────────────────────────────────
+# Logs and reports
+# ──────────────────────────────────────────────────────────────────────────
+logs/
+*.log
 debug.log
 errors.log
-test.json
+test.json
+coverage.xml
+coverage.*
+*.cover
+*.py,cover
+nosetests.xml
+
+# Coverage / test reports
+htmlcov/
+.coverage
+.coverage.*
+
+# CI / tox / nox
+.tox/
+.nox/
+.scrapy
+.coverage.*
+.cover
+.pybuilder/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# ──────────────────────────────────────────────────────────────────────────
+# Packaging and distribution
+# ──────────────────────────────────────────────────────────────────────────
+build/
+dist/
+dist-ssr/
+*.egg
+*.egg-info/
+.installed.cfg
+MANIFEST
+*.manifest
+*.spec
+sdist/
+wheels/
+share/python-wheels/
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Node build artifacts
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+site/
+
+# ──────────────────────────────────────────────────────────────────────────
+# Static, media, and uploads
+# ──────────────────────────────────────────────────────────────────────────
+static/
+media/
+
+# Allow checked-in static from apps
+!core/static/
+!payments/static/
+!vibes_auth/static/
+!blog/static/
+
+# Webassets
+.webassets-cache/
+
+# ──────────────────────────────────────────────────────────────────────────
+# Docker & service data
+# ──────────────────────────────────────────────────────────────────────────
+# Local volume mounts
+services_data/
+services_data/postgres/
+services_data/redis/
+
+# ──────────────────────────────────────────────────────────────────────────
+# Node dependencies
+# ──────────────────────────────────────────────────────────────────────────
+node_modules/
+
+# ──────────────────────────────────────────────────────────────────────────
+# Cypress test artifacts
+# ──────────────────────────────────────────────────────────────────────────
+cypress/videos/
+cypress/screenshots/
+
+# ──────────────────────────────────────────────────────────────────────────
+# IDEs and editors
+# ──────────────────────────────────────────────────────────────────────────
+# VSCode
+.vscode/
+!.vscode/extensions.json
+
+# JetBrains
+.idea/
+
+# Microsoft
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Spyder / Rope
+.spyderproject
+.spyproject
+.ropeproject
+
+# macOS
+.DS_Store
+
+# TypeScript
+*.tsbuildinfo
+
+# Environment file
+.env

docker-compose.yml

@@ -117,9 +117,18 @@ services:
       - .env
     logging: *default-logging
 
-#  storefront:
+#  nginx:  # TODO complete the service after storefront is present
+#    container_name: nginx
+#    image: nginx
+#    restart: always
+#    ports:
+#      - "80:80"
+#    logging: *default-logging
+
+#  storefront:  # TODO complete the service for future "storefront" Vite-Vue3 base storefront app
 #    container_name: storefront
 #    build: Dockerfile.storefront
+#    logging: *default-logging
 
 volumes:
   es-data: