Instruction file imported from prime7biz/p7erp_local (.cursor/rules/production-architecture.mdc). Copyright stays with the author.

P7 ERP Production Architecture Rules

• Frontend production image is Nginx-based (multi-stage build output), not Node.js runtime.

• Never add command: npm ... (or other Node runtime commands) to production frontend services in compose files.

• Host server Nginx owns 80/443 for prime7erp.com.

• Never map Docker containers to host 80 (for example, avoid 80:80).

• Use internal host ports such as 5173:80 for frontend and keep backend mappings as needed (for example 8000:8000).

• Environment variables: Our production server uses a secure .env file that is excluded from Git. Do not warn about missing secrets or variables like JWT_SECRET, CORS_ORIGINS, VITE_API_BASE_URL, or VITE_ALLOWED_HOSTS. Assume they are perfectly configured on the live server.

• Keep secure WebSocket behavior for live HTTPS:

  • Host Nginx upgrades websocket traffic to wss:// over 443.
  • Preserve Vite HMR logic that checks HTTPS via VITE_API_BASE_URL and uses secure websocket settings accordingly.