Imported from Haldyoso/EdivectWebsite (
AGENTS.md). Install upstream withnpx skills add Haldyoso/EdivectWebsite. Copyright stays with the author.
Edivect Website – pracovné pravidlá
Efektívna aktualizácia verejného EXE
Tieto pravidlá platia, keď používateľ dodá hotový verzovaný súbor
Edivect-v0.9.9.x.exe a požiada o jeho aktualizáciu na webstránke.
- Pred začiatkom načítaj aktuálne 5-hodinové a týždenné využitie Codexu, aby sa dala po dokončení vypočítať spotreba operácie.
- Over, že dodaný EXE existuje. Zisti jeho presnú veľkosť a SHA-256. Aplikáciu nespúšťaj, neovládaj cez PC a nevytváraj vizuálne náhľady.
- Skontroluj stav repozitára a zachovaj všetky nesúvisiace lokálne zmeny.
- Nahraď predchádzajúci EXE v
public/downloads/, aktualizuj názov súboru, verziu, veľkosť a SHA-256 vlib/site.tsa verziu vREADME.md. - Pri čistej výmene release súboru spusti lokálne iba
npm run verify:release. Nespúšťaj lokálne lint, typecheck, produkčný build, kontrolu odkazov ani Playwright testy, pretože ich po pushnutí vykonáva workflow GitHub Actions. - Širšie lokálne kontroly spusti iba vtedy, keď sa menil aj zdrojový kód alebo
konfigurácia webu, keď
verify:releasezlyhá, alebo keď zlyhá CI. - Commitni iba súbory patriace k aktualizácii a pushni vetvu
main. Tento web používa GitHub Pages; nasadenie sa spúšťa workflowom po pushnutí. Nepoužívaj OpenAI Sites ani nevytváraj iný hostingový projekt. - Stav nasadenia kontroluj v intervaloch 30 až 60 sekúnd. Nepolluj ho častejšie.
- Po úspešnom nasadení načítaj verejnú stránku cez HTTP, skontroluj zobrazenú verziu a odkaz, stiahni verejný EXE do jednoznačne pomenovaného dočasného súboru a porovnaj presnú veľkosť a SHA-256. Dočasný súbor potom odstráň.
- Na konci znovu načítaj využitie Codexu a oznám používateľovi rozdiel oproti počiatočnému stavu spolu s výsledkom nasadenia.
Pri tejto čistej webovej aktualizácii nevytváraj nový build aplikácie Edivect a nezvyšuj jej verziu. Použi presne EXE dodaný používateľom. Changelog synchronizuj iba vtedy, keď o to používateľ požiada alebo keď sú pre danú verziu pripravené nové release notes.