ContApp PFA

Aplicație simplă React pentru evidența veniturilor și cheltuielilor unui PFA. Toate datele rămân în browser-ul tău (localStorage); nu sunt trimise către niciun server.

Caracteristici

• Adaugă venituri și cheltuieli cu dată și descriere.
• Sumar rapid: total, luna curentă și profit.
• Grafic comparativ pe ultimele 12 luni.
• Descrieri predefinite pentru PFA (servicii, chirie, utilități etc.).
• Temă deschisă/închisă, salvată local.
• Export CSV (Excel) cu datele tale.

Tehnologii

• React 18 + TypeScript
• Vite 8
• CSS custom (fără framework UI)
• Vitest + Testing Library pentru teste
• ESLint + Prettier pentru calitatea codului

Pornire locală

# Instalează dependențele
npm install

# Pornește serverul de dezvoltare
npm run dev

Sau dublu-click pe start-app.command (macOS).

Scripts utile

Script	Descriere
npm run dev	Server de dezvoltare cu hot reload
npm run build	Build de producție (dist/)
npm run preview	Previzualizează build-ul de producție
npm run lint	Rulează ESLint
npm run lint:fix	Rulează ESLint și corectează automat unde poate
npm run format	Formatează codul cu Prettier
npm test	Rulează testele o singură dată
npm run test:watch	Rulează testele în mod watch

Arhitectură

src/
  App.tsx                 – container principal și stare globală
  components/             – componente reutilizabile
  hooks/useTheme.ts       – gestiunea temei
  lib/                    – utilități (calcul, formatare, storage, CSV)
  types.ts                – tipurile aplicației

Note de securitate

• Datele sunt stocate doar în localStorage al browserului. Golirea cache-ului sau a datelor de navigare le va șterge.
• Exportul CSV escap-ează câmpurile pentru a preveni probleme la deschiderea în Excel.
• crypto.randomUUID() are fallback pentru contexte non-securizate (HTTP).

Licență

Proiect privat.