Capitol activStudiu de caz
Studiu de caz / 04
O aplicație colaborativă de management al sarcinilor cu echipe, sincronizare în timp real, notificări live și control al accesului bazat pe roluri - construită cu Next.js 15 și Convex pentru a explora subscripțiile reactive la baza de date și pattern-urile de comunicare event-driven.
01 / Comportamentul sistemului
Un mecanism tehnic specific proiectului, bazat pe arhitectura și contextul de implementare înregistrate.
TaskFlow este o aplicație colaborativă de management al sarcinilor concepută ca o explorare aprofundată a capabilităților real-time ale Convex. Fiecare apel useQuery este o subscripție live care re-randează automat când datele se schimbă - fără cod WebSocket, fără pub/sub, fără invalidare de cache.
Backend-ul Convex este organizat ca module de servicii izolate logic cu granițe clare: taskService (CRUD, tranziții de stare, filtrare), userService (profiluri, validare unicitate email), teamService (management echipe, roluri de membri, ștergeri în cascadă), commentService (comentarii ierarhice per sarcină), notificationService (alerte pentru atribuiri și completări), și un eventBus tipizat pentru comunicarea între servicii.
03 / Înregistrarea arhitecturii
O interpretare structurată a arhitecturii înregistrate pentru acest proiect.
Frontend-ul folosește Next.js 15 cu App Router. Fiecare componentă care necesită date folosește hook-ul useQuery din Convex, care creează o subscripție la datele respective - când orice mutație modifică tabelele relevante, query-ul se reevaluează pe server și transmite noul rezultat fiecărui client conectat.
Backend-ul Convex urmează o structură orientată pe servicii: fiecare modul de serviciu (task, user, team, comment, notification) își exportă propriile tipuri și helperi privați, iar fișierele publice reexportă totul ca o fațadă pentru frontend.
Comunicarea între servicii are loc inline în cadrul mutațiilor - când o sarcină este atribuită, mutația verifică dacă persoana atribuită diferă de creator și inserează direct o notificare. Query-ul useQuery al serviciului de notificări o preia instantaneu.
Schema definește cinci tabele cu indexuri compuse alese cu grijă - indexul compus teamMembers(teamId, userId) este esențial pentru verificarea apartenenței la echipă, care altfel ar scana întregul tabel.
Regulile de business includ ștergeri în cascadă cu curățare între servicii (ștergerea unei echipe elimină toți membrii, apoi sarcinile, apoi echipa în sine), validare de unicitate a emailului la nivel de mutație și verificări de dependență înainte de operațiuni distructive.
05 / Aspecte selectate
Deciziile și fluxurile cu cea mai mare valoare explicativă.
06 / Metrici susținute
TypeScript, Next.js, React, Convex, Convex Auth, Tailwind CSS, Radix UI
Vezi repository-ul sursă