Documentație NextERP

Lucrul cu NextERP · Articolul 01

Project Workflow

Se aplică pe Odoo 19 · 20

Procesul standard prin care o cerere de dezvoltare trece de la helpdesk ticket la producție. Acoperă deschiderea ticket-ului, documentarea specificațiilor în ticket, conversia în task de proiect, estimarea, aprobarea, dezvoltarea, testarea în runbot și documentarea finală.

🎫 Pasul 1 — Helpdesk ticket (Category: Development)

Orice cerere de dezvoltare începe printr-un helpdesk ticket deschis de client în portal (vezi articolul „Procedură suport"). În formular, se selectează:

  • Category = Development
  • Priority, Mediu, Version — completate normal
  • Subject — concis: ce funcționalitate / schimbare de flux se cere
  • Description — descrierea inițială (vezi secțiunea „Documentarea specificației" mai jos)

Ticket-ul devine locul în care se documentează specificația. Toate clarificările, deciziile, atașamentele rămân pe ticket pentru audit.

📝 Pasul 2 — Documentarea specificației într-un articol Knowledge

În descrierea ticket-ului Helpdesk se adaugă un link către un articol Knowledge dedicat, în care se documentează specificația completă. Ticket-ul Helpdesk rămâne locul oficial al cererii (audit, comunicare, SLA) — articolul Knowledge e locul de lucru al specificației.

  1. Crearea articolului — Project Manager-ul creează un articol nou în Knowledge (sub un workspace dedicat de specificații pentru proiectul / clientul respectiv).
  2. Încărcarea template-ului — în articol se inserează template-ul „Software Specification" (din butonul Insert template al editorului Knowledge), care vine deja structurat cu cele 3 secțiuni obligatorii.
  3. Adăugarea link-ului în ticket — link-ul către articolul Knowledge se pune în descrierea ticket-ului Helpdesk (sau ca primul mesaj în chatter), pentru ca toate părțile implicate să-l găsească.
  4. Documentarea modificărilor — în articol se documentează iterativ toate modificările necesare, completând cele 3 secțiuni:
    • Description Background — importanța în fluxurile existente (de ce e necesar, ce problemă rezolvă).
    • Functional Description — adăugarea / schimbarea fluxului cu pași noi (din punct de vedere business).
    • Technical Specification — detalii tehnice ale codului care trebuie adăugat / modificat (modele, câmpuri, override-uri, view-uri).

Detalii despre fiecare secțiune și exemple complete: https://www.nexterp.ro/specification-example

👥 Cine completează ce

  • Description Background + Functional Description — completate de Project Manager, fie din partea clientului, fie alocat de NextERP. Discuțiile cu clientul se poartă pe ticket-ul Helpdesk; rezultatul (textul finalizat) ajunge în articolul Knowledge.
  • Technical Specification — completată de developer-ul asignat în articolul Knowledge, după ce primele 2 secțiuni sunt finalizate.

Cât timp articolul Knowledge nu e complet (toate 3 secțiuni acoperite), ticket-ul Helpdesk rămâne în status On Hold. După finalizarea documentării, se trece la Pasul 3.

🔄 Pasul 3 — Conversia ticket → task de proiect

După ce specificația e completă (toate 3 secțiuni acoperite și aprobate de client), echipa de suport convertește ticket-ul în task în proiectul de implementare aferent:

  • Task-ul nou copiază descrierea specificației din ticket.
  • Task-ul are câmp helpdesk_ticket_id care trimite înapoi la ticket-ul original.
  • Ticket-ul Helpdesk trece în On Hold cât timp dezvoltarea e în lucru.
  • Atașamentele relevante se copiază pe task.

Restul fluxului (estimare, aprobare, implementare, testing, done) se desfășoară pe task-ul de proiect, NU pe ticket-ul original.

💰 Facturare timp specificație + analiză tehnică

  • Dacă PM-ul e alocat de NextERP, orele necesare pentru preluarea specificațiilor și detalierea (pe ticket-ul Helpdesk) se facturează la rate-ul din contract, la tipul de serviciu „Odoo Implementation Services".
  • Timpul alocat analizei tehnice (Technical Specification, completată de developer pe ticket) se facturează la același rate.

⏱️ Estimare timp implementare

După completarea specificațiilor tehnice, developer-ul estimează timpul total. Estimarea include:

  • Detalierea task-ului
  • Analiza tehnică
  • Dezvoltarea efectivă a codului
  • Verificarea / testarea codului
  • Elaborarea documentației

✅ Aprobare estimare

După finalizarea estimării, ea e trimisă către client pentru aprobare. Veți primi notificare prin email pentru fiecare ticket care necesită aprobare. Aprobarea se face din portalul clientului, pe fiecare task separat.

Total timp facturat = valoarea aprobată. Nu poate fi modificată ulterior nici de Project Manager, nici de developer.

După aprobare, task-ul trece automat în status „in progress" și un developer îl preia pentru implementare. În această fază, developer-ul actualizează datele de planificare și deadline-ul de dezvoltare.

🚫 Anulare după estimare

Dacă, după primirea estimării, decideți să nu mai implementați task-ul, îl puteți închide direct din portal. Timpul deja logat pentru detaliere și analiză se facturează la rate-ul din contract (Odoo Implementation Services).

🧪 Aprobare testare ticket

După finalizarea implementării, ticket-ul trece în status „testing". Clientul aprobă finalizarea după ce a testat în:

  • Mediul propriu de test (dacă există), SAU
  • Mediul nostru de runbot — vezi articolul dedicat „Runbot — mediul de testare" pentru acces, conectare și acțiunile disponibile per build.

Pentru bug-uri minore detectate la testare, reasignați task-ul la developer pentru corecții.

🏁 Done → documentație → producție

După ce ați testat și aprobat task-ul din portal, acesta trece în status „done". În acest status:

  1. Se elaborează documentația funcțională — text într-un document specific sau înregistrare video.
  2. După elaborarea documentației, task-ul poate fi implementat și în mediul de producție.

📞 Contact

Documentație realizată de echipa NextERP.