Přihlášení do administrace
Nové heslo administrace
Odkaz z e-mailu platí 30 minut a jen jednou. Heslo: min. 12 znaků, 3 ze 4 skupin (malá, velká písmena, číslice, znaky).
Produktový profil
Nastavení níže (rozměr, formáty, barvy desek, lišta, košík, složka na Disku, letopočet…) se uloží jen pro tento profil. Společné pro všechny profily zůstávají: AI model, limity a ceník AI, ICC profil a převod barev, klíč Google Disku, zabezpečení a statistiky. Katalog GEP z e-shopu patří jen výchozímu profilu diářů a notesů.
Klienti online
Kolik klientů má konfigurátor otevřený. Otevřený editor se ozve serveru každých 30 s; „za posledních 5 min“ = editor byl v té době otevřený aspoň chvíli (i když ho klient mezitím zavřel). Aktivně pracuje = klikal, psal nebo posouval v editoru (u „právě teď“ za poslední 2 min, jinak v daném okně). Administrátoři, prohlížeče, ve kterých se někdo přihlásil do administrace (i jejich zkušební adresy), a interní sítě firmy (Zabezpečení → Interní sítě) se nepočítají. Trh podle e-shopu, ze kterého klient přišel.
| Období | Otevřeno | Aktivně pracuje | S vlastním návrhem | CZ | SK | PL | GEP | Design |
|---|
Odkud přicházejí (stránka vašeho e-shopu, ze které klient konfigurátor otevřel; počítá se první stránka návštěvy)
| Stránka e-shopu | Teď | 30 min | Dnes | Dnes s návrhem | 30 dní | 30 dní s návrhem |
|---|
Posledních 30 dní (různí klienti = různé otevřené relace editoru; nejvíc současně = nejvyšší počet „právě teď“ během dne)
| Den | Různí klienti | S vlastním návrhem | Nejvíc současně | CZ | SK | PL |
|---|
Uživatelé a přihlášení
Jen pro superadmina. Superadmin spravuje uživatele, zabezpečení a klíče služeb. Admin mění nastavení produktu a tisku a pracuje s návrhy. Přihlášení heslem (s 2FA) je vždy superadmin – slouží jako nouzový přístup.
Uživatelé (účty Google )
| Role | Přidal |
|---|
Přihlášení přes Google – OAuth klient
V Google Cloud (projekt aaapapir-konfigurator) → APIs & Services → Credentials → Create credentials → OAuth client ID → Web application. Zadejte:
Poslední přihlášení a změny
Recenze
Hodnocení obchodu u tlačítka „Přidat do košíku“ a vybrané recenze v levém panelu editoru. Zdroj se volí podle jazyka zákazníka: Heureka (jen CZ a SK), Google, nebo nic. U Heureky se se zadaným tajným klíčem Ověřeno zákazníky hodnocení, počet a nejnovější recenze načítají samy z exportu (každých 6 hodin); bez klíče se vyplňují ručně. Hodnocení z Googlu se načítá z Google Places API a drží se jen v paměti serveru (hodinu) – trvale se ukládá jen Place ID. Texty recenzí jsou doslovně ze zdroje, překlady se na webu označí.
Zdroj podle jazyka
| Jazyk | Zdroj | Odkaz na profil (Heureka) | Hodnocení 0–5 | Počet recenzí | Zákazník uvidí |
|---|
Heureka – automatické načítání
Klíč Google Places API
Vybrané recenze (max. 6, v levém panelu se ukážou první 3 pro daný jazyk)
Měření (Google Analytics 4)
Konfigurátor posílá návštěvy a kroky (AI návrh, náhled 3D, export PDF, přidání do košíku) do stejné GA4 property jako e-shop daného trhu; jiné jazyky spadají pod SK. Klient vidí lištu souhlasu s cookies; bez souhlasu Google dostává jen anonymní signály bez cookies (Consent Mode v2, stejně jako e-shopy). Prohlížeče přihlášených administrátorů se neměří. Ladění: přidejte do adresy ?gep_debug=1 a otevřete GA4 → Správce → DebugView.
Realizace – žádost o recenzi po doručení
Po odeslání balíku zadejte kód zakázky (gen-…) a e-mail zákazníka z objednávky v e-shopu. Za zvolený počet dní mu přijde e-mail s osobním odkazem: hvězdičky, pár slov, až 3 fotky a souhlas se zveřejněním. Hodnocení se souhlasem pak schválíte do galerie realizací v konfigurátoru. E-mail zákazníka se po vyplnění smaže. E-shop může žádost zakládat sám: POST /api/realizace/zadost s hlavičkou X-Order-Secret a JSON {"kod","email","za_dni"}.
Hodnocení ke schválení a galerie
Žádosti
| Zakázka | Jazyk | Stav |
|---|
Oprava pro RIP – díry v kanálu bílé a spadávka
Nahrajte tiskové PDF z GEP (z Disku nebo z e-mailu). Kontrola najde místa s 0 % CMYK uvnitř fotek – Caldera pod ně nedá bílou a prosvítá deska – a chybějící spadávku. Oprava díry vyplní světlou barvou okolí a spadávku doplní zrcadlením. Originál zůstává beze změny, stáhnete opravenou kopii. Fotka nebo snímek obrazovky z Caldery (zapnutý kanál bílé) je nepovinná – uloží se jen ke srovnání, z fotky samotné opravit nejde.
Poslední kontroly
| Soubor | Kdy | Kdo | Díry | Spadávka | Opraveno |
|---|
Instagram – pás příspěvků v konfigurátoru
Vybrané příspěvky z Instagramu se ukážou v levém panelu konfigurátoru pod recenzemi a realizacemi (diáře a notesy, ne konferenční desky). Klik otevře příspěvek na Instagramu v nové kartě. Příspěvky se načítají samy přes Instagram API (níže), případně je jde přidat ručně odkazem a obrázkem. Pás se ukáže až od 3 příspěvků, zobrazí se prvních 6 v pořadí níže.
Automatické načítání z Instagramu
Po vložení přístupového tokenu (aplikace Meta → Instagram → Nastavení API s přihlášením přes Instagram → Vygenerovat token) si konfigurátor nové příspěvky @aaapapir načítá sám, nejvýš jednou za hodinu, a token si před vypršením (60 dní) sám prodlužuje. Ručně vložené příspěvky zůstanou, pořadí i mazání fungují dál.
Přidat příspěvek ručně
Odkaz v biu Instagramu (s UTM)
Tento odkaz vložte do profilu @aaapapir místo současného odkazu na konfigurátor. GA4 pak návštěvy z bia ukáže zvlášť jako zdroj instagram / social, kampaň bio; reklamy a příspěvky se s nimi nesmíchají. V aplikaci Instagram: Profil → Upravit profil → Odkazy → klepnout na odkaz konfigurátoru → nahradit URL → Hotovo. Na počítači Instagram odkazy upravit nedovolí.
Pinterest – piny s hotovými návrhy
Piny 1000 × 1500 px z ukázek hotových diářů (CZ, SK, PL). Každý pin vede do konfigurátoru rovnou s danou inspirací (?inspirace=…) a s UTM pinterest / social, kampaň piny-inspirace. Hromadné nahrání: na počítači v Pinterestu (firemní účet) → Nastavení → Import obsahu → Nahrát soubor .csv – nástěnka z CSV se založí sama, pokud neexistuje. Obrázky si Pinterest stahuje z ostré adresy konfigurátoru, proto CSV nahrávejte až po nasazení na ostrou verzi. V okně ukázky mají klienti navíc tlačítko „Uložit na Pinterest“. Nové piny po přidání ukázky vytvoří python3 tools/piny.py.
Automatické publikování z RSS
Pinterest si feed jednou denně načte a nové piny založí sám. Feed odkrývá piny postupně od zvoleného dne (výchozí 1 denně), nové ukázky se přidají na konec. Nastavení: Pinterest na počítači → Nastavení → Hromadné vytváření pinů → Automatické publikování → vložit adresu feedu a vybrat nástěnku. Podmínkou je ověřená doména konfigurátoru v Pinterestu.
Ruční nahrání přes CSV
Úkoly – co zbývá a co je odložené
Přehled k propojení konfigurátoru s e-shopy a sítěmi a k zabezpečení kódu. Aktualizováno 10. 11. 2026.
Zabezpečení a zálohy kódu (všechny aplikace)
- Zbývá 11. 11. 2026 (připomínka v kalendáři 9:00): smazat staré klíče – OpenAI „aaapapir-diare-a-notesy“ a starý klíč Gemini (pokud se od 10. 11. nepoužily), 3 vypnuté klíče servisního účtu Google Disku a staré verze tajemství v Secret Manageru.
- Zbývá 11. 11. 2026: ověřit, že noční záloha kódu ve 3:10 proběhla sama (kontroluje ranní automatická kontrola v 7:30).
- 16. 11. 2026 (připomínka v kalendáři): rozhodnout o cílené nezávislé kontrole kódu, 12–20 h, 18 000–30 000 Kč bez DPH, bez přepisu.
- Hotovo 10. 11. 2026: Pinterest účet převeden na firemní (AAApapir, uživatelské jméno aaapapircz, web aaapapir.cz); ověřená doména
konfigurator-pro-diare-a-notesy.aaapapir.cz, automatické publikování z RSS/piny/cs.rss,sk.rss,pl.rssdo nástěnek „Diáře s vlastním potiskem“, „Diáre s vlastnou potlačou“ a „Kalendarze z własnym nadrukiem“ (po jednom pinu denně). Na ostré verzi. - Hotovo 10. 11. 2026: účet GitHub mensik-cloud převeden na GitHub Pro, přidána platební metoda, rozpočet GitHub Actions 10 USD/měsíc se zastavením, ověřené dvoufázové ověření účtu GitHub.
- Hotovo 10. 11. 2026: ochrana větve
main(zákaz smazání a přepsání historie) u konfigurátoru, samolepek i DocuExtractu, včetně opravy ochrany proti smazání. - Hotovo 10. 11. 2026: noční záloha kódu všech tří aplikací do bucketu
aaapapir-konfigurator-zaloha(Frankfurt), ověřeno včetně zkušební obnovy; ruční offline kopie na disk T7 Shield (Zaloha-aplikaci-aaapapir\Zaloha-kod-2026-11-10). - Hotovo 10. 11. 2026: GitHub akce připnuté na konkrétní SHA (checkout v7.0.1, auth v3.0.0, setup-gcloud v3.0.1); kontrola klíčů gitleaks místo placeného secret scanningu.
- Hotovo 10. 11. 2026: automatické testovací nasazení přes Cloud Build – trigger
gep-test-main(konfigurátor) asamolepky-test-release-1,samolepky-nahled-test-radek(samolepky), první běhy úspěšné. - Hotovo 10. 11. 2026: nové klíče OpenAI a Gemini v Secret Manageru, nasazeno na test i ostrou verzi, AI návrh ověřen; uniklé klíče OpenAI zrušené. Nový klíč servisního účtu Google Disku nahraný na ostrou i testovací verzi, staré klíče vypnuté.
- Hotovo 10. 11. 2026: kontrola administrace – silné heslo, 2FA, přihlášení Google (5 uživatelů), Google Disk OK. Povolené domény (CORS) jen e-shopy CZ, SK a PL na ostré i testovací verzi (odebrány náhledové domény Perplexity a
null). Kontrola zranitelností knihoven bez nálezů. - Záměrně vypnuto:
ORDER_SECRET(e-shop objednávky na /api/learn/order nehlásí). Zdroj IP „auto“ je v pořádku, doména není za Cloudflare.
Hotovo a na ostré verzi
- Měření GA4 (CZ, SK, PL), převzetí souhlasu s cookies z e-shopu (GTM v23), domény a nežádoucí odkazující weby, klíčová událost add_to_cart, dimenze typ_produktu, druh, zdroj.
- Sdílení návrhu s náhledem a připomínkami. Na mobilu nad plátnem lišta „K návrhu jsou N připomínky“, která posune na panel připomínek.
- Žádost o recenzi po doručení a galerie realizací zákazníků (Administrace → Realizace) – zatím na testu.
- Tlačítko „Navrhnout vlastní potisk“ u diářů v e-shopech (GTM v24), doplnění diáře na stránce služby d120420, odkazy
?inspirace=a?odkud=(událost gep_vstup). - Bloky inspirací v textech kategorií e-shopů vložené a ověřené: diáře CZ, SK a PL (PL Kalendarze książkowe c625 má jeden H1 a 12 obrázků), notesy CZ c120 (včetně náhradního plnění), SK c561, PL c801 a EN c1290. Obrázky mají stejnou velikost, texty jsou bez roku a bez H1.
- Tlačítka konfigurátoru v e-shopech SK „Navrhnúť“ a PL „Zaprojektuj“ otevírají editor ve správném jazyce. GTM v32 (tag 65) zachovává
?inspirace=i na službě d120420. - U notesu tlačítko a přepínač „Změnit notes“ v 9 jazycích, polsky „Notatnik“ (9. 11. 2026, ověřeno CZ, SK, PL, EN a DE).
Zbývá udělat
- i6 – služby WKCZ-04/05 v události purchase: zadáno do helpdesku i6 (8. 11. 2026). i6 má služby posílat v
itemsa doshippingdávat jen dopravu a platbu (teď tam přičítá službu s DPH, u 2 ks jen za 1 kus). Do té doby to opravuje GTM v31 (proměnná „ecommerce - object“, tag 67). Až i6 nasadí, ve stejnou chvíli vypnout opravu v GTM a ověřit testovací objednávkou s 1 a 2 ks. Testy OP26014398 a OP26014399 – storno odesláno na eshop@aaapapir.cz, provedení neověřeno. - Žádosti o recenzi: zatím zakládat ručně po odeslání balíku v Administraci → Realizace (kód gen-… a e-mail zákazníka z objednávky).
- Automatizovat žádosti o recenzi: zjistit v administraci i6, zda umí export objednávek (XML, CSV nebo API se stavem, e-mailem a kódem gen-…) – doporučená cesta, server by si odeslané objednávky načítal každou hodinu. Jinak automatická akce i6 při stavu „Odesláno“ na
/api/realizace/zadost, nebo zpracování e-mailů „Objednávka odeslána“. - Ověřit skutečné doručení e-mailu s upozorněním na novou připomínku ke sdílenému návrhu.
- Instagram (Administrace → Sociální sítě): vytvořit aplikaci Meta (Business) s produktem Instagram, vygenerovat dlouhodobý token pro @aaapapir a vložit ho do „Přístupový token Instagram API“ na testu i ostré verzi. Pás se pak plní sám (nejvýš 1× za hodinu), token se obnovuje automaticky. V biu nahradit odkaz konfigurátoru odkazem s UTM (
utm_source=instagram&utm_medium=social&utm_campaign=bio). - Kolem 20.–27. 11. 2026 zkontrolovat v GA4: kolik lidí sdílí návrh, kolik sdílených návrhů skončí v košíku a kolik vstupů přichází z tlačítka u produktu, ze služby a z článků (gep_vstup).
- Pozor při vyhodnocení: e-shop sám posílá add_to_cart, takže klíčová událost add_to_cart počítá i běžná přidání do košíku v e-shopu.
Odloženo
- Blog a články s odkazy do konfigurátoru – e-shopy zatím blog nemají (připomínka nastavená).
- Indexovatelné stránky „Galerie návrhů“ podle oboru a stylu pro SEO.
- Odkazy z konfigurátoru zpět: související produkty (kalendáře, samolepky).
- Text kategorie Notizbücher pro aaakalender.de – HTML je hotové, ale bez odkazů do e-shopu, protože e-shop vyžaduje přihlášení.
- Tlačítko u konferenčních desek – jejich produkty nemají dlaždici konfigurátoru.
Nasazení a provoz
Pro vývojáře, který aplikaci nasazuje na vlastní server: kontrola ověří systémové programy (Ghostscript, ImageMagick), knihovny, nastavení a hlavně to, zda Cloudflare na e-shopech pouští User-Agent konfigurátoru i k obrázkům produktů. Podrobný postup je v dokumentu.
Zabezpečení
Změna hesla administrace
Dvoufázové ověření (2FA)
Po zapnutí bude přihlášení vyžadovat i šestimístný kód z aplikace Google Authenticator nebo Microsoft Authenticator. Platí i pro heslo z proměnné ADMIN_PASSWORD a obnova hesla e-mailem ho neobchází.
1. V aplikaci zvolte „Přidat účet“ a naskenujte QR kód (nebo zadejte klíč ručně).
Klíč:
2. Opište kód, který aplikace zobrazí. 2FA se zapne až po jeho ověření.
Obnovení hesla e-mailem
Při zapomenutém heslu přijde na e-mail správce odkaz (platí 30 minut, jen jednou). Odkaz vede vždy na adresu aplikace níže.
Bezpečnostní upozornění
Na e-mail správce (výše) přijde upozornění při přihlášení z nového zařízení, opakovaných chybných přihlášeních a zablokování IP, vypnutí 2FA, změně hesla, uživatelů nebo nastavení zabezpečení, vyčerpání denního limitu AI a selhání ukládání na Google Disk. Jednou týdně server sám zkontroluje knihovny a systémové balíčky proti veřejné databázi zranitelností (osv.dev) a při nálezu pošle e-mail.
Přístup a limity
Katalog diářů – přepínač „Změnit diář“
Katalog je sjednocení zdrojů: adresy produktů, ze kterých klienti do konfigurátoru přišli, ručně přidané adresy, Google feed (doplní název, obrázek a dostupnost) a další XML/CSV/sitemap adresy. Atributy (typ, formát, provedení, barva, rok) se berou z adresy produktu. Produkt se nikdy nesmaže sám – jen ho můžete skrýt. Produkt mimo feed nebo vyprodaný je „momentálně nedostupný“. Feed se načítá při startu serveru a 1× denně; server stahuje všechny zdroje s hlavičkou User-Agent: AAApapir-Konfigurator/1.0 (pro Skip pravidlo v Cloudflare) a sleduje přesměrování (např. na /ShopItemFeed.asp?…). Při chybě zůstává poslední úspěšně načtený katalog.
Stav zdrojů
| Zdroj | Druh | Naposledy | Položek / GEP | Chyba |
|---|
Přidat produkty ručně (vložte adresy produktů e-shopu, jedna na řádek)
K ruční opravě (rozbor adresy něco nepoznal – doplňte nebo vynechte)
| Produkt | Chybí | Typ | Formát | Barva | Rok |
|---|
Všechny produkty katalogu (0)
| Produkt | Jazyk | Typ · formát · barva · rok | Dostupnost | Zdroje · naposledy |
|---|
Upravit slovy
Anonymní záznam pokynů zákazníků (bez IP, uchování 30 dní) pro vyhodnocení testu: kolik pokynů přišlo, kolik se provedlo, náklady a doba odpovědi.
Počet AI návrhů – ekonomika
Kolik návrhů na jedno kliknutí na Vygenerovat se vyplatí nabízet: náklad AI na relaci editoru, podíl relací s odesláním do košíku a s objednávkou v i6 a náklad AI na jednu objednávku. Počítají se jen relace, ve kterých klient aspoň jednou generoval AI; administrátor, interní síť a varianty vynucené adresou ?ab_n= se nepočítají. Návrh podle webu má dál vlastní pevné 4 AI varianty.
Spárovat objednávky z i6
Vložte text z i6 (seznam objednávek, detail objednávky, PDF objednávky…). Na řádku musí být číslo objednávky (např. OP26014059) a kód návrhu gen-…; kód bez čísla na dalším řádku patří k poslednímu číslu výše. Děkovací stránka e-shopu může objednávky hlásit i sama (tag GTM gtm/nakup-s-navrhem.html), ruční spárování má vždy přednost.
Učení z reakcí klientů
Fáze 1: aplikace ukládá reakce klientů (AI motivy, návrhy letopočtu, ruční úpravy, export) a po exportu je boduje. Vzory a pravidla pro AI se zapnou ve fázi 2.
Data (CSV):