scheduled commits + devs info

app/routes/developers.py

@@ -4,6 +4,7 @@ from fastapi import APIRouter, Depends
 from fastapi.responses import HTMLResponse
 
 from ..auth import require_user
+from ..config import DEFAULT_GITEA_ORG, get_gitea_public_url, read_env_value
 from ..templates.layout import page
 
 router = APIRouter()
@@ -86,6 +87,11 @@ def developers_page(user=Depends(require_user)):
         </tr>
         """
 
+    gitea_url = get_gitea_public_url()
+    gitea_org = read_env_value("GITEA_ORG", DEFAULT_GITEA_ORG)
+    clone_base = gitea_url or "<gitea-url>"
+    clone_cmd = html.escape(f"git clone {clone_base}/{gitea_org}/<app-id>.git", quote=True)
+
     return page(
         "Pro vývojáře",
         f"""
@@ -97,6 +103,42 @@ def developers_page(user=Depends(require_user)):
             </p>
         </div>
 
+        <div class="card">
+            <h2><i class="fa-solid fa-cloud-arrow-up" aria-hidden="true"></i> Jak publikovat</h2>
+            <p class="muted">Postup od založení nové služby po nasazení změn.</p>
+            <ol class="publish-steps">
+                <li>
+                    <strong>Vytvořte novou službu.</strong>
+                    Otevřete <a href="/portal/new-app" target="_blank" rel="noopener">formulář Nová služba</a>;
+                    vznikne Gitea repozitář, workspace a první nasazení.
+                </li>
+                <li>
+                    <strong>Naklonujte repozitář.</strong>
+                    <div class="cmd-row">
+                        <input readonly value="{clone_cmd}" id="publish-clone">
+                        <button type="button" onclick="return copyText(this)">Kopírovat</button>
+                    </div>
+                    <span class="muted">Přesný příkaz pro konkrétní službu (HTTP i SSH) najdete také na stránce
+                    <a href="/portal/apps">Služby</a>.</span>
+                </li>
+                <li>
+                    <strong>Upravte kód.</strong>
+                    Buď se řiďte souborem <code>AGENTS.md</code> v kořenové složce projektu, nebo úpravy
+                    nechte provést AI (agent si <code>AGENTS.md</code> přečte sám).
+                </li>
+                <li>
+                    <strong>Commit a push.</strong>
+                    Zacommitujte a pushněte změny — build a nasazení se spustí automaticky
+                    (worker je vždy spuštěný a změnu rovnou zpracuje).
+                </li>
+                <li>
+                    <strong>Zkontrolujte výsledek.</strong>
+                    Stav nasazení a běh služby ověříte na stránce
+                    <a href="/portal/apps">Služby</a> (stav, health, dokumentace).
+                </li>
+            </ol>
+        </div>
+
         <div class="card">
             <h2><i class="fa-solid fa-diagram-project" aria-hidden="true"></i> Sekce portálu (agendy)</h2>
             <table>