EKO3-10: vývojářský portál
php scripts/portal/build.php vytvoří statický portál do složky portal/. Cílová adresa je developers.onhost.cz.
Portál obsahuje:
- přehled API ze specifikací v
openapi/sdk/, se všemi operacemi a názvem třídy SDK; - průvodce z
docs/ecosystem/; - seznam JSON Schémat;
- changelog kontraktů (
CHANGELOG.md).
Portál nepoužívá JavaScript ani externí soubory a má světlý i tmavý režim. Výstup je deterministický. Parametr --check
ověří, že portal/ odpovídá zdrojům. Při každé změně kontraktu proto stačí znovu spustit build a doplnit řádek do CHANGELOG.md.
Zveřejnění vyžaduje Adrianovo „ano“, protože jde o DNS a server. Navrhujeme statický hosting na stejném serveru (aaPanel)
nebo stránky (Pages) ve Forgejo (ONGIT3-7).