# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Romfast company website (2025 version) for a Romanian ERP software company. Promotes ROA (Romfast Applications) — an ERP system covering accounting, inventory, HR, automotive service, and HORECA industries.

## Deploy

```bash
rsync -avz \
  --exclude='.git' --exclude='.superdesign' --exclude='.claude' \
  --exclude='verify-cleanup.sh' \
  --exclude='efactura-generator/config.json' \
  -e "ssh -p 7822" \
  /home/moltbot/workspace/romfast-website/ \
  romfastr@nl1-ss18.a2hosting.com:~/public_html/
```

- **Host:** nl1-ss18.a2hosting.com | **Port:** 7822 | **User:** romfastr
- **Document root:** `~/public_html/` — SSH key auth (no password)
- **Important:** rsync-ul NU folosește `--delete`, deci nu șterge nimic pe prod. `efactura-generator/config.json` e exclus explicit ca să nu poată fi suprascris niciodată din repo (conține `api_key` și e gestionat doar pe server).

## Sub-proiectul `efactura-generator/`

Directorul `efactura-generator/` din acest repo este o **oglindă** a proiectului canonic `/workspace/efactura-generator/` (repo separat: `git@gitea.romfast.ro:romfast/efactura-generator.git`). Sursa de adevăr e acolo.

**NU edita direct fișierele din `efactura-generator/` aici** — modificările se pierd la următorul sync. În schimb:

1. Editează în `/workspace/efactura-generator/` (repo canonic).
2. Rulează `/workspace/efactura-generator/sync-to-website.sh` care propagă schimbările în `efactura-generator/` din acest repo cu excluderile potrivite (fără `config.json`, fără Dockerfile, fără docs interne etc.).
3. Commit aici (`romfast-website`) și deploy cu rsync-ul de mai sus.

`config.json` de pe server (`~/public_html/efactura-generator/config.json`) conține `api_key` și nu e nici în repo, nici în sync — se gestionează manual pe a2hosting.

## Sub-proiectul `oauth2/`

Flux OAuth2 ANAF eFactura (obținere access/refresh token) folosit de aplicația desktop ROA/ROACONT. Deployat pe `https://romfast.ro/oauth2/`.

- **`index.php`** — endpoint principal, trei ramuri:
  1. **Refresh token** (`refresh_token` primit prin `$_POST` sau `$_GET`) → passthrough curl către ANAF, întoarce JSON brut (folosit de butonul "Actualizare" din ROA).
  2. **Intrare inițială** (fără `?code`) → redirect 302 către ANAF authorize. Dacă vine cu `?state=<64 hex>` salvează state-ul în sesiunea PHP (flux automat, legat de `pick.php`); fără `state` = flux manual/retro-compat (tokenurile apar direct în pagină).
  3. **Callback ANAF** (`?code=...` sau `?error=...`) → schimb code→token; dacă există state valid în sesiune scrie fișier în `tokens/<sha256(state)>.json` (succes sau eroare) și afișează doar o pagină de confirmare; altfel (retro-compat) afișează access/refresh token direct în HTML.
- **`pick.php`** — endpoint de polling apelat de ROA cu `POST state=<64 hex>`. Răspunde `{"status":"pending"}` până apare fișierul de token, apoi îl livrează o singură dată (claim atomic prin `rename`) și îl șterge. TTL 600s pentru fișiere orfane/`.tmp`.
- **`tokens/`** — director de stocare temporară token/eroare, cheie = SHA-256(state). Protejat cu `.htaccess` (`Require all denied`); creat automat de `index.php`/`pick.php` dacă lipsește. Nu se commite conținutul (fișiere efemere, curățate de TTL).
- **`php.ini`** — config logging erori local pentru acest subdirector (`error_log = /oauth2/error_log.txt`).
- **`tests/run_tests.php`** — suită de teste self-contained (fără framework extern), acoperă `index.php` + `pick.php`. Rulare:
  ```bash
  php oauth2/tests/run_tests.php
  ```
  Ce face: copiază `index.php`/`pick.php` într-un director temporar (nu atinge `tokens/` din repo), pornește `php -S 127.0.0.1:8317` pe copie cu `session.save_path` propriu, rulează matricea de teste prin cereri HTTP reale (fără dependențe externe), oprește serverul și curăță totul la final (`register_shutdown_function`). Exit code 0 = toate testele au trecut; ieșirea arată `OK`/`FAIL` per test plus un rezumat `N trecute, M eșuate`. Notă: testele de refresh declanșează un apel curl real către `logincert.anaf.ro` cu un refresh_token fictiv (ANAF răspunde `invalid_grant`) — asercțiunile (nu e 302, `Content-Type` JSON) rămân valabile și offline.

## Development

No build process. Serve locally with:

```bash
python3 -m http.server 8000
# Access at http://localhost:8000
```

The `efactura-generator/` sub-app has its own Node.js server (rulează din repo-ul canonic, nu de aici):

```bash
cd /workspace/efactura-generator && node js/server.js
# Access at http://localhost:3000
```

## Architecture

### Static Website

- **Tailwind CSS** (CDN): `<script src="https://cdn.tailwindcss.com"></script>`
- **Flowbite** (CDN): component library on top of Tailwind
- **Lucide Icons** (CDN): icon set
- **Google Fonts**: Inter (primary), Merriweather (serif), JetBrains Mono
- **`professional-theme.css`**: main custom stylesheet — CSS custom properties, soft professional blue palette, dark mode variables
- **`professional-theme.js`**: handles dark mode toggle, mobile menu, Lucide icon init, scroll/card animations

### CSS Custom Properties (professional-theme.css)

```css
:root {
    --soft-professional-blue: #5288c4;   /* primary */
    --gentle-trust-blue: #4a7ba7;        /* secondary */
    --muted-accent-red: #b85555;         /* accent */
    --executive-navy: #2c3e50;           /* text */
    --navbar-bg: linear-gradient(135deg, #2c3e50, #4a7ba7);
}
```

Dark mode activated via `body.dark-mode` class — toggled by `professional-theme.js`.

### Navigation Pattern

The navbar HTML is **manually duplicated** across every page (no templating). When updating nav links, update all files. Path to CSS/JS assets is relative — top-level pages use `professional-theme.css`, subdirectory pages use `../professional-theme.css`.

### Content Structure

- `/` — homepage (`index.html`)
- `/menu/` — company pages (about, contact, support, services, jobs, references)
- `/roa/` — ROA ERP product pages (one per module)
- `/efactura-generator/` — standalone Romanian e-invoice editor (loads XML, edits, prints, exports XML)
- `/oauth2/` — ANAF eFactura OAuth2 token flow for the ROA desktop app (see "Sub-proiectul `oauth2/`" above)

### efactura-generator

Separate single-page app at `efactura-generator/index.html`. Has its own CSS (`styles/main.css`), JS (`js/script.js`, `js/formatter.js`, `js/print.js`), print templates (`templates/print.html`, `templates/print-compact.html`), and optional Node.js dev server (`js/server.js`). Also deployed as GitHub Pages at `romfast.github.io/efactura-generator/`.