Mis on CRUD? Loo, loe, uuenda, kustuta selgitatud

CRUD tähendab loomist, lugemist, uuendamist ja kustutamist – nelja põhilist asja, mida rakendus salvestatud andmetega teeb. Uue kliendi lisamine on loomine, kliendiloendi vaatamine on lugemine, tema telefoninumbri muutmine on uuendamine ja tema eemaldamine on kustutamine. Enamik äriliselt kasutatavaid rakendusi – CRM-id, broneerimissüsteemid, laojälgijad, administraatoripaneelid – on suures osas CRUD, millele on lisatud reeglid ja hea paigutus.

Miks see AI-ga ehitamisel oluline on

CRUD on sõnavara, mis muudab ebamäärase rakendusidee täpseks päringuks. „Rakendus meie tarnijate haldamiseks" jätab AI-le oletamiseks ruumi. „Loo, loetle, muuda ja kustuta tarnijad, nende väljadega" ütleb täpselt, milliseid ekraane, andmebaasitoiminguid ja serveriteid ehitada.

See annab ka testimise kontrollnimekirja. Iga kirjete liigi puhul saad esitada neli küsimust: kas ma saan ühe lisada, neid näha, ühte muuta ja ühe eemaldada – ning kas ainult õiged inimesed saavad iga toimingu teha? Üllatavalt paljud AI-ga ehitatud rakendused suudavad luua kirjeid, aga ei saa neid muuta, või lasevad kellelgi kustutada mida tahes.

Igapäevane võrdlus: retseptikaartide kast

Kujuta ette kastikest retseptikaarte köögiriiuli peal.

• Loo: kirjuta uus kaart ja pane see kasti.
• Loe: sirvi kasti või võta välja lasanjeretsept.
• Uuenda: kriipsuta maha „200 g juustu" ja kirjuta „250 g".
• Kustuta: võta kaart välja ja viska ära.

Lisa nüüd reeglid: ainult peakokk tohib kaarte ära visata, iga kaardil peab olema pealkiri ja keegi ei tohi kaks kaarti sama nimega panna. See on CRUD-rakendus koos valideerimise ja õigustega – ja just selline on enamik päris rakendusi.

Kuidas CRUD igas kihis ilmub

Iga toiming esineb ekraanil, serveris ja andmebaasis. Nende nägemine kõrvuti selgitab palju sellest, kuidas rakendusi ehitatakse.

Ekraan on esiliides, API päring on see, kuidas esiliides räägib tagaotsaga, ja SQL on see, kuidas tagaots räägib andmebaasiga. Kui need sõnad on uued, vaata mis on API ja mis on andmebaas.

Näide: seadmete laenutusjälgija

Kooli meediaosakond laenutab kaameraid ja mikrofone õpilastele ning kaotab pidevalt neist ülevaate. Nad tahavad lihtsat rakendust.

Kirjed. Kahte liiki asju: seadmed (nimi, tüüp, seerianumber, seisukord) ja laenutused (milline seade, milline õpilane, väljastamise kuupäev, tagastustähtaeg, tagastamise kuupäev).

CRUD seadmetele:

• Loo: töötajad lisavad uue kaamera koos seerianumbriga. Reegel: seerianumbrid peavad olema kordumatud.
• Loe: kõigi seadmete loend, mida saab filtreerida tüübi ja „saadaval kohe" järgi; detailvaade, mis näitab ühe eseme laenutusajalugu.
• Uuenda: muuda seisukord väärtuseks „vajab remonti".
• Kustuta: tavaliselt mitte päris kustutamine. Kui kaamera, millel on 30 varasemat laenutust, kustutatakse, kaotavad laenutuskirjed oma seose. Selle asemel märgi see „pensionile" – nii kaob see saadaolevate loendist, aga ajalugu jääb alles. Seda nimetatakse pehmeks kustutamiseks (soft delete).

CRUD laenutustele:

• Loo: väljasta seade õpilasele. Reegel: juba laenutuses olevat eset ei saa uuesti välja anda.
• Loe: „tähtaega ületanud laenutused" – loend, kus tagastustähtaeg on möödas ja tagastuskuupäev puudub.
• Uuenda: kirjuta tagastuskuupäev, kui ese tagastatakse.
• Kustuta: ainult töötajad, valesti sisestatud laenutuste jaoks.

Õigused. Õpilased saavad lugeda, mis on saadaval; ainult töötajad saavad luua, uuendada või kustutada. Need kontrollid töötavad serveris, mitte ainult nuppe peites.

See ongi kogu rakendus. Huvitavad osad – topelt-laenutuse puudumine, tähtaega ületanud nimekiri, ajalugu iga eseme kohta – on reeglid ja päringud lihtsa CRUD peal.

Põhimõisted

• Kirje (rida): üks üksus, näiteks üks tarnija või üks laenutus.
• Olem / ressurss: kirjete liik, näiteks „tarnijad". Igal neist on tavaliselt oma tabel ja oma CRUD-ekraanide komplekt.
• Valideerimine: sisendi kontrollid – kohustuslikud väljad, õige e-posti aadress, positiivne kogus. Tee seda vormis mugavuse pärast ja serveris turvalisuse pärast.
• Pehme kustutamine: kirje märkimine kustutatuks või arhiveerituks selle eemaldamise asemel, et ajalugu ja seosed säiliksid.
• Lehekülgedeks jaotamine (pagination): pika loendi näitamine lehekaupa, et rakendus püsiks kiire.
• Auditilogi: arvestus selle kohta, kes mida lõi, muutis või kustutas, ja millal.
• Administraatoripaneel: CRUD-ekraanide komplekt, millega töötajad rakenduse andmeid haldavad.

Levinud vead ja väärarusaamad

• Ühe neljast unustamine. Rakendused tuleb sageli välja loomise ja lugemisega, aga ilma muutmiseta, nii et iga kirjavea parandamiseks tuleb kustutada ja uuesti sisestada. Kontrolli kõiki nelja iga olemi puhul.
• Kustutamised, mis asju katkestavad. Kliendi kustutamine, kellel on arved, võib jätta arved ilma seoseta või kustutada ajaloo. Otsusta olemi kaupa: blokeeri kustutamine, tee pehme kustutamine või kustuta ka seotud kirjed.
• Õigused ainult liideses. Kustuta-nupu peitmine ei takista kedagi saatmast DELETE päringut. Server peab kontrollima, kes küsib.
• Uuendamine ID järgi ilma omanikku kontrollimata. Kui kasutaja A saab muuta /api/notes/42, muutes URL-is numbrit, võib ta muuta kasutaja B märkmet. Iga uuendus ja kustutamine peab kinnitama, et kirje kuulub päringu tegijale.
• Kustutamisel kinnituseta. Üks väär klõps ei tohi andmeid hävitada. Lisa kinnitussamm või tagasivõtmise võimalus.
• „CRUD tähendab lihtsat, seega ei ole seda väärt ehitada." Paljud väärtuslikud tooted on CRUD-rakendused, mis sobivad töövooga paremini kui üldine tööriist.

Mida küsida oma AI ehitajalt

Kasuta seda mustrit iga olemi kohta, ühe kaupa:

Loo tarnijate funktsioon loendi, loomise, muutmise ja kustutamisega. Väljad: nimi (kohustuslik), kontakt-e-post (korrektne e-post), telefon, kategooria (üks: toit, pakend, puhastusvahend), märkmed. Loendis otsing nime järgi ja filter kategooria järgi, 20 kirjet lehel. Enne kustutamist küsi kinnitust; kui tarnijal on tellimusi, arhiveeri kustutamise asemel. Ainult sisse logitud töötajad saavad luua, muuta või arhiveerida – jõusta see serveris.

Seejärel testi kõiki nelja toimingut, nii lubatud kasutajana kui ka kellenagi, kellel ei tohiks juurdepääsu olla. Kui üks olem töötab, lisa järgmine. Kuidas ehitada sisemist tööriista näitab, kuidas CRUD-ekraanid muutuvad täisväärtuslikuks administraatorirakenduseks, ja mis on Postgres selgitab andmebaasi, millel enamik neist rakendustest asub.

CRUD-rakendused Mythexis

CRUD-rakendused on üks asi, mida AI rakenduste ehitajad teevad kõige paremini, ja Mythex pole erand. Küsi vestluses olemit ja selle välju ning Mythex lisab projektile Postgres-andmebaasi, loob tabeli ja ehitab loendi-, vormi- ja detailvaated elavasse eelvaatesse; seejärel saad käivitada /test, et voogu kontrollida. Dokumentatsioonis on CRUD-rakenduse retsept algusprompti ja sisemise tööriista ehitaja ning armatuurlaua mallid on head alguspunktid.

Küsimused