# Ruby Restaurant AI Backend (Rust) A high-performance Rust service providing recommendations, stock optimization, and trend intelligence for the Ruby Restaurant PHP system. ## Features - Recommendation API for "also bought" and related menu items - Stock optimization suggestions from sales velocity + external trends - Trend discovery via scheduled crawlers and external APIs - Clean HTTP interface for PHP integration (source of truth stays in PHP) ## Quickstart 1. Install Rust with rustup: https://rustup.rs 2. Ensure Git and Docker (optional) are installed 3. Clone this repository 4. Create a new Rust binary: `cargo new ai-backend --bin` (or use workspace) 5. Run dev server (example with Actix): `cargo run` 6. Visit `http://localhost:8080/api/health` (will add later) to verify ## Docs - docs/GETTING_STARTED.md — environment, tooling, first run - docs/CURSOR_GUIDE.md — how to work effectively in Cursor - docs/ARCHITECTURE.md — system design and flows - docs/API.md — API contract and examples - docs/DEVELOPMENT.md — branch, commit, PR, testing, CI - CONTRIBUTING.md — how to contribute - SECURITY.md — security policy and reporting ## Status - Phase 1: Foundation and data access - Database schema: pending from PHP team ## License TBD (add a LICENSE file if open-sourcing) # RubyAI # RubyAI