CikkPulse — Projektleírás

Projekt áttekintés

Cél: a CikkPulse egy belső dashboard, amely a szerveren tárolt JSON cikkek teljesítményét mutatja vizuálisan. A rendszer statisztikailag megjeleníti, hogy mikor készültek a cikkek, mennyi szöveget tartalmaznak, és mely kifejezések a legjellemzőbbek (top unigramok és bigramok). A megjelenítés D3 v7 segítségével történik, a backend PHP API-val szolgálja ki az adatok aggregációját.

Támogatók és szponzorok

Az alábbi információk tájékoztató jellegűek; a pénzügyi tranzakciók és külső szolgáltatások használata a projektgazda felelőssége.

Fő funkciók

Idővonal

Pontdiagram, ahol az x tengely a cikk létrehozásának dátuma, a pontok mérete a szószámot jelzi. Interaktív tooltip részletekkel.

Szószám oszlopdiagram

Rendezett oszlopdiagram a cikkek szószáma alapján; hover esetén megjelenik a cikk top5 szava.

Globális top szavak

Összesített unigram és bigram lista; vízszintes sávdiagram a gyakoriságokkal.

Per‑cikk top5

Kis kártyák minden cikkhez: cím, rövid részlet, top5 unigram és bigram.

Telepítés és fájlstruktúra

A javasolt fájlstruktúra a webroot alatt:

/dev/texttrack2026/
  index.html
  css/mjstyle.css
  js/d3.v7.min.js
  js/graph.js
  js/main.js
  ajax/articles.php
  ajax/create_zip.php
/googledrive/json/*.json

PHP‑nek olvasási joga kell legyen a /googledrive/json könyvtárra. A backend a fájlok módosítási idejét (filemtime()) használja a cikk létrehozási dátumaként.

API (rövid)

A backend egy egyszerű PHP végpontot szolgál ki: /ajax/articles.php. A végpont JSON tömböt ad vissza, minden elem tartalmazza:

filename — fájlnév
title — cikk címe
created — ISO dátum (filemtime)
chars — karakterek száma
words — szavak száma
top_unigrams — top5 szó és gyakoriság
top_bigrams — top5 szókapcsolat és gyakoriság

Az ajax/create_zip.php végpont egy ZIP‑fájlt hozhat létre és küldhet vissza a kliensnek (például a JSON fájlok és a generált jelentések csomagolására). A szerveroldali implementációnál ügyelj arra, hogy a ZIP létrehozása és a letöltés biztonságos legyen, és csak jogosult felhasználók férhessenek hozzá, ha szükséges.

Használat

Nyisd meg a projekt gyökér URL‑jét a böngészőben (például: https://dev.margitszigetijoga.hu/dev/texttrack2026/). A kliensoldal a /ajax/articles.php végpontról tölti be az adatokat, majd D3‑al rendereli a diagramokat. Az "Export ZIP" gomb a ajax/create_zip.php végpontra mutat, amely a ZIP letöltését indíthatja el.

Hasznos linkek és források

Projekt élő helye

https://dev.margitszigetijoga.hu/dev/texttrack2026/

Copilot beszélgetés

Csatlakozás a fejlesztési beszélgetéshez: https://copilot.microsoft.com/conversations/join/1Qdk2noZPWYJqdd9UN9nY

D3 dokumentáció

https://d3js.org/

Hozzáférhetőség és WCAG

A felület célja WCAG AA kompatibilitás. Néhány fontos pont:

Kontraszt: a szöveg és háttér kontrasztja legalább 4.5:1.
Fókusz: minden interaktív elem kap jól látható fókuszstílust.
ARIA: diagramokhoz szerepkörök és leírások (aria‑label / aria‑describedby).
Érintés: tooltip és interakciók érintőbarát méretekkel.

Kapcsolat és további lépések

Ha szeretnéd, elkészítem a teljes csomagot (index.html, main.js, articles.php, create_zip.php, CSS) telepítésre kész formában, vagy feltöltöm a megadott helyre, ha hozzáférést biztosítasz. A következő fejlesztési lépések:

PHP végpont telepítése és tesztelése
Timeline és bar chart D3 komponensek implementálása
Stopword lista bővítése (magyar + angol)
WCAG audit és finomhangolás