diff --git a/backend/workflows/templates/workflows/developer_handbook.html b/backend/workflows/templates/workflows/developer_handbook.html index 1668ffe..f4b64ef 100644 --- a/backend/workflows/templates/workflows/developer_handbook.html +++ b/backend/workflows/templates/workflows/developer_handbook.html @@ -18,7 +18,7 @@ Project Wiki -
Engineering runbook for development, deployment, maintenance, and extension of the current company portal deployment.
+Engineering guide for development, deployment, maintenance, and extension of the current portal deployment.
This handbook is for developers and maintainers. It documents the actual engineering workflow of the standalone product repository.
+This handbook is for developers and maintainers. It documents the engineering workflow of the standalone product repository.
workdock-platform (current local path; legacy compose project name may still be retained for runtime continuity)workdock-platformCONTRIBUTING.mdbase_shell.html and keep header/frame logic out of page-local templates.submitted → processing → completed/failed.submitted, and enqueue the appropriate Celery task again.APP_BASE_URL is also appended to trusted CSRF origins automatically.APP_DOMAIN and APP_BASE_URL as the primary deployment-facing values instead of repeatedly editing long host/origin strings.DJANGO_ALLOWED_HOSTS and, if needed, in DJANGO_CSRF_TRUSTED_ORIGINS./admin-tools/deployment-hosts/./admin-tools/deployment-hosts/.Invalid HTTP_HOST header failure happens before normal page routing, so a broken hostname cannot render a custom error page on that same broken host. Use a working host or IP to access the runbook and fix the env file.develop.main.192.168.2.55rootDJANGO_DEBUG=1 in .env.test because the security checks correctly reject insecure cookie settings when DEBUG=0 and the deployment is still plain HTTP behind a local test topology. This is acceptable for the test box only. Production must run with HTTPS and DEBUG=0.
+ The LAN test deployment intentionally uses DJANGO_DEBUG=1 in .env.test because the security checks correctly reject insecure cookie settings when DEBUG=0 and the deployment is still plain HTTP behind a local test topology. This is acceptable for the test box only. Production must run with HTTPS and DEBUG=0.
/healthz/ becomes healthyThe preferred current test-deployment path is the local helper script from a Mac or another LAN-connected workstation:
+The preferred test-deployment path is the local helper script from a Mac or another LAN-connected workstation:
./scripts/deploy_test_from_mac.sh
This script fast-forwards develop, checks that the remote env file exists, syncs the repo to the server with rsync, runs the remote deployment, verifies the health endpoint, and prints the deployed commit hash.
The script explicitly preserves server-local env files such as .env.test and .env.prod so deployment does not wipe machine-specific secrets.
{% trans "Single documentation entry point for both operational knowledge and long-term engineering knowledge." %}
+{% trans "Operational and engineering documentation in one place." %}
{% trans "Engineering runbook for architecture, branch workflow, deployment, CI/CD, code guidelines, and long-term maintenance." %}
+{% trans "Engineering guide for architecture, branch workflow, deployment, CI/CD, code guidelines, and maintenance." %}
{% trans "Step-by-step release runbook for rebuilds, migrations, translations, static assets, smoke checks, and rollout verification." %}
+{% trans "Step-by-step release guide for rebuilds, migrations, translations, static assets, smoke checks, and rollout verification." %}