CS-16 — Backenda eta integrazioak · Arkitektura eta errendimendua
Argizari Kandelak — esku-kandelen lineako denda
Esku-kandelen marka independente baterako lineako denda hirueleduna (euskara, gaztelania, ingelesa) eta administrazio-panela: katalogoa, saskia, eskaera loteslea, unitateka kudeatutako inbentarioa, bidalketak eta posta elektroniko bidezko jakinarazpenak outbox transakzionalarekin.
- Nire eginkizuna
- Proiektu pertsonala; diseinu eta inplementazio osoa.
- Aldia
- 2026
- Zabalkundea
- Proiektu publikoa
- Teknologiak
- TypeScriptNext.jsReactTailwind CSSPostgreSQLDrizzle ORMNeonBetter Authnext-intlResendCloudflare R2VercelVitestPlaywright
- Azken berrikuspena
- 2026(e)ko azaroaren 13(a)
Testuingurua
Esku-kandelen marka txiki batek linean saldu eta bere ekoizpena kudeatu behar zuen: kandela asko enkarguz egiten dira, ordainketa webetik kanpo egiten da (Bizum edo transferentzia) eta bidalketa ordainketa berretsita dagoenean bakarrik atera daiteke.
Erronkak
- 01Stocka, enkargu bidezko fabrikazioa eta modu mistoa uztartzen dituen unitateka kudeatutako inbentarioa, eskatzean erreserbak eginez.
- 02Fabrikazioa (ordainketaren zain geratzen ez dena) eta bidalketa (zain geratzen dena) bereiztea, bidalketa partzialik gabe.
- 03Jakinarazpen fidagarriak egunean cron bakarra baimentzen duen doako hosting batean.
- 04Hiru hizkuntzatako denda, euskara lehenetsita eta URL lokalizatuekin.
Irtenbidea eta arkitektura
Next.js 16 (App Router) TypeScript zorrotzarekin, PostgreSQL Drizzle ORMrekin eta Better Auth. Bezero anonimoak cookie batean gordetako saskiarekin erosten du, eta saio hasten duenean bere kontuko saskiarekin bateratzen da; checkoutak prezioa, BEZa, bidalketa eta epea kalkulatzen ditu, eta berretsitako eskaera loteslea da eta stocka erreserbatzen du. Zenbaketa-zuzenketek aldez aurretik erakusten dute beren eragina. Ekintza bakoitzak bere jakinarazpena outbox batean idazten du transakzio beraren barruan, eta Resendek bidaltzen du, berrsaiakerekin eta backoffarekin. Administrazio-panelak (eskaerak, ekoizpena, inbentarioa, produktuak, bidalketak, edukia, lege-atala, bezeroak) zerbitzarian egiaztatutako administratzaile-rola eskatzen du.
Erabaki nagusiak
D-01
Jakinarazpenen outboxa datu-basean
Mezu elektronikoa aldaketaren transakzio berean idazteak bermatzen du ez dela abisurik galtzen; hutsegiteak berriro saiatzen dira eta, entregatzen ez badira, administratzailearentzako abisu bat sortzen dute.
D-02
Berrestean stocka erreserbatzen duen eskaera loteslea
Existitzen ez diren unitateak saltzea saihesten du ordainketa beranduago eta webetik kanpo iristen denean.
Konpromisoak
- Vercelen doako planak eguneko cron bakarra baimentzen du; beraz, outboxa erantzun bakoitzaren ondoren, panelera egindako bisita bakoitzean eta eguneko cronean prozesatzen da, ilara dedikatu baten bidez egin beharrean.
Emaitzak
1. fasea inplementatuta (denda, panela, mezu elektronikoak, crona, unitate-, integrazio- eta E2E testak); denda publikoari irekitzea egiteke dago.
Ikasgaiak
Oraindik dokumentatu gabe
Ekintzailetza- eta full-stack garapen-proiektua. Kodea pribatua da. Abian jarri aurreko lege-baldintzen jarraipena (erosketa-baldintzak, pribatutasuna) eta erabakien, arkitekturaren, datu-ereduaren eta eskaera-, inbentario- eta bidalketa-fluxuen dokumentazioa barne hartzen ditu.
Galdetu kasu-azterketa honi buruz
Hemengo galderak «Argizari Kandelak — esku-kandelen lineako denda» kasu-azterketa testuinguru gisa hartuta erantzuten dira.