PANOPRO Social Agent — Technická dokumentace

Produkční URL: Postiz https://postiz.187.124.131.231.sslip.io · Dokumentace https://docs.187.124.131.231.sslip.io Repozitář: panopro-social-agent (lokální; příprava GitHub) Hosting: Hostinger VPS — Ubuntu 24.04, 2 vCPU / 8 GB, Docker + Caddy (HTTPS přes Let's Encrypt / sslip.io)

AI agent pro tvorbu, plánování, schvalování, publikaci a měření obsahu na sociálních sítích Panopro (Facebook, Instagram, LinkedIn, WordPress, YouTube, Google My Business).

Dnes reálně běží: self-hostovaný Postiz (kalendář, schválení, publikace, analytika) nad přenosným jádrem — brand-voice.md a prompts.md, ze kterých se čerpá tón a obsah bez ohledu na to, co obsah publikuje.

Připraveno jako rozšíření, zatím NENASAZENO: jediná chybějící automatizace je generování — n8n + Claude by na základě tématu vytvořil draft rovnou v Postizu. Schválení, plánování, publikaci i analytiku už Postiz umí sám nativně ve svém UI — není potřeba nic dalšího (žádný Telegram, žádná databáze navíc).

1 · Pokrytí zadání

Porovnání 1:1 se zadáním. Legenda: ✅ hotové a otestované · ◐ připravené, čeká na zapojení účtu/klíče · ○ fáze 2.

1.1 Tvorba obsahu

1.2 Grafika a videa

1.3 Publikace

1.4 Monitoring

1.5 Analytika

1.6 Rozšíření: AI Community Manager

2 · Architektura

2.1 Aktuální provoz (demo)

   ty ───▶  Postiz (kalendář, schválení, publikace, analytika)
                        │
                        ▼
        Facebook · Instagram · LinkedIn · WordPress · YouTube · Google My Business

   Postiz = Next.js frontend + NestJS backend + Temporal (workflow engine)
          + PostgreSQL + Redis + Elasticsearch.
   Vše v Dockeru za Caddy (automatické HTTPS, sslip.io).  Hostinger VPS / Ubuntu 24.04.

2.2 Automatické generování (rozšíření, připraveno k nasazení)

   ty zadáš téma ───▶  n8n (cron) ───▶ Claude API (text + self-critique)
                                            │
                                            ▼
                              draft rovnou v Postizu (přes jeho API)
                                            │
                                            ▼
           tvorbu dál celou řeší Postiz sám: schválení → plán → publikace → metriky

Jediné, co rozšíření dodává, je krok „vymysli a napiš draft" — zbytek životního cyklu (schválení, čas publikace, samotná publikace, měření) už dnes zajišťuje Postiz.

3 · Strom souborů

★ = nejčastěji upravované.

panopro-social-agent/
├─ brand-voice.md        ★ „Brain AI" Panopra — tón, segmenty, CTA, vzorové posty
├─ prompts.md            ★ prompty pro Claude (text, self-critique, hashtagy, odpovědi)
├─ state-model.md          model stavů příspěvku
├─ README.md               přehled projektu
├─ docs/
│  ├─ DOCS.md            ★ tento dokument (jediný zdroj)
│  ├─ build-docs.mjs       generátor HTML (marked)
│  └─ DOCS.html            vygenerovaná dokumentace (PANOPRO branding)
├─ deploy/
│  ├─ docker-compose.yml   rozšíření: jen n8n (Postiz už běží na serveru zvlášť)
│  ├─ Caddyfile            doplněk pro n8n subdoménu (vlož do Caddyfile na serveru)
│  ├─ .env.example         konfigurace pro rozšíření n8n
│  ├─ PROPOJENI-SITI.md  ★ klikací návod: WordPress, LinkedIn, Meta, Google
│  ├─ seed-posts.json      6 hotových LinkedIn postů (startovní data)
│  ├─ n8n-generator-workflow.json   (rozšíření: generování draftu, zatím nenasazeno)
│  └─ SETUP.md             co zbývá udělat (propojení sítí, volitelně n8n)
└─ zdroje_text/            extrahované podklady (strategie, kampaň)

Na serveru běží produkční Postiz z oficiálního repozitáře gitroomhq/postiz-docker-compose v /opt/postiz-official (vyžaduje Temporal — workflow engine). Soubory v deploy/ už s ním neduplikují Postiz, jen ho volitelně doplňují o n8n.

4 · Komponenty — jak funguje / jak upravit

Živé komponenty (aktuální provoz)

4.1 Postiz (publikace, kalendář, schválení, analytika) Produkčně běží v /opt/postiz-official (oficiální sestava gitroomhq/postiz-docker-compose s Temporal enginem — bez něj backend nenaběhne). Jak upravit: přidat síť = vytvořit vývojářskou appku u poskytovatele (návod v deploy/PROPOJENI-SITI.md), doplnit Client ID/Secret do /opt/postiz-official/.env, docker compose up -d.

4.2 Caddy (HTTPS) Automatické certifikáty pro postiz.* a docs.* subdomény. Jak upravit: změna domény = přepsat DOMAIN v .env a restart (docker compose up -d).

4.3 Jádro (přenosné — používá se dnes i v rozšíření)

• brand-voice.md — tón, segmenty, CTA; zdroj pravdy pro ruční i budoucí automatizovanou tvorbu obsahu.
• prompts.md — texty promptů pro Claude (generování, self-critique, hashtagy, odpovědi) — připraveno pro rozšíření.
• state-model.md — navržený model stavů příspěvku (DRAFT→…→PUBLISHED) pro rozšíření; v aktuálním provozu tuto roli plní stavy přímo v Postizu.

Rozšíření (připraveno, zatím nenasazeno)

4.4 n8n (generování draftu) Jeden workflow (viz sekce 6) — generuje a zapisuje draft přímo do Postizu přes jeho API, žádná databáze navíc. Jak nasadit: Import from File → mapuj credentials → uprav uzel.

5 · Konfigurace

6 · Workflow (rozšíření — generování draftu)

Zatím nenasazeno na serveru; jeden soubor připravený k importu do n8n, jakmile bude potřeba objem generování nad rámec ruční tvorby v Postizu.

Schválení, plán, publikaci i metriky pak řešíš přímo v Postiz UI — stejně jako u ručně vloženého obsahu.

6 hotových LinkedIn postů (deploy/seed-posts.json) je připraveno jako startovní obsah nezávisle na tomto rozšíření.

7 · Provoz a server

• Umístění produkčního Postizu: /opt/postiz-official (oficiální sestava gitroomhq/postiz-docker-compose + Temporal engine + Caddy).
• Nasazení: cd /opt/postiz-official && docker compose up -d
• Stav: docker compose ps · Logy: docker compose logs -f postiz (příp. docker exec postiz pm2 logs backend)
• Restart backendu: docker restart postiz (celý kontejner — spolehlivější než dílčí pm2 restart, který může kolidovat na portu)
• Aktualizace: docker compose pull && docker compose up -d
• Zabezpečení: SSH jen klíčem (heslo vypnuto), Caddy HTTPS, 4 GB swap.
• Zálohy: snapshot VPS + dump Postgresu (doporučeno denně).

8 · Napojení sítí a klíčů (jednorázově)

Krok za krokem, s přesnými redirect URL pro naši doménu: deploy/PROPOJENI-SITI.md.

1. WordPress — bez appky, jen Application Password ve wp-admin (~2 min).
2. LinkedIn — vlastní appka na linkedin.com/developers (~15 min).
3. Meta — jedna appka pro Facebook + Instagram (~20 min).
4. Google — jeden projekt pro YouTube + Google My Business (~20 min).
5. (Rozšíření) Anthropic — klíč pro automatické generování draftů, zadává se do n8n Credentials (šifrováno), ne do zdrojových souborů.

Přihlašovací údaje ze sítí (Client ID/Secret) se zapisují do /opt/postiz-official/.env.

9 · Lokální vývoj a regenerace dokumentace

Jeden zdroj pravdy = docs/DOCS.md. HTML se generuje z něj:

cd docs && npm install && npm run docs:html

Vznikne docs/DOCS.html s brandingem PANOPRO (knihovna marked).

10 · Nasazení dokumentace

• Primárně: Azure Static Web Apps.
• Záloha: GitHub Pages.
• Z veřejných verzí odstranit osobní e-maily (sanitizace); ostrá data nikdy veřejně bez přihlášení.