sync efactura-generator -> 0.9-beta-14
Mirror sincronizat cu repo canonic /workspace/efactura-generator. CLAUDE.md: documentat workflow sync + exclude config.json din rsync deploy. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Agent
@@ -1,61 +1,172 @@
|
||||
# eFactura Editor / Editor Facturi Electronice
|
||||
|
||||
## Demo
|
||||
https://romfast.github.io/efactura-generator/
|
||||
|
||||
## Overview / Prezentare
|
||||
Romanian electronic invoice (eFactura) editor - loads XML, allows editing, printing invoices and generates new XML files.
|
||||
|
||||
Editor pentru facturi electronice (eFactura) - încarcă fișiere XML, permite editarea, printarea facturilor și generează fișiere XML noi.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Installation & Usage / Instalare & Utilizare
|
||||
|
||||
### Option 1: Web Server / Opțiunea 1: Server Web
|
||||
- Copy all project files to your web server maintaining the directory structure.
|
||||
- Access through your web server URL.
|
||||
- Use "Printează" button to print the invoice.
|
||||
|
||||
- Copiați toate fișierele pe server păstrând structura directoarelor.
|
||||
- Accesați prin URL-ul serverului.
|
||||
- Folosiți butonul "Printează" pentru a printa factura.
|
||||
|
||||
### Option 2: Local Development / Opțiunea 2: Dezvoltare Locală
|
||||
1. Install Node.js / Instalați Node.js
|
||||
2. Clone/download repository / Clonați/descărcați repository-ul
|
||||
3. Run / Rulați: `node server.js`
|
||||
4. Open / Deschideți: http://localhost:3000
|
||||
|
||||
## Project Structure / Structura Proiect
|
||||
```
|
||||
project/
|
||||
├── index.html
|
||||
├── styles/
|
||||
│ ├── main.css
|
||||
├── js/
|
||||
│ ├── script.js
|
||||
│ ├── formatter.js
|
||||
│ └── print.js
|
||||
├── templates/
|
||||
│ └── print.html
|
||||
└── server.js
|
||||
```
|
||||
|
||||
## License / Licență
|
||||
AGPL-3.0-or-later
|
||||
|
||||
If you use this software, even as a web service, you must:
|
||||
1. Give credit to the original project
|
||||
2. Share all your modifications
|
||||
3. Use the same AGPL-3 license
|
||||
|
||||
Dacă folosiți acest software, chiar și ca serviciu web, trebuie să:
|
||||
1. Menționați proiectul original
|
||||
2. Partajați toate modificările făcute
|
||||
3. Folosiți aceeași licență AGPL-3
|
||||
|
||||
## Changelog
|
||||
[Istoric modificări](CHANGELOG.md)
|
||||
# Editor eFactura
|
||||
|
||||
Editor static în browser pentru fișiere XML eFactura (UBL 2.1) conforme cu standardul ANAF.
|
||||
|
||||
## Demo
|
||||
|
||||
- GitHub Pages: https://romfast.github.io/efactura-generator/
|
||||
|
||||
## Scop
|
||||
|
||||
Aplicația este intenționat **statică** (HTML + CSS + JavaScript, fără build, fără backend obligatoriu) astfel încât să poată fi găzduită direct pe GitHub Pages sau pe orice server web simplu.
|
||||
|
||||
Cazurile principale de utilizare:
|
||||
- **Corecții minore** într-un XML eFactura existent (date factură, furnizor, client, articole, TVA).
|
||||
- **Generare factură storno** pornind de la o factură existentă, prin butonul „Stornează”.
|
||||
|
||||
Nu este un sistem complet de facturare — lucrează cu câte un singur XML, încărcat și salvat local.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Funcționalități
|
||||
|
||||
### Încărcare XML
|
||||
- Încărcare fișier XML local prin butonul „Alege Fișier XML”.
|
||||
- Încărcare automată dintr-un fișier temporar prin parametru URL (`index.html?xml=<nume_fisier>`), folosit împreună cu `receiver.php` pentru integrare cu sisteme externe.
|
||||
|
||||
### Detalii factură
|
||||
- Număr factură, data emiterii, data scadentă (cu calendar Pikaday și format `dd.mm.yyyy`).
|
||||
- Monedă document și monedă TVA opțională (cu generarea automată a celui de-al doilea tag `TaxTotal` când monedele diferă).
|
||||
- Câmp text adițional (notă) cu limită de 900 de caractere și împărțire automată.
|
||||
|
||||
### Furnizor și client
|
||||
- Nume, cod TVA, număr de înregistrare, adresă, oraș, județ, țară, telefon, persoană de contact, email.
|
||||
- Selector de țară conform ISO 3166-1 și selector de județ conform codurilor `RO-XX`.
|
||||
- Tratare specială pentru București și pentru furnizori neplătitori de TVA (cod fiscal fără atributul `RO`).
|
||||
|
||||
### Articole factură
|
||||
- Adăugare, editare și ștergere articole.
|
||||
- Cantitate, preț, cotă TVA, unitate de măsură (EA, XPP, H87, KGM, MTR, LTR, MTQ).
|
||||
- Reduceri pe linie cu cod și motiv reducere.
|
||||
- Coduri de identificare articole multiple per linie: cod vânzător, cod cumpărător, cod de bare, CPV, NC8, cod vamal.
|
||||
|
||||
### TVA
|
||||
- Tipuri TVA suportate: `S` (Standard), `AE` (Taxare Inversă), `O` (Neplătitor TVA), `Z` (Cotă 0%), `E` (Neimpozabil).
|
||||
- Coduri de scutire `VATEX-EU-*` cu motiv corespunzător, completate automat în funcție de tipul TVA și editabile manual.
|
||||
- Defalcare TVA cu mai multe cote, editabilă inline (bază impozabilă și valoare TVA).
|
||||
|
||||
### Reduceri și taxe la nivel de factură
|
||||
- Adăugare/editare/ștergere reduceri și taxe suplimentare la nivel de document.
|
||||
- Coduri motiv pentru reduceri (95, 41, 42, 60, 62 etc.) și pentru taxe (TV, FC, ZZZ).
|
||||
|
||||
### Totaluri
|
||||
- Recalculare automată: subtotal, total reduceri, total taxe, valoare netă, TVA, total.
|
||||
- Editare inline a totalurilor (click pe valoare) cu păstrarea totalurilor originale din XML-ul încărcat.
|
||||
- Buton „Recalculează Totaluri” pentru regenerare din articole.
|
||||
|
||||
### Storno
|
||||
- Buton „Stornează” care convertește factura curentă într-o factură storno (cantități și valori negative) gata de salvat.
|
||||
|
||||
### Salvare și printare
|
||||
- Buton „Salvează XML” care generează și descarcă un XML UBL conform.
|
||||
- Vizualizare printabilă în două formate (standard și compact) prin șabloanele din `templates/`.
|
||||
|
||||
### Formatare
|
||||
- Numere, cantități și sume formatate conform locale-ului browserului, cu conversie automată la punct decimal pentru XML.
|
||||
|
||||
## Instalare și utilizare
|
||||
|
||||
### Opțiunea 1: Server web static
|
||||
Copiați toate fișierele pe serverul web păstrând structura directoarelor și accesați `index.html` prin URL-ul serverului. Funcționează pe orice server static (Apache, nginx, GitHub Pages etc.).
|
||||
|
||||
### Opțiunea 2: Dezvoltare locală cu Node.js
|
||||
```bash
|
||||
node js/server.js
|
||||
```
|
||||
Apoi deschideți http://localhost:3000
|
||||
|
||||
Serverul Node este minimal (fără dependințe) și servește doar fișierele statice.
|
||||
|
||||
### Opțiunea 3: Script `start.sh` (Node + PHP simultan)
|
||||
|
||||
Pentru testare vizuală manuală cu receiver-ul PHP activ:
|
||||
|
||||
```bash
|
||||
./start.sh
|
||||
```
|
||||
|
||||
Pornește în paralel:
|
||||
- Node static server pe `http://localhost:3000` (frontend, fără PHP — simulează GitHub Pages)
|
||||
- PHP built-in server pe `http://localhost:8000` (servește atât frontend cât și `receiver.php`, `test-config.php`)
|
||||
|
||||
**Pentru testarea funcționalităților ANAF (lookup CIF, validare, PDF) deschideți `http://localhost:8000/` — frontend-ul apelează `./receiver.php` pe același origin, deci pe `:3000` (Node nu execută PHP) veți primi 404.** Folosiți `:3000` doar pentru a verifica comportamentul fără PHP.
|
||||
|
||||
Dacă porturile sunt deja ocupate, scriptul oprește procesele existente înainte de pornire. `Ctrl+C` oprește ambele servere. Loguri în `logs/dev-node.log` și `logs/dev-php.log`. Override porturi: `NODE_PORT=4000 PHP_PORT=9000 ./start.sh`.
|
||||
|
||||
### Opțiunea 4: Docker (local sau CI)
|
||||
|
||||
Imaginea include Apache + PHP 8.2 cu `mod_rewrite` și `mod_headers`, identic cu un hosting de producție.
|
||||
|
||||
**Build și run:**
|
||||
```bash
|
||||
docker build -t efactura-generator .
|
||||
docker run --rm -p 8080:80 efactura-generator
|
||||
```
|
||||
Apoi deschideți http://localhost:8080
|
||||
|
||||
**Cu PHP receiver activ** (opțional — doar dacă integrați cu un sistem extern):
|
||||
```bash
|
||||
# Copiați și editați config.json înainte de build
|
||||
cp config.json config.local.json
|
||||
# Editați config.local.json: api_key, allowed_ips
|
||||
|
||||
docker build -t efactura-generator .
|
||||
docker run --rm -p 8080:80 \
|
||||
-v "$(pwd)/config.local.json:/var/www/html/config.json:ro" \
|
||||
efactura-generator
|
||||
```
|
||||
|
||||
**Testare rapidă (fără PHP):**
|
||||
```bash
|
||||
# Nici o dependință — server Node minimal, doar fișiere statice
|
||||
node js/server.js # http://localhost:3000
|
||||
```
|
||||
|
||||
> **Notă:** Directorul `temp/` din container este volatil — se șterge la `docker run --rm`. Dacă vreți persistență, montați un volum: `-v "$(pwd)/temp:/var/www/html/temp"`.
|
||||
|
||||
### Opțiunea 5: Integrare cu sistem extern (PHP)
|
||||
Pentru a primi un XML dintr-o aplicație externă și a-l deschide direct în editor:
|
||||
1. Configurați `config.json` (cheie API, IP-uri permise, durată de viață fișiere temporare).
|
||||
2. Sistemul extern face POST cu conținutul XML către `receiver.php`, transmițând antetul `X-Api-Key`.
|
||||
3. `receiver.php` validează XML-ul și namespace-urile UBL, salvează în `temp/` și returnează numele fișierului.
|
||||
4. Utilizatorul este redirecționat către `index.html?xml=<nume_fisier>`, care încarcă XML-ul automat.
|
||||
5. Fișierul temporar este șters după încărcare; fișierele mai vechi decât `temp_file_lifetime` ore sunt curățate automat.
|
||||
|
||||
Pentru diagnosticare există pagina `test-config.php`.
|
||||
|
||||
## Structura proiectului
|
||||
|
||||
```
|
||||
efactura-generator/
|
||||
├── index.html # Pagina principală
|
||||
├── styles/main.css
|
||||
├── js/
|
||||
│ ├── script.js # Logica completă: parsare/generare XML, formular, totaluri
|
||||
│ ├── formatter.js # Formatare numere/sume/cantități
|
||||
│ ├── print.js # Generare vizualizare printabilă
|
||||
│ └── server.js # Server static minimal pentru dezvoltare locală
|
||||
├── templates/
|
||||
│ ├── print.html # Șablon printare standard
|
||||
│ └── print-compact.html # Șablon printare compact
|
||||
├── receiver.php # Endpoint opțional pentru încărcare XML din sisteme externe
|
||||
├── test-config.php # Pagina de diagnosticare pentru receiver
|
||||
├── config.json # Configurație receiver (API key, IP-uri permise)
|
||||
└── .htaccess.template # Configurație Apache pentru hosting în producție
|
||||
```
|
||||
|
||||
## Licență
|
||||
|
||||
[AGPL-3.0-or-later](LICENSE.md)
|
||||
|
||||
Dacă folosiți acest software, chiar și ca serviciu web, trebuie să:
|
||||
1. Menționați proiectul original.
|
||||
2. Partajați toate modificările făcute.
|
||||
3. Folosiți aceeași licență AGPL-3.
|
||||
|
||||
## Linkuri
|
||||
|
||||
- [Istoric modificări](CHANGELOG.md)
|
||||
- [De făcut](TODO.md)
|
||||
- [www.romfast.ro](https://www.romfast.ro)
|
||||
|
||||
Reference in New Issue
Block a user