# FoodiPOS - Full AI & Agent Context Documentation

> Comprehensive specification for FoodiPOS Cloud Restaurant & Retail Point of Sale System.

## Architecture
- Frontend: High-performance Progressive Web Application (PWA) with zero-dependency CSS, WebMCP, and SEO-optimized HTML5.
- Backend: Dual-engine runtime with Node.js PM2 cluster microservices on port 3001 and PHP 8.3-FPM.
- Database: Atomic dual-sync JSON storage with distributed tenant isolation.
- Target Sectors: Restaurants, Cafés, Cloud Kitchens, Retail outlets.

## Core Endpoints
- Web Entry: https://foodipos.com/login.html
- Central Admin: https://foodipos.com/admin.html
- API Base: https://foodipos.com/backend/api
- Health Status: https://foodipos.com/backend/api?action=health

## WebMCP Tools
- loginToFoodiPOS: Performs authenticated session initialization given companyCode, username, and password.
- syncDown: Retrieves delta tenant mutations using monotonic timestamps.