Înapoi la portofoliu
PlatformăClient real

Formular 230

Platformă web pentru colectarea declarațiilor Formular 230 prin formular public integrabil, semnătură olografă, acord GDPR și procesare în back-office prin PDF, CSV, XML, arhive ZIP și borderouri ANAF.

Formular 230

Stack principal

PHP 8.2+
Laravel 12
Eloquent ORM
Livewire 3
BladeLaravel BreezeLaravel QueueLaravel MailLaravel CacheTCPDITCPDFJavaDUKIntegratorZipArchiveTailwind CSS 3Alpine.jsVite 6AxiosPM2GitHub Actions

Provocarea

Provocarea principală a fost transformarea unui proces cu date personale, semnături și documente fiscale într-un flux coerent de la formularul public până la pachetele administrative. Sistemul trebuia să păstreze separarea datelor pe organizații, să evite includerea repetată a contribuabililor în loturile deja finalizate, să genereze documente în formatele cerute și să mute operațiile mai grele — PDF, XML, CSV, ZIP și borderou — în afara requestului web.

Soluția

Soluția folosește un monolit Laravel 12 cu Livewire 3 și Blade pentru back-office și un formular public responsive care trimite datele către un endpoint API. Eloquent modelează organizațiile, contribuabilii, PDF-urile, exporturile și arhivele, iar unicitatea CNP-ului este impusă per organizație printr-o constrângere compusă. Joburile queued generează PDF-uri cu TCPDI/TCPDF, CSV-uri, XML-uri și arhive ZIP, păstrând starea operației în baza de date. Pentru borderoul ANAF, aplicația construiește XML-ul și orchestrează DUKIntegrator printr-o comandă Artisan și Java, expunând în UI atât fișierele rezultate, cât și erorile de validare.

Complexitate notabilă

Formular 230 digitalizează traseul dintre persoana care completează declarația pentru redirecționarea a 3,5% și echipa organizației care pregătește documentele pentru procesare. Fiecare organizație are propriile date juridice și bancare, poate primi un URL de formular public integrabil prin iframe și poate păstra contribuabilii separat prin association_id. Formularul colectează datele de identificare și domiciliu, opțiunea pentru un an sau doi ani, semnătura desenată din browser și consimțământul pentru prelucrarea datelor.

La trimitere, backend-ul validează câmpurile, verifică unicitatea CNP-ului în cadrul organizației și folosește un serviciu extern pentru validarea suplimentară a CNP-ului. Înregistrarea este apoi persistată ca formular semnat, iar un job din coadă generează declarația PDF peste un template oficial, completează datele contribuabilului și organizației, inserează semnătura și poate trimite documentul rezultat prin email către contribuabil.

Back-office-ul Laravel Livewire oferă dashboard, selecție de organizație, statistici pentru formulare semnate și perioada de redirecționare, urmărirea sursei din care a fost încărcat iframe-ul, listare paginată și filtrată a contribuabililor, plus administrarea organizațiilor și utilizatorilor. Rolurile user, super_user și admin și relația many-to-many dintre utilizatori și organizații modelează accesul operațional, iar interfața sincronizează organizația selectată între componentele Livewire.

Procesarea administrativă este mutată în joburi de coadă. Aplicația poate genera exporturi CSV, XML-uri cu structura folosită pentru Formular 230, arhive ZIP care reunesc documentele aferente unui lot și borderouri XML. Pentru borderou, un command Artisan execută DUKIntegrator prin Java, păstrează rezultatul PDF când acesta este produs și salvează erorile de validare pentru consultare în interfață. Un indicator separat permite marcarea manuală a borderoului ca inclus în e-Guvernare; codul nu demonstrează o integrare API directă cu platforma de depunere.

Aplicația folosește storage-ul Laravel pentru documentele generate, cache temporar pentru starea joburilor PDF și un worker de queue administrat prin PM2. Repository-ul include un workflow GitHub Actions pornit manual, care se conectează prin SSH la server, rulează migrările, build-ul Vite, restartează workerul și execută optimizările Laravel.

Rezultate cheie

  • Formular public responsive integrabil prin iframe pentru fiecare organizație
  • Colectarea datelor de identificare și domiciliu, a opțiunii de redirecționare pentru unul sau doi ani și a acordului GDPR
  • Capturarea semnăturii olografe direct în browser și persistarea ei pentru documentul generat
  • Unicitate CNP la nivel de organizație și validare suplimentară printr-un serviciu extern
  • Generarea asincronă a Formularului 230 în PDF peste un template și păstrarea istoricului documentelor generate
  • Trimiterea prin email a PDF-ului generat către contribuabil
  • Dashboard per organizație cu totaluri, formulare semnate, perioade de redirecționare și statistici pe sursa iframe-ului
  • Listă paginată de contribuabili cu căutare și filtre după status, județ și perioadă
  • Export CSV asincron cu filtrele operaționale păstrate împreună cu istoricul exportului
  • Generare XML și evidența loturilor de contribuabili deja incluse în arhive finalizate
  • Arhive ZIP ANAF care orchestrează XML-ul, PDF-urile și CSV-ul aferent aceluiași lot
  • Generare de borderou XML și procesare prin DUKIntegrator/Java, cu PDF și erori de validare păstrate în sistem
  • Tracking manual pentru includerea borderourilor în e-Guvernare
  • Administrarea mai multor organizații și asocierea utilizatorilor la organizațiile disponibile
  • Roluri user, super_user și admin pentru separarea principalelor operațiuni de administrare
  • Worker de queue administrat prin PM2 și workflow GitHub Actions pentru deployment manual prin SSH

Proiecte asemănătoare

Vrei ceva similar?

Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.