diff --git a/.gitignore b/.gitignore index 0e7a2f4..4c44d83 100644 --- a/.gitignore +++ b/.gitignore @@ -28,3 +28,9 @@ vectors.db # Generated test artifacts tests/_tmp_*.docx tests/_tmp_*.pdf + +# Foreign trees copied from other projects — do NOT commit +superpowers/ +agents/ +scripts/ +docs/ARCHITECTURE_PROPOSAL.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..d23fad0 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,17 @@ +# tools — Project Configuration + +## Project Info +- **Name**: tools +- **Type**: Single-file Python utility +- **Main file**: `md2pdf.py` — Markdown to PDF converter +- **Language**: Python 3.x +- **Dependencies**: reportlab, markdown, beautifulsoup4, Pygments + +## Project-Specific Notes +- Source files are in root directory (single-file project) +- No test suite yet +- No build step required +- PDF styles: elegant (default), mono + +## Global Configuration +All coding principles, swarm orchestration, and agent configuration are inherited from `~/.claude/CLAUDE.md`. diff --git a/pluxee-todo.md b/pluxee-todo.md new file mode 100644 index 0000000..3ec4c48 --- /dev/null +++ b/pluxee-todo.md @@ -0,0 +1,84 @@ +# To‑do list pentru plata cu cardurile profesorilor (Pluxee / Prima de carieră) + +Împărțit în: +- **A. Client (deținător website)** +- **B. Tu (partea tehnică)** + +--- + +## A. Client – ce are de făcut + +1. **Clarifică programul** + - [ ] Confirmă că se lucrează cu cardurile Pluxee pentru „Prima de carieră didactică / profesională". + - [ ] Verifică la inspectorat / finanțator dacă este impus un anumit procesator (ex. „BT eComm / EuPlătesc", „Netopia" etc.). + +2. **Devino comerciant afiliat Pluxee** + - [ ] Completează formularul pentru comercianți Pluxee: + - https://www.pluxee.ro/beneficii-comercianti/ + - [ ] Specifică clar că vrei să accepți carduri pentru **Prima de carieră didactică / profesională**. + - [ ] Semnează contractul și confirmă că firma este în rețeaua de „locații afiliate". + +3. **Alege procesatorul de plăți** + - [ ] Cere oferte comerciale de la minimum 2–3 procesatori: + - NETOPIA Payments – https://netopia-payments.com + - EuPlătesc – https://www.euplatesc.ro/ + - PayU România – https://romania.payu.com/oferta-companii/ + - (opțional) PlatiOnline – https://plati.online/parteneri/ + - (opțional) BT eCommerce – https://www.bancatransilvania.ro/companii/solutii-de-plata + - [ ] Negociază: + - comision carduri standard, + - comision carduri de beneficii (Pluxee). + - [ ] Semnează contractul cu procesatorul ales. + +4. **Predă către developer tot ce e necesar** + - [ ] Date firmă (CUI, denumire, adresă, email contact). + - [ ] Acces la contul de comerciant al procesatorului. + - [ ] Credențiale tehnice (Merchant ID, API key / signature etc.). + - [ ] Documentația oficială / linkul de „Developers" al procesatorului. + - [ ] Decizia clară: **„Acesta este procesatorul pe care îl folosim"**. + +--- + +## B. Tu (developer) – ce ai de făcut + +1. **Clarificări inițiale** + - [ ] Confirmă cu clientul: + - ce procesator a ales, + - dacă există restricții impuse de inspectorat / finanțator. + - [ ] Verifică că firma este sau va fi **afiliată Pluxee** (altfel nu are sens integrarea pentru aceste carduri). + +2. **Documentație procesator** + - [ ] Ia linkul oficial de documentație: + - NETOPIA – secțiunea „Developers" (Payment API / redirect). + - EuPlătesc – ghid integrator din contul de comerciant. + - PayU – https://developers.payu.com/europe/ + - PlatiOnline – https://wiki.plati.online/index.php/PlatiOnline_API_-_software_developers + - [ ] Notează cerințele lor minime (ce URL‑uri trebuie să expui, ce parametri trebuie trimiși, cum se validează semnătura). + +3. **Integrare la nivel de produs (high‑level)** + - [ ] Decide împreună cu clientul: + - cum se numește metoda de plată în checkout (ex. „Plată online cu cardul (inclusiv card profesor)"). + - în ce punct al flow‑ului se pornește plata (final de checkout). + - [ ] Planifică: + - URL pentru inițiere plată, + - URL pentru return (success/error), + - URL pentru notificare server‑to‑server (IPN / webhook). + +4. **Testare & go‑live** + - [ ] Configurează mediul de **test/sandbox** al procesatorului. + - [ ] Fă tranzacții de test (carduri de test). + - [ ] După mutarea în producție: + - [ ] Fă 1–2 tranzacții reale cu un card Pluxee (sume mici). + - [ ] Confirmă cu clientul că: + - plățile apar în rapoartele procesatorului, + - plățile apar și în interfața Pluxee (dacă e cazul), + - site‑ul activează corect comenzile. + +5. **Monitorizare inițială** + - [ ] Monitorizează primele zile: + - erori de plată, + - rata de succes a tranzacțiilor, + - eventuale refuzuri specifice cardurilor de beneficii, + - [ ] Ajustează împreună cu procesatorul dacă apar probleme de configurare (MCC, limite etc.). + +--- diff --git a/pluxee-todo.pdf b/pluxee-todo.pdf new file mode 100644 index 0000000..a07bf19 Binary files /dev/null and b/pluxee-todo.pdf differ