docs: align documentation with actual backend-node and backend-python implementations

[Copilot]

• Git hygiene — untrack committed ouroboros.db* and __pycache__/*.pyc files; update .gitignore
• Backend Node.js
  • Create src/utils.js and deduplicate nowIso() (was copied in both comandaService.js and transactionService.js)
  • Fix deprecated url.parse() → new URL() in app.js
  • Remove redundant require('dotenv').config() from config.js (already loaded by app.js)
• Backend Python
  • Create app/utils.py and deduplicate _now_iso() (was copied in both comanda_service.py and transaction_service.py)
  • Fix manual BEGIN/COMMIT/ROLLBACK in process_debit — conflicts with the caller's with conn: context manager
  • Remove unused create_store from store_service.py (REST layer creates stores inline; also removes dead uuid import)
• Frontend
  • Create src/config.js with BACKEND_HTTP / BACKEND_WS constants (Vite env-var–backed) — eliminates 6+ hardcoded localhost:8000 references across pages and hooks
  • Replace alert() in WebSocket hooks with proper wsError state returned to caller
  • Add missing category_updated message handler in useAdminWebSocket
  • Fix stale-closure bug in Analytics.jsx useEffect (data state used but not in dep array — always stale null)
  • Fix missing clearSearch in Terminal.jsx useEffect dep array
  • Move playSound utility out of the hook file into src/utils/sound.js

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
feira-da-troca	Ready	Preview, Comment	Apr 1, 2026 3:05am
feira-da-troca-ba9e	Ready	Preview, Comment	Apr 1, 2026 3:05am