v2.0

-

 

🦒 ZsIRAF AIto felcser – Verziókövetési Dokumentáció (v1.0 → v2.0)

Ez a dokumentum összefoglalja a szoftver evolúcióját az alapötlettől a modernizált, "Glassmorphism" dizájnig.

🟢 v1.0 – Az MVP (Minimum Viable Product)

Kiadás dátuma: [Dátum]
Cél: Működőképes prototípus létrehozása, amely képes kommunikálni a Google Gemini API-val.

1. Funkcionális Jellemzők

  • Alap űrlap: Mezők a hibakód (DTC), márka, modell, évjárat és tünetek megadására.

  • API Hívás: Egyszerű fetch kérés a Google gemini-pro modelljéhez.

  • Prompt Engineering: Egyetlen, statikus prompt sablon, amely JSON választ kér az AI-tól.

  • Eredmény Megjelenítés: Nyers HTML generálás a válasz JSON alapján.

    • Zöld háttér: Gyakori hibaokok (magas forrásszám).

    • Narancs háttér: Ritkább hibaokok.

  • PDF Export: Alapvető window.print() funkció a találatok kinyomtatására.

  • API Kulcs: Manuális beillesztés egy egyszerű prompt ablakban, tárolás localStorage-ban.

2. Technikai Megvalósítás

  • Stílus: Egyszerű CSS, sötét téma (#020617), de még design keretrendszer nélkül.

  • Háttér: Statikus kép URL (kephost.net).

  • Statisztika: Helyi látogatásszámláló (localStorage-ban).

🔵 v1.5 – Stabilitás és Pontosítás (Köztes frissítések)

A v2.0 előtt több kisebb, a motorháztető alatti javítás történt.

1. Hibajavítások

  • JSON Parsing: Az AI néha Markdown formázással (```json) küldte a választ, ami hibát okozott. Beépítésre került egy tisztító (regex) algoritmus a JSON kinyerésére.

  • Kivételkezelés: Jobb hibaüzenetek, ha az API kulcs érvénytelen vagy a hálózat megszakad.

2. Logikai Finomhangolás

  • Threshold (Küszöb): A felhasználó beállíthatta, hány forrás megerősítése kell a "zöld" jelzéshez (1-10 skála).

🟣 v2.0 – "Glass UI" és Intelligens Felület

Kiadás dátuma: [Dátum]
Cél: A felhasználói élmény (UX) és a vizuális megjelenés (UI) drasztikus modernizálása, valamint a használhatóság javítása.

1. Újítások a Designban (Visual Overhaul)

  • Glassmorphism: Bevezetésre került az üvegszerű, áttetsző felület (backdrop-filter: blur(16px)).

    • A kártyák és input mezők félig átlátszóak lettek.

    • Finom árnyékok és fénylő keretek (border: 1px solid rgba(255,255,255,0.1)).

  • Animált Háttér: A statikus kép helyett/mellett megjelentek a finom CSS gradiensek és lebegő effektek.

  • Reszponzivitás: Teljesen újraírt CSS Grid és Flexbox alapú elrendezés, amely tökéletesen igazodik mobilhoz és asztali géphez is.

  • Tipográfia: Áttérés a modern, sans-serif betűtípusokra és jobb olvashatóságra.

2. Funkcionális Fejlesztések

  • Intelligens API Gomb:

    • Az oldal betöltésekor ellenőrzi, van-e mentett kulcs.

    • Ha nincs: A gomb pirosan villog (pulzál), és megjelenik egy részletes útmutató doboz.

    • Ha van: A gomb zöldre vált ("OK"), és az útmutató eltűnik, tisztítva a felületet.

  • Dedikált Modal Ablakok: A window.prompt helyett saját stílusú, az oldalba simuló felugró ablakok az API kulcs megadásához.

  • Kétoszlopos Eredmény: Az elemzés eredményei (Erős vs. Gyenge okok) egymás mellett jelennek meg nagyobb képernyőn.

3. Technikai Változások

  • Kódstruktúra: A JavaScript kód modularizálása (init, checkApiKey, runAnalysis függvények szétválasztása).

  • Biztonság: Az API kulcs kezelésének finomítása (üres inputok szűrése, whitespace vágás).

  • Prompt Frissítés: Az AI utasítása pontosabb lett, kifejezetten kérve a magyar nyelvű, strukturált JSON kimenetet.

Összehasonlító Táblázat

Funkcióv1.0v2.0
DesignEgyszerű sötét módModern Glassmorphism
ElrendezésLineáris (egymás alatt)Grid (kétoszlopos desktopon)
API KulcsStatikus gombIntelligens, állapotjelző gomb
VisszajelzésNyers szövegAnimált betöltés, színes kártyák
EszközökAlapvetőMobil-optimalizált

Ez a dokumentáció lefedi a szoftver fejlődésének első nagy szakaszát, ahol a hangsúly a működőképességről a felhasználói élményre és a modern megjelenésre helyeződött át.

Megjegyzések

Megjegyzés küldése

Népszerű bejegyzések ezen a blogon

v3.5

-
🦒 ZsIRAF AIto felcser v3.5.0 – Professional Edition (Jelenlegi stabil verzió) Ez a kiadás a felhasználói élmény és a szakmai hitelesség tökéletesítésére fókuszált. Új PDF Nyomtatási Motor: Teljesen átírt exportálási funkció. Dedikált, nyomtatóbarát sablon (fekete-fehér alap, színes jelölőkkel). Dinamikus fájlnév generálás: zsirafaitofelcser_[AUTO_TIPUS]_[DATUM].pdf . A nyomtatott verzió külön tartalmazza a metaadatokat és a disclaimert. Felhasználói Felület (UI) Finomhangolás: Minden címke és gomb szövege szakmai nyelvezetre frissítve (pl. "Hibakód" helyett "Hibakód (DTC / OBDII)" ). Szétválasztottuk a Jogi Nyilatkozatot (piros figyelmeztetés) és a Visszajelzés kérést (fejlesztői kapcsolattartás), hogy ne mosódjanak össze. Bővített Útmutatók: Részletes, lépésről-lépésre útmutató a Google Gemini API kulcs beszerzéséhez közvetlenül az alkalmazáson belül. v3.4.0 – Visual FX & Logic Tuning Animált Státuszjelző: Bevezetésre került a "Mátrix-stílusú" f...
További információk

v1.0

-
  🦒 ZsIRAF AIto felcser v1.0 – Műszaki Dokumentáció 1. Bevezetés 1.1 Célkitűzés A ZsIRAF AIto felcser v1.0 egy webes alkalmazás, amelynek célja, hogy a felhasználók (autótulajdonosok és hobbiszerelők) számára gyors, AI-alapú elődiagnosztikát nyújtson. A szoftver a bevitt hibakódok (DTC) és tünetek alapján, a Google Gemini nyelvi modelljét használva azonosítja a lehetséges hibaokokat és javítási javaslatokat tesz. 1.2 Működési elv Az alkalmazás kliensoldali (böngészőben futó) JavaScript kódot használ. Nincs saját backend szervere; közvetlenül kommunikál a Google Cloud API-val. A felhasználó megadja az adatokat, a szkript összeállít egy speciális utasítást (prompt), elküldi az AI-nak, majd a visszaérkező JSON adatokat felhasználóbarát formában megjeleníti. 2. Technikai Specifikáció 2.1 Technológiai Stack Frontend: HTML5, CSS3 (Modern, reszponzív design), Vanilla JavaScript (ES6+). Backend: Nincs (Serverless architektúra). AI Szolgáltató: Google Gemini API. AI Modell: g...
További információk