HarenaFiantso/Fikaliako

🍲 Fikaliako (Malagasy: "what I'm going to eat") answers the daily question of millions of Malagasy people — « Aiza no hisakafo androany ? » (where do I eat today?) — by position, budget, and craving. # 🍲 Fikaliako — Geolocated Food Discovery for Madagascar **Fikaliako** (Malagasy: _"what I'm going to eat"_) answers the daily question of millions of Malagasy people — _« Aiza no hisakafo androany ? »_ (where do I eat today?) — by position, budget, and craving. It is an interactive map of **all** the food offering in Madagascar, where gargottes and street vendors are first-class citizens alongside restaurants: real prices in ariary, real opening hours, mobile-money payment info, and community-verified data. > [!NOTE] > The functional and technical reference for this project is the **project book** — _Fikaliako, Livre de Projet v1.0_ (July 2026), kept outside the repo. Every v1 development decision must be justifiable by a section of it; code comments cite it as "project book ch. N". This README covers day-to-day development of the monorepo. --- ## Table of Contents - 🍲 Fikaliako — Geolocated Food Discovery for Madagascar - Table of Contents - Overview - Features - Tech Stack - Architecture - Project Structure - Prerequisites - Getting Started - 1. Clone the repository - 2. Install dependencies - 3. Start the stack - Environment Variables - Available Scripts - Backend (Spring Boot API) - Local services (Docker Compose) - Database \& migrations - API contract (OpenAPI) - Security model - Testing - Roadmap - Coding Conventions - Troubleshooting - License --- ## Overview Finding where to eat in Madagascar is surprisingly hard — not because the offer is lacking, but because the **information** is: Facebook has no distance/budget/hours filters, Google Maps ignores most gargottes, prices are rarely displayed, and opening hours are folklore. Fikaliako attacks the information problem with a map dedicated exclusively to food, enriched and kept alive by its community. **Highlights (target product, book ch. 4):** - Full-screen interactive map (OpenStreetMap + MapLibre, client-side clustering, open/closed status in real time) - Four combinable search modes: …