# <img src="/img/mealie-logo.png" width="25px"> Mealie App

## 📖 Co je Mealie

[Mealie](https://recepty.oscloud.cz/g/home/) je moderní open-source aplikace pro správu receptů a plánování jídelníčků.  
Na Oscloudu ji můžeš používat pro svou rodinu i komunitní sdílení receptů.  
Podporuje:

- 🥗 ukládání a kategorizaci receptů  
- 📅 plánování jídelníčků a menu  
- 🛒 automatické generování nákupních seznamů  
- 👥 více uživatelů a sdílení v domácnostech  
- 🌐 import receptů přímo z webových stránek

---

## 🏠 Domácnosti (Households)

Domácnosti fungují jako **pracovní prostory** – každá má vlastní:

- recepty,
- jídelníčky,
- nákupní seznamy.

🔹 Typické příklady:

- „Rodina Novákovi“ – soukromá sbírka receptů  
- „Komunitní Oscloud kuchařka“ – sdílený prostor pro celou komunitu  

➡️ Jeden uživatel může být členem více domácností.

---

---

## 🚀 Jak začít

1. Otevři aplikaci **Mealie** v Oscloudu.  
2. Přihlas se svým Oscloud účtem.  
3. Pokud nechceš, aby tvoje recepty byly **viditelné všem (i neregistrovaným uživatelům)**,  
   vytvoř si **vlastní domácnost/kuchařku** (např. pro rodinu).  
4. Do své domácnosti můžeš přidat další členy – ostatní uživatele Oscloudu.  
5. Pokud ti sdílení nevadí a chceš se zapojit do komunitního projektu, připoj se do **Oscloud Kuchařky**.  

---

## 🔐 Registrace a přístup

- Do Mealie se **nelze registrovat volně**.  
- Přístup je možný jen:
  - na **pozvánku od administrátora**, nebo  
  - přes **Oscloud účet** (SSO přihlášení).  
- Díky tomu je služba chráněná před spamem a falešnými účty.  

---

## 👀 Viditelnost receptů

- Výchozí nastavení Mealie: recepty jsou **veřejně přístupné** i neregistrovaným uživatelům.  
- Pokud chceš mít recepty soukromé, je potřeba je ukládat do **vlastní domácnosti**.  
- **Oscloud Kuchařka** je koncipována jako **veřejná a sdílená** – přidej se do ní, pokud chceš recepty publikovat otevřeně.  

---

## 📌 Doporučené použití na Oscloudu

- **Jedna hlavní domácnost „Oscloud Kuchařka“** → sdílené komunitní recepty  
- **Soukromé domácnosti** → pro rodiny a jednotlivce  
- **Skupiny** → použít jen pro rozdělení práv (admin/přispěvatel/čtenář)  

---

## 📷 Ukázky

<center>
<img src="/img/kucharka_oscloud.png" class="shadow" width="500px">
</center>

---

## ℹ️ Shrnutí

- **Domácnosti** = oddělené prostory pro recepty a jídelníčky  
- **Skupiny** = práva a role v domácnostech  
- **SSO přihlášení** = jednoduchý login přes Oscloud účet  
- **Viditelnost** = recepty jsou veřejné, pokud nejsou v soukromé domácnosti  
- **Registrace** = pouze na pozvání nebo přes Oscloud účet  
- Vhodné jak pro rodinu, tak pro komunitní sdílení na Oscloudu  

## 📎 Odkazy

- 🌐 Web projektu: [https://mealie.io](https://mealie.io)  
- 💻 Zdrojové kódy: [https://github.com/mealie-recipes/mealie](https://github.com/mealie-recipes/mealie)  
- 📖 Dokumentace: [https://docs.mealie.io](https://docs.mealie.io)  
