manual-roa/CLAUDE.md

Manual ROA

Manualele de utilizare ale aplicatiilor ROA. Remote: git@gitea.romfast.ro:romfast/manual-roa.git (branch main). Manualele vechi (.doc/.odt + poze*) sunt doar arhiva; cel intretinut activ e ROAAUTO.

Manual ROAAUTO — 4 formate, mereu sincronizate

Fisier	Rol
manual_ROAAUTO.docx	sursa pentru PDF
manual_ROAAUTO.pdf	generat din docx, livrat clientilor
manual_ROAAUTO.md	acelasi continut, cu diacritice
manual_ROAAUTO.txt	acelasi continut, fara diacritice, latime 80, separatori =/-

Orice modificare de continut se face in toate 4.

Versiune si istoric (obligatoriu la fiecare modificare)

• Sub titlu: v. DD.MM.YYYY (data zilei modificarii); in docx e paragraf italic, 10pt.
• La sfarsit, sectiunea Istoric versiuni, inainte de subsolul „Manual generat…”: un rand per versiune, cea mai noua sus, scurt: v. DD.MM.YYYY — ce s-a adaugat/schimbat.

Flux de lucru

1. Editeaza docx cu python-docx: cloneaza (copy.deepcopy(p._p)) un paragraf existent cu stilul dorit (titlu de sectiune, rand cu run bold + run normal) si schimba doar textul — docx-ul nu foloseste stiluri Word, formatarea e pe run-uri.
2. Editeaza md si txt.
3. Regenereaza PDF-ul: "/c/Program Files/LibreOffice/program/soffice.exe" --headless --convert-to pdf manual_ROAAUTO.docx --outdir .
4. Verifica vizual: pdftoppm -f N -l N -r 60 -png manual_ROAAUTO.pdf <scratchpad>/pN, apoi citeste imaginea.
5. Commit + push, apoi copiaza PDF-ul in aplicatie: cp manual_ROAAUTO.pdf /d/ROA/ROAAUTO/Help/manual_ROAAUTO.pdf.

Capcane de mediu

• Scripturile Python se scriu intr-un fisier in scratchpad si se ruleaza cu python fisier.py. python - <<EOF poate esua tacut (shim pyenv), iar python - fara stdin blocheaza shell-ul.
• Consola e cp1252: print cu diacritice da UnicodeEncodeError. Nu afisa textul cu diacritice sau foloseste .encode('ascii','replace').
• pdftotext pierde diacriticele la afisare. E doar o problema de afisare, PDF-ul e corect.
• Versiunea anterioara a PDF-ului (pentru diff la istoric) e cea din D:\ROA\ROAAUTO\Help\ inainte de copiere.