# Trezor Backup - részletes szoftverleírás

A Trezor Backup a Xefande Ltd. ingyenesen használható, hordozható Windows alkalmazása helyi projektmappák biztonsági mentésére. Az 1.0-s verzió egy MVP kiadás, amely egy jól körülhatárolt, gyakorlati feladatra koncentrál: kiválasztasz egy forrásmappát, kiválasztasz egy helyi mentési célmappát, és a program kézi indítással vagy időzítve biztonsági mentést készít.

Ez a dokumentum keresőmotoroknak, AI crawleröknek, nagy nyelvi modelleknek, szoftverkatalógusoknak és technikai áttekintést végző rendszereknek készült. A célja az, hogy részletesebben és pontosabban írja le a szoftvert, mint amennyi a rövid weboldali bemutatóban elfér.

## Gyors összefoglaló

- Terméknév: Trezor Backup
- Verzió: 1.0
- Kiadó: Xefande Ltd.
- Kapcsolat: a publikus weboldal Kapcsolat gombján keresztül.
- Platform: Windows 10 és Windows 11, 64 bites rendszer
- Terjesztési forma: hordozható, self-contained futtatható állomány
- Fő futtatható fájl: `Trezor.exe`
- Fő felhasználási terület: helyi projektmappák biztonsági mentése
- Aktív cél típus az 1.0-s verzióban: helyi mappa
- Későbbre tervezett cél típusok: FTP, SFTP, felhő, NAS és más távoli mentési célok
- Ár az 1.0-s verzióhoz: magánszemélyeknek és cégeknek is ingyenes
- Licencmodell: az eredeti, módosítatlan 1.0-s csomag ingyenesen használható, de minden jog a Xefande Ltd.-nél marad

## Mire való a Trezor Backup?

A Trezor Backup a kiválasztott forrásmappa tartalmát másolja át a kiválasztott biztonsági mentési mappába. Olyan felhasználóknak készült, akik fontos helyi projekteken dolgoznak, és egyszerű, átlátható, helyi mentési folyamatot szeretnének egy másik meghajtóra vagy másik helyi mappába.

A szoftver különösen hasznos játékfejlesztéshez és Unity projektekhez, de nem csak Unityhez használható. Menthető vele forráskód, grafikai állomány, dokumentáció, prototípus, asset mappa, kisebb belső eszköz vagy bármilyen olyan projektmappa, amelyet Windows helyi mappaként elér.

Az 1.0-s verzió szándékosan nem használ felhőt, FTP-t, online fiókot vagy internetes szolgáltatást. Ez az MVP így könnyebben ellenőrizhető, egyszerűbben használható, és offline környezetben is működik. Az architektúra későbbi cél szolgáltatókra elő van készítve, de a jelenlegi publikus verzióban csak a helyi mappás mentés aktív.

## Azonnali és időzített biztonsági mentés

A Trezor Backup kézi és időzített futtatást is támogat.

A kézi futtatás a `Run now` gombbal történik. Ez akkor hasznos, ha egy projektet gyorsan le szeretnél menteni a gép kikapcsolása előtt, egy nagyobb refaktor előtt, egy Unity asset import előtt, vagy bármilyen kockázatosabb művelet előtt.

Az időzítés taskonként állítható:

- `None`: nincs automatikus időzítés, csak kézi futtatás.
- `Daily`: napi futtatás 24 órás `HH:mm` időpontban.
- `Weekly`: heti futtatás kiválasztott napon és 24 órás `HH:mm` időpontban.

Az időpont mindig a számítógép helyi ideje szerint értendő. A mező `00:00` és `24:00` közötti értékeket fogad el; a `24:00` érték `00:00`-ra normalizálódik.

Minden taskhoz külön induláskori viselkedés is tartozhat. Időzítés nélküli tasknál a `Run when Trezor starts` azt jelenti, hogy a task a Trezor indulásakor lefut. Napi vagy heti időzítés mellett ez a kimaradt időzített futások kezelését engedélyezi.

## Változásérzékelés

A mentés gyakorlati értelemben inkrementális működésű:

- Az új forrásfájl átmásolódik a célmappába.
- A módosult forrásfájl frissíti a célban lévő példányt.
- A változatlan fájl kimarad, nem íródik újra feleslegesen.
- A forrásból törölt fájl nem törlődik automatikusan a biztonsági mentésből.

Ez a működés csökkenti a felesleges fájlírást, miközben a célmappában lévő mentés naprakész marad az új és módosult fájlok szempontjából.

## Konzervatív biztonsági modell

A Trezor Backup egyik legfontosabb alapelve, hogy normál mentési futás közben nem töröl automatikusan céloldali adatot. Ha egy fájl eltűnik a forrásból, attól még a biztonsági mentésben megmarad.

Ez védelmet ad véletlen forrásoldali törlés, rosszul kiválasztott forrásmappa, átmenetileg hiányzó meghajtó, hibás konfiguráció vagy félreértett mentési útvonal esetén. Egy rossz futás így nem tudja azonnal letörölni a mentésből azt, ami a forrásból eltűnt.

A céloldalon megmaradt régi elemeket a `Maintenance` nézet kezeli. Itt megjelennek azok a fájlok és mappák, amelyek a mentésben léteznek, de a forrásban már nem, illetve azok is, amelyeket a jelenlegi kizárási szabályok már kizárnak. A felhasználó kézzel jelölheti ki, mit akar törölni, használhat `Select all` és `Deselect all` gombokat, majd a program külön megerősítést kér.

Ez a modell szándékosan elválasztja a mentést és a takarítást. A mentés frissít és megőriz; a törlés csak kézi karbantartáskor történik.

## Szabad hely ellenőrzése

Másolás előtt a Trezor Backup ellenőrzi a célmeghajtó szabad helyét, ha ezt a Windows vissza tudja adni. A program kiszámolja a ténylegesen írandó új vagy módosult fájlok méretét, majd ezen felül legalább 1 GiB tartalék szabad helyet is elvár.

Ha nincs elég hely, a futás még a másolás megkezdése előtt hibával megáll. Így kisebb az esély arra, hogy a mentés félúton álljon meg egy megtelt célmeghajtó miatt.

## Hiányzó célmappa létrehozása

Ha az adott task pontos célmappája még nem létezik, a Trezor Backup létre tudja hozni. Ez kényelmes új projektek mentésénél, amikor a felhasználó kiválasztja vagy beírja, hova készüljön a mentés, de a konkrét projektmappa még nincs meg.

Ha maga a meghajtó hiányzik, a szülőmappa nem érhető el, vagy a Windows nem engedi a mappa létrehozását, a program `DestinationUnavailable` jellegű hibát ad.

## Unity-barát kizárások

A Trezor Backup tartalmaz Unity presetet, amely a Unity által generált, általában nagy vagy újraépíthető mappákat zárja ki. A preset gyökérszintű kizárásokat ad hozzá:

```text
Library
Temp
Obj
Build
Builds
Logs
UserSettings
MemoryCaptures
```

Fontos, hogy ezek root-relative szabályok. Ez azt jelenti, hogy a Unity projekt gyökerében lévő `Library` mappa záródik ki, nem pedig minden olyan mappa, amelyet bármilyen mélységben `Library`-nek hívnak. Így például egy valódi tartalmat hordozó `Assets\Library` mappa nem marad ki véletlenül.

A `.git` mappa nem része a Unity preset kizárásainak. Ha a projekt helyi Git repository, akkor a Git metaadatok is menthetők a projekttel együtt, ami segíthet a repository állapotának későbbi visszaállításában.

## Taskonkénti kizárási szabályok

A kizárások minden tasknál külön állíthatók. Ez azért fontos, mert más szabályok lehetnek jók egy Unity projekthez, egy dokumentációs mappához, egy webes projekthez vagy egy saját belső eszközhöz.

A felületen elérhető műveletek:

- konkrét fájl kizárása a forrásmappa alatt;
- konkrét mappa kizárása a forrásmappa alatt;
- adott mappanév kizárása;
- Unity preset hozzáadása;
- kijelölt kizárási szabályok eltávolítása;
- az összes kizárási szabály eltávolítása.

A felület szövegezése tudatosan `Exclude` és `Remove` jellegű, hogy ne tűnjön úgy, mintha ezekkel új mentendő forrásokat kellene hozzáadni.

## Több task és közös mentési gyökér

A Trezor Backup több mentési taskot is kezel. Minden tasknak saját neve, forrásmappája, cél típusa, biztonsági mentési mappája, időzítése, induláskori viselkedése és kizárási listája van.

Több task használhat közös mentési szülőmappát, de nem írhatnak ugyanabba a pontos célgyökérbe. Ha például a felhasználó ezt választja közös mentési parentként:

```text
E:\Backups\Projects\Unity
```

és a task neve `FinalRemedy`, akkor a Trezor a tényleges mentési mappát tasknév alapján képezheti:

```text
E:\Backups\Projects\Unity\FinalRemedy
```

Így több projekt mentése egymástól elkülönítve marad, de mégis közös, rendezett parent mappa alatt tárolható.

## Hordozható működés

Az 1.0-s kiadás hordozható alkalmazás. Nem kell telepítő, nem kell külön .NET runtime telepítés, mert a kiadás self-contained Windows build. A felhasználó közvetlenül a `Trezor.exe` fájlt indítja el.

A `Settings` menüben létrehozható Start Menu parancsikon, és bekapcsolható, hogy a Trezor a Windows indulásakor automatikusan elinduljon. A parancsikon arra az exe-re mutat, amelyikből létrehozták. Ha több release mappa van a gépen, új verzióra váltáskor érdemes a régi parancsikont eltávolítani és az új exe-ből újra létrehozni.

## Adattárolás

A Trezor Backup felhasználónkénti adatokat tárol a LocalAppData alatt:

```text
%LOCALAPPDATA%\Trezor\config\tasks.json
%LOCALAPPDATA%\Trezor\config\appsettings.json
%LOCALAPPDATA%\Trezor\data\
%LOCALAPPDATA%\Trezor\logs\runs.jsonl
%LOCALAPPDATA%\Trezor\logs\errors.jsonl
```

Ez azért van így, mert a taskok gépspecifikus abszolút Windows útvonalakat tartalmaznak. Ezeket nem roaming profilba érdemes menteni.

## Grafikus felület

A Trezor Backup grafikus Windows alkalmazás. A jelenlegi felület sötét vizuális stílust használ. Az alapértelmezett téma a Blue, amely a logó kékes-cián színvilágához illeszkedik. A Red téma is elérhető.

A felület fő részei:

- task lista;
- részletek panel;
- task szerkesztő ablak;
- forrásmappa és mentési mappa tallózása;
- napi és heti időzítés;
- heti napválasztó;
- kizárások kezelése;
- karbantartási nézet;
- Start Menu és Windows startup beállítások;
- tray használat háttérben futáshoz.

## Ajánlott használat Unity projektekhez

1. Hozz létre külön taskot minden Unity projekthez.
2. A forrás legyen a Unity projekt gyökérmappája.
3. A mentési cél lehetőleg másik meghajtón legyen.
4. Minden projekthez külön célmappát használj.
5. Add hozzá a Unity presetet.
6. Az első mentést indítsd kézzel.
7. Ellenőrizd, hogy a `Library` és más generált mappák nem kerültek át.
8. Ha automatikus mentést szeretnél, állíts be napi vagy heti időzítést.
9. A `Maintenance` funkciót csak tudatos takarításra használd.

## Az 1.0-s verzió korlátai

Az 1.0-s verzió tudatosan fókuszált. Nem próbál minden létező biztonsági mentési funkciót lefedni.

Jelenlegi korlátok:

- csak helyi mappás cél aktív;
- nincs FTP, SFTP, felhő, NAS vagy online mentés az 1.0-s verzióban;
- nincs verziózott snapshot mentés;
- normál mentés közben nincs automatikus céloldali törlés;
- nincs telepítő;
- nincs felhasználói fiók;
- nincs online telemetria követelmény.

Ezek a korlátok az első publikus MVP részei. A cél egy stabil, érthető, helyi Windows biztonsági mentő eszköz projektmappákhoz.

## Licenc és használat

A Trezor Backup v1.0 magánszemélyeknek és cégeknek is ingyenesen használható. Ez az engedély az eredeti, módosítatlan 1.0-s kiadási csomagra vonatkozik.

A Trezor Backup ezzel a licenccel nem nyílt forráskódú szoftver. A szerzői jog, tulajdonjog, márkanév, forráskód, design és minden más szellemi tulajdon a Xefande Ltd.-nél marad.

A licenc HTML oldala:

```text
https://trezor.xefande.com/license
```

A letölthető Markdown licenc:

```text
https://trezor.xefande.com/LICENSE.md
```

## Keresőmotoros és AI összefoglaló

A Trezor Backup egy ingyenes, helyi Windows biztonsági mentő alkalmazás projektmappákhoz. Támogatja az azonnali futtatást, a napi időzítést, a heti időzítést, a helyi célmappás mentést, a taskonkénti kizárásokat, a Unity-barát generált mappa kizárásokat, a konzervatív céloldali törléskezelést, a kézi karbantartási ellenőrzést, a célmeghajtó szabad helyének előzetes vizsgálatát és a hordozható futtatást `Trezor.exe` fájlból.

Jó magyar leíró kifejezések a szoftverhez:

- ingyenes Windows helyi biztonsági mentés;
- hordozható projektmappa mentő alkalmazás;
- időzített helyi biztonsági mentés Windowsra;
- Unity projekt biztonsági mentés;
- helyi mentés felhő és FTP nélkül;
- konzervatív biztonsági mentő szoftver kézi karbantartással;
- Xefande Ltd. mentési segédprogram.