> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Databáze

> Jak ukládat data a stavět funkce jako formuláře a dashboardy

Databáze je místo, kde si váš projekt ukládá informace.

Kdykoliv váš web nebo aplikace potřebuje něco zapamatovat, použije databázi. Může to být:

* Zpráva, kterou někdo odešle přes formulář
* E-mailová adresa z přihlášení k newsletteru
* Blogový článek, který publikujete
* Žádost o rezervaci nebo registraci
* Uživatelský účet nebo profil

Místo toho, aby informace zmizely po obnovení stránky, databáze je uloží, abyste je mohli zobrazit, použít a reagovat na ně později.

Databázi si představte jako tabulku, která žije za vaším webem:

* Každý **řádek** je jedna položka (například jeden odběratel nebo jedno odeslání formuláře)
* Každý **sloupec** je jedna informace (jako e-mail, jméno nebo datum)

Macaly používá databáze pro vše, co zahrnuje data, seznamy, formuláře nebo dynamický obsah.

## **Databáze, vestavěná od začátku**

Každý Macaly projekt přichází s databází rovnou z krabice.

Nemusíte nastavovat Supabase, vytvářet přihlašovací údaje ani připojovat žádnou externí databázi. Databáze je tam a připravená k použití.

Macaly databáze je poháněná **Convexem**, což znamená:

* Real-time aktualizace ve výchozím nastavení
* Automatické škálování
* Přehledné admin rozhraní podobné Airtable nebo Notion

Data si můžete prohlížet, filtrovat a spravovat přímo v Macaly.

## **Běžné způsoby použití databáze**

Databáze jsou flexibilní a podporují mnoho různých workflow. Níže jsou časté případy použití spolu s příklady promptů, které můžete použít pro jejich nastavení.

### **Kontaktní formuláře a leady**

Velmi častý případ je ukládání odeslaných kontaktních formulářů.

Typické příklady:

* Kontaktní formuláře
* Lead capture stránky
* Formuláře pro zpětnou vazbu nebo dotazy

Každé odeslání se uloží jako nový záznam v databázi, takže se nic neztratí.

**Příklad promptu**

> Přidej databázi "Leads" pro ukládání odeslaných kontaktních formulářů s poli Name, Email, Phone a Message. Propoj kontaktní formulář tak, aby se každé nové odeslání automaticky uložilo do databáze.

### **Newsletter a odběry**

Databáze se často používají pro ukládání odběratelů newsletteru nebo čekacích listin.

To vám umožňuje:

* Sbírat e-mailové adresy
* Sledovat, kdy se někdo přihlásil k odběru
* Později seznam exportovat, pokud je potřeba

**Příklad promptu**

> Vytvoř databázi "Subscribers" pro ukládání přihlášení k newsletteru s poli Email a Subscription Date. Propoj e-mailový input na stránce tak, aby se každé přihlášení automaticky uložilo.

<img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DATABASES2.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=1f0a39a8ba4988c7383fc9de3432d344" alt="New DATABASES2" width="2168" height="1410" data-path="images/new-DATABASES2.png" />

### **Správa obsahu (CMS)**

Databáze mohou fungovat jako systém pro správu obsahu pro dynamický content.

Běžné příklady:

* Blogové články
* Případové studie
* Recenze
* FAQ
* Adresáře a výpisy

<img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DATABASES1.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=4595966e6bdce758caf3f7644e2f0a15" alt="New DATABASES1" width="2168" height="1410" data-path="images/new-DATABASES1.png" />

Místo editace obsahu přímo na stránce ho spravujete jako strukturovaná data.

**Příklad promptu**

> Vytvoř databázi "Posts" s poli Title, Description, Content, Image a Publish Date. Použij ji pro vykreslení seznamu blogových článků na webu.

### **Rezervační systémy a žádosti**

Databáze mohou ukládat rezervace nebo žádosti.

Typické příklady:

* Žádosti o schůzku
* Demo rezervace
* Registrace na akce

Každá žádost se uloží, abyste ji mohli zkontrolovat nebo na ni navázat.

**Příklad promptu**

> Přidej databázi "Bookings" pro ukládání žádostí o schůzku s poli Name, Email, Date a Message. Propoj ji s rezervačním formulářem na webu.

### **Admin dashboardy a interní nástroje**

Databáze se často párují s interními stránkami pro vytváření jednoduchých admin nástrojů.

Ty se hodí pro:

* Kontrolu odeslaných formulářů
* Správu odběratelů
* Moderování obsahu
* Řízení interních workflow

Přístup lze omezit pomocí autentizace.

**Příklad promptu**

> Vytvoř admin dashboard na /admin s autentizací e-mailem a heslem. Zobraz tabulku všech odběratelů newsletteru s e-mailem a datem přihlášení a umožni export seznamu jako CSV.

### **Notifikace a automatické e-maily**

Databáze mohou spouštět akce při vytvoření nových dat.

Běžné příklady:

* Notifikace týmu při odeslání formuláře
* Potvrzovací e-maily uživatelům

**Příklad promptu**

> Když přijde nové odeslání formuláře, pošli e-mailovou notifikaci na [my@email.com](mailto:my@email.com) s odeslanými údaji.

**Příklad promptu**

> Po odeslání formuláře pošli uživateli potvrzovací e-mail s poděkováním a potvrzením přijetí.

## **Jak přemýšlet o databázích v Macaly**

Pokud váš projekt potřebuje:

* Ukládat informace
* Zobrazovat seznamy položek
* Pohánět formuláře nebo obsah
* Sledovat uživatele nebo odeslání

Pravděpodobně budete potřebovat databázi.

Macaly je navržené tak, abyste nemuseli rozumět teorii databází. Popíšete, co chcete ukládat a jak se to má chovat, a Macaly se postará o strukturu a propojení.

## **Testovací databáze**

Standardně vaše Macaly aplikace používá jednu **Live databázi** sdílenou mezi publikovaným webem a prostředím chatu/náhledu. To znamená, že změny provedené v chatu nebo náhledu se okamžitě projeví na živém webu.

<img src="https://mintcdn.com/macaly-41b1d3e9/1GaImn0GlCpapSwi/images/Testingdatabase.png?fit=max&auto=format&n=1GaImn0GlCpapSwi&q=85&s=377cfd6ff9ab295e8e3cf37d96fd3542" alt="Testingdatabase" width="2168" height="1356" data-path="images/Testingdatabase.png" />

Testovací databáze vám umožňuje pracovat v bezpečném, izolovaném prostředí bez rizika pro produkční data.

### **Jak to funguje**

1. **Vytvořte testovací databázi** — Zkopíruje všechna data z Live databáze do oddělené instance
2. **Provádějte změny bezpečně** — Pracujte v chatu a náhledu bez ovlivnění publikovaného webu
3. **Důkladně otestujte** — Ověřte, že vše funguje podle očekávání
4. **Přepněte zpět na Live** — Změny schématu a funkcí se aplikují automaticky
5. **Publikujte** — Nasaďte aktualizace uživatelům

### **Nastavení testovací databáze**

1. Otevřete záložku **Database** v chatu
2. Klikněte na **"Add testing mode"**
3. Počkejte na dokončení nastavení

Po vytvoření můžete přepínat mezi **Live** a **Testing** prostředím pomocí tlačítek v záložce Database. Náhled se aktualizuje a zobrazí data z právě vybrané databáze.

<Note>
  Publikovat můžete pouze při použití Live databáze. Pokud se pokusíte publikovat s Testing databází, budete vyzváni k přepnutí na Live.
</Note>

## **Často kladené otázky**

<AccordionGroup>
  <Accordion title="Jakou databázi Macaly používá?">
    Projekty Macaly používají jako backendovou databázi Convex. Data si můžete prohlížet a spravovat přes záložku **Databáze** v editoru Macaly.
  </Accordion>

  <Accordion title="Mohu migrovat databázi projektu na vlastní účet Convex?">
    Ano. [Kontaktujte podporu](mailto:support@macaly.com) a požádejte o snapshot databáze vašeho projektu (uveďte odkaz na projekt). Obdržíte odkaz ke stažení ZIP souboru. Vytvořte si vlastní účet Convex, importujte snapshot podle průvodce na docs.convex.dev, poté aktualizujte tajné klíče Convex v nastavení vašeho projektu Macaly. Během přechodu může dojít ke krátkému výpadku.
  </Accordion>

  <Accordion title="Mohu po přechodu na vlastní databázi Convex stále používat Macaly?">
    Ano. Po migraci na vlastní databázi Convex můžete dále používat Macaly, jak jste zvyklí. Záložka **Databáze** v Macaly přestane fungovat, ale všechny ostatní funkce budou dostupné normálně.
  </Accordion>
</AccordionGroup>
