Kiadási megjegyzések — 2026. március 7.
Ez a kiadás a Jelentések & Analitika modul átfogó megújítását hozza: Excel és XML export formátumok, jelentéstörténet megőrzés, statisztikai kártyák újratervezése, PDF elrendezés fejlesztések és számos UX javítás.
Jelentések & Analitika — Nagyobb frissítés
Excel export (PRO+)
A jelentések mostantól exportálhatók professzionálisan formázott Excel (.xlsx) munkafüzetbe, két munkalappal.
Munkafüzet szerkezete:
- Összefoglaló lap — jelentés metaadatok, fő mutatók, szűrési kontextus
- Adatlap — dinamikus oszlopok (számlázható, bevétel ha van), formázott táblázat befagyasztott fejléccel, auto-szűrővel, váltakozó sorokkal
Elérhető innen:
- Jelentések oldal → Export menü → Excel letöltése
- Mentett jelentés → Jelentés előnézet → Excel gomb
- Ütemezett jelentések → formátum kiválasztása → Excel
Tier: PRO+ (INGYENES csomagnál PRO chip látható — Excel nem elérhető)
XML export (ENTERPRISE)
Az időkövetési adatok mostantól exportálhatók strukturált XML dokumentumként.
XML dokumentum szerkezete:
<?xml version="1.0" encoding="UTF-8"?>
<report>
<meta>...</meta>
<filters>...</filters>
<metrics>...</metrics>
<dataPoints>
<entry>...</entry>
</dataPoints>
</report>
Tier: Csak ENTERPRISE (INGYENES/PRO csomagnál ENTERPRISE chip látható)
JSON fájl export (ENTERPRISE)
A meglévő inline JSON API válasz mellett a jelentések mostantól önálló JSON fájlként (.json) letölthetők (Content-Disposition: attachment).
Tier: Csak ENTERPRISE
Jelentéstörténet megőrzés tier alapján
A mentett jelentések az előfizetési csomag alapján szűrve láthatók:
| Csomag | Látható előzmény |
|---|---|
| INGYENES | Utolsó 30 nap |
| PRO | Utolsó 365 nap |
| ENTERPRISE | Korlátlan |
A Jelentések oldalon egy tájékoztató banner értesíti az INGYENES és PRO felhasználókat az előzmény-ablakukról, INGYENES felhasználóknak frissítési hivatkozással.
Egy éjszakai törlési feladat (02:00-kor fut) automatikusan eltávolítja a tier-határon kívüli jelentéseket.
Csoportosítás: Felhasználó szerint (PRO+)
Új „Felhasználó szerint" csoportosítási lehetőség érhető el a Jelentések oldalon. Felváltja a régi reportType választót (összefoglaló / részletes / export), amely redundáns volt.
A Felhasználó csoportosítási opció INGYENES felhasználóknak PRO chippel letiltva jelenik meg.
Mind az 5 locale (EN / HU / DE / FR / ES) tartalmazza az új fordítási kulcsot.
Statisztikai kártyák & Gyors betekintések — Láthatóság javítás
A 4 statisztikai kártya (Összes óra, Összes bejegyzés, Aktív projektek, Napi átlag) és a Gyors betekintések szekció nem jelent meg a Jelentések oldal betöltésekor.
Gyökérok: A currentUnit?.id hiányzott az useEffect függőségi tömbből. Betöltéskor currentUnit === null volt, ami miatt a jelentésgenerálás korai visszatérést végzett, mielőtt a munkaterület betöltött.
Javítva: AdvancedReports.tsx és BasicReports.tsx
Jelentés előnézet — Újratervezett elrendezés
A Jelentés előnézet oldal mostantól megfelel a főoldali Jelentések oldal elrendezésének:
- 4 statisztikai kártya — Összes óra / Összes bejegyzés / Aktív projektek / Napi átlag
- Gyors betekintések — Top 3 projekt · Legaktívabb nap · Csúcsidőszak · Átlagos bejegyzés időtartam
- Ezt követi: Jelentés info → Grafikon → Adattáblázat
PDF export — Újratervezett elrendezés
A PDF kimenet mostantól megfelel a frontend jelentés elrendezésének:
addMetrics() — újraírva:
- 4 színes statisztikai kártya bal oldali accent sávval
- Tömörebb méretezés:
boxH = 52(volt 72),fontSize = 18(volt 22)
addQuickInsights() — új szekció:
- Top 3 projekt + Legaktívabb nap + Csúcsidőszak + Átlagos bejegyzés
- Abszolút X/Y pozicionálás — megszünteti a szöveg-átfedési hibákat
- Felirat csonkítás 17 karakternél
Grafikon javítás:
- A
chartType = 'table'értékkel mentett jelentések korábban nem generáltak grafikont a PDF-ben - Most
bargrafikonra vált vissza; a grafikon csak akkor marad ki, ha nincs adat
Mentés Jelentésként — Helyes grafikon típus
Amikor egy ad-hoc jelentést egyéni jelentésként ment el, a chartConfig.type mező mostantól helyesen tükrözi az aktuálisan aktív nézetet:
- Grafikon nézet aktív →
BARmentése - Táblázat nézet aktív →
TABLEmentése
Korábban mindig TABLE volt mentve a nézettől függetlenül.
Statisztikai kártya — Tömörebb elrendezés
| Tulajdonság | Előtte | Utána |
|---|---|---|
| Kártya belső margó | alapértelmezett (16 px) | py: 1.5 |
| Ikon doboz mérete | 48 × 48 | 40 × 40 |
| Szám variáns | h4 | h5 |
| Sormagasság | alapértelmezett | 1.2 |
„Futtatás most" értesítés — Jobb felső sarokba helyezve
A „Jelentés végrehajtva és elküldve N címzettnek" toast korábban az oldal alján (közép-alul) jelent meg.
Mostantól a globális notification segédeszközt használja, és a jobb felső sarokban jelenik meg, összhangban az összes többi alkalmazáson belüli értesítéssel.
Biztonság & Tier érvényesítés
Ütemezett jelentések — Backend ellenőrzés
A createReport és updateReport végpontok mostantól API szinten érvényesítik a tier ellenőrzést a schedule.enabled mezőre vonatkozóan:
- Az INGYENES felhasználók az API-n keresztül sem kapcsolhatják be az ütemezést (korábban csak a felhasználói felületen volt blokkolva)
403 TIER_RESTRICTIONválaszt ad vissza,tierRequired: 'pro'értékkel
PRO customReports képesség javítás
A customReports helytelenül false értékre volt beállítva a PRO tier konfigurációban. Kijavítva true értékre (PRO: max 5 egyéni jelentés, ENTERPRISE: korlátlan).
Függőségek
| Csomag | Változás |
|---|---|
exceljs | Hozzáadva (Excel generáláshoz) |
Módosított fájlok
| Fájl | Változás |
|---|---|
cadensa-backend/src/controllers/report.controller.ts | Excel / JSON / XML letöltési végpontok; ütemezett jelentések tier gate; jelentéstörténet cutoff szűrő |
cadensa-backend/src/services/report/excel.service.ts | Új — Excel generálás exceljs-sel |
cadensa-backend/src/services/report/xml.service.ts | Új — XML generálás |
cadensa-backend/src/services/report/pdf.service.ts | addMetrics() újraírás; addQuickInsights() új; addChartPlaceholder() table→bar visszaesés |
cadensa-backend/src/services/report/schedule.service.ts | Excel formátum ág; éjszakai előzmény törlési cron |
cadensa-backend/src/config/stripe.config.ts | PRO customReports: false → true javítás |
cadensa-frontend/src/pages/reports/components/AdvancedReports.tsx | currentUnit?.id dep javítás; előzmény banner; groupBy: user; kártya tömörítés; viewMode alapú grafikon típus; notification.* a Futtatás most-hoz |
cadensa-frontend/src/pages/reports/components/BasicReports.tsx | currentUnit?.id dep javítás |
cadensa-frontend/src/pages/reports/ReportPreview.tsx | Újratervezett elrendezés: statisztikai kártyák + Gyors betekintések; PDF/Excel/XML/JSON gombok |
cadensa-frontend/src/services/report.service.ts | downloadReportExcel, downloadReportJSON, downloadAdHocReportJSON, downloadReportXML, downloadAdHocReportXML |
cadensa-frontend/src/locales/{en,hu,de,fr,es}/reports.json | xml, xmlFailed, jsonRequiresEnterprise, xmlRequiresEnterprise, groupBy_user kulcsok |