Docs: nginx static assets (alias) for AOT deploy dist

[PurHur]

Problem

docs/deploy-web-aot.md (#635) documents phpc deploy layout and CGI for bin/app, but production sites also serve assets/ (CSS) and optionally public/ static files. MiniWebApp relies on /assets/style.css (#594 closed for VM serve; AOT deploy still needs nginx rules).

Contributors are unsure whether static files are served by the native binary, phpc serve, or nginx alias/try_files.

Goal

Extend deployment docs (umbrella #445 or docs/deploy-web-aot.md) with copy-paste nginx snippets:

1. PHPC_DEPLOY_ROOT + alias for assets/ and public/
2. Front controller: only *.php → CGI/FastCGI to bin/app
3. Local smoke: curl CSS from deployed dist before nginx (file exists)

Scope

• Document dist paths after phpc deploy examples/003-MiniWebApp (assets/style.css, templates not web-exposed)
• Illustrative nginx location ^~ /assets/ block (marked not CI-tested)
• Cross-link Testing: ServeAotTest MiniWebApp PATH_INFO + assets (blocked #764 execute) #610 / Testing: ServeAotTest MiniWebApp routes via phpc serve --aot (blocked #764 execute) #478 ServeAotTest asset route vs nginx offload
• Note: AOT binary does not replace a static file server for CSS in v1

Acceptance criteria

• Doc section committed; linked from examples/003-MiniWebApp/README.md deploy section
• Reviewer can deploy 002-StaticWeb or 003-MiniWebApp dist and serve CSS via nginx config without reading source

Verification (local only)

./phpc deploy examples/002-StaticWeb -o /tmp/static-dist
test -f /tmp/static-dist/README.deploy
# Manual: nginx -t with snippet pasted from doc (not automated)

No GitHub Actions.

Dependencies

• AOT: phpc deploy bundles binary, public/, assets/, and phpc.json into dist/ #609 ✅ phpc deploy
• Docs: deploy-web-aot.md quickstart (phpc deploy + PHPC_DEPLOY_ROOT + nginx CGI) #635 ✅ deploy quickstart
• Docs: Production deployment guide (nginx + AOT binary + CGI/FastCGI) #445 umbrella production guide
• AOT: Native user-class object model for phpc build --project #568 MiniWebApp native binary (doc should note VM vs AOT)

Links

• examples/003-MiniWebApp/assets/style.css
• lib/Web/ProjectDeploy.php
• 🗺️ ROADMAP: Compile a small PHP web application (living document) #78 ROADMAP Phase 3 Web AOT