BakeWise Biga Engine — arkitektura
Motor bakar batek denda bakoitzeko produktu bakoitza ikasten du, labealdi bakoitza planifikatzen du eta faktura bakoitza egiten du — bost dendako obradoretik enpresa anitzeko taldera.
Makina-eskala
Bost zifra, bakoitza produktuan edo bere dokumentazioan irakurgarria: modelo bat produktu eta denda bakoitzeko, hirurogei seinale deklaratu baino gehiago —modelo bakoitzak hamabost eta berrogei arteko gordetzen ditu—, Espainiako bost zerga-araubide despatxatzaile bakar baten atzean, sentsoreen harrera eraikita eta konektatuta, eta hirugarrenen modelo-APIrik gabe inferentzian.
Biltegian irakur daitezkeen bost zifra.
Modeloen subiranotasuna
Ez. Eskariaren iragarpena EBko azpiegitura propioan entrenatzen eta zerbitzatzen da, Prophet-ekin eta bere hondarretara doitutako XGBoost modelo batekin, eta ez dago modelo-hornitzaile bati deirik eskaeraren bidean, ezta beste inon ere. Irteera baimenduen zerrenda kodetik sortzen da, ez da eskuz idazten.
Hirugarrenen modelo-APIrik ez da inferentzian sartzen.
Eskariaren aurreikuspena gure azpiegituran entrenatu eta zerbitzatzen da. Ez dago kanpoko modelo-hornitzaile bati deirik eskaeraren ibilbidean, eta horrek datuen isolamendua arkitekturaren ezaugarri bihurtzen du, ez beste baten baldintzetako klausula bat.
OpenAI, Anthropic edo Googlerekiko mendekotasunik gabe, ezta ostatatutako inferentziarik ere plataformako zerbitzu batean ere. Iragarpena Prophet-ekin dabil, bere hondarren gainean doitutako XGBoost eredu batekin batera, etxean entrenatua eta zerbitzatua; dokumentuen erauzketa, tokiko OCR motor batekin.
Bezero bakoitzaren aurreikuspenak bere historialarekin doitutako modeloetatik datoz, produktuka eta kokapenka. Ezer ez da tenant artean elkartzen, ezta modelo partekatu bat entrenatzeko erabiltzen ere.
Entrenamendua eta zerbitzua EBko azpiegituran gertatzen dira, datuen ondoan. Ez dago kanporako inferentzia-jauzirik, beraz ez dago mugaz gaindiko transferentziarik aitortu edo defendatu beharrik.
Unitate-ekonomia ez da mugitzen modelo-hornitzaile batek bere tarifa aldatzen edo modelo bat kentzen duenean. Ahalmena planifikatzea azpiegitura-erabakia da, ez erosketa-negoziazioa.
Arkitektura hau ez da ustekabean konplexua. Plataforma gobernantza operatibo autonomoaren geruza generiko gisa eraiki zen — okindegia lehen bertikala da. Portagarritasun horizontala (multi-tenant, ML iragarlea, VRP, enpresen hierarkia, betetze modularra) intentziozkoa da eta barneko roadmap-ean dokumentatua. Alboko bertikalak eta hedapen geografikoa kasuz kasu ebaluatzen dira.
Motorra, lau geruzatan
Lau geruza, behetik gora, exekuzioa gertatzen den ordenan: zein seinale sartzen diren, modeloek horietatik zer ikasten duten, agenteek horren gainean zer erabakitzen duten eta amaieran zein lege-betebehar ixten den. Ez da metafora bat: geruza bakoitzak kodea izendatzen du, eta egiteari uko egiten dionari ere izena jartzen dio.
Lau geruza, motor bakarra.
Behetik gora: zein seinale sartzen diren, modeloek zer ikasten duten, agenteek zer erabakitzen duten eta amaieran zein lege-betebehar ixten den. Mapa hau ez da metafora bat — exekuzioaren ordena bera da.
1. geruza · Datuak
Denda bakoitza bere denbora-seriea da. Seinaleak enpresaka ETA kokapenka biltzen dira, beraz hiri bereko bi dendak ez dute inoiz patroia partekatzen.
TPVko salmentak, lerroz lerro
Sinkronizazio-bezeroak Square, Lightspeed, Toast, Revo, eposnow eta Storyous-entzat, eta CSV bidez SFTPn gainerakoentzat. Lerro bakoitza bere BEZ tasarekin dator.
Eguraldia kokapenka
AEMET eta Open-Meteo denda bakoitzaren koordenatuetara ebatzita, ez probintziako hiriburura.
Egutegia eta ekitaldiak
Jaiegun nazionalak, autonomikoak eta udalerrikoak, eskola-egutegia eta hiriko ekitaldiak, benetan nabaritzen dituen kokapenari egotzita.
Dendaren ingurua
OpenStreetMap eta Nominatim gainean detektatutako interes-puntuak — bulegoak, ikastetxeak, geltokiak — kokapen horren modeloaren ezaugarri bihurtuta.
Obradoreko, dendako eta lantegiko sentsoreak
Makinako telemetria etengabea OPC-UA, MQTT eta Modbus bidez, argitaratutako integrazio-kontratu baten aurka: irakurketa bat makina bat da une jakin batean, eta zatitan banatzen duen integrazio batek ezezko esplizitua jasotzen du, datuak isilean galdu beharrean. APPCC tenperatura-erregistroa, hotz-katearen gorabeherak eta enpresa bakoitzeko irenspen-sabai berezia.
Laborategia, panel sentsoriala eta bizitza erabilgarria
Beso konparagarridun entseguak, dastatze-panelak, eskuz edo CSV bidez sartutako laborategiko emaitzak, eta besoz beso ixten diren bizitza erabilgarriaren azterketak. Produktuaren garapenak ikasten duena ekoizpena planifikatzen duen motor berera doa.
2. geruza · Modeloak
Modelo bat produktu eta denda bakoitzeko, eta modelo horrek ematen duena banda kalibratu bat da, ez zifra soil bat. Ez dago zure negozioak antz izan behar duen modelo global bat.
Modelo bat produktu eta denda bakoitzeko
Entrenamendua enpresa, produktu eta kokapenaren arabera egiten da: Prophet-ek sasoiko forma ikasten du eta XGBoost eredu batek Prophet-i ihes egin diona, hirurogei seinale deklaratu baino gehiagoko erregistro baten gainean; produktu bakoitzaren ereduak salmenta-abiaduragatik lekua irabazten duten hamabost eta berrogei artekoak gordetzen ditu. Ezer ez da bezeroen artean elkartzen. Haien ondoan gradient boosting-eko eredu kuantiliko global bat entrenatzen da erronkari gisa: neurtu egiten da, baina inoiz ez du aurreikuspenik zerbitzatzen.
Banda bat, ez zenbaki bat
Aurreikuspen bakoitza banda kalibratu gisa ateratzen da — q10, mediana eta q90 —, inoiz ez zifra bakar gisa. Zabalera eredua entrenatzean neurtzen da: laginetik kanpoko errorearen kuantil konformeak gordetako leiho baten gainean, ereduarekin batera gordeta eta zerbitzatzean aldatu gabe aplikatuta. Banda horrek ahalbidetzen du hurrengo geruzan errorearen kostuaren arabera erabakitzea.
Ikaskuntza jarraitua
Benetako salmenta modelora itzultzen da: errorea aurreikusitakoaren aurka neurtzen da eta berrentrenamendua produktuka programatzen da, ez egutegiaren arabera.
Deriba-zaintza
Eskaria modeloak ikasi zuen banaketatik urruntzen denean, deriba detektatu eta berrentrenatzeko markatzen da, isilean okertzen utzi beharrean.
Ikasitako arauak, ez kodetuak
Euriak edo beroak produktu bakoitzean duen eragina historialetik estimatzen da eta aurreikuspenean bakarrik sartzen da esangura estatistikoa gainditzen badu (p < 0,05). Ez dago eskuz idatzitako ehunekorik.
3. geruza · Agenteak
Hamahiru agente, pasaldi bakarra. Bakoitzak aurrekoak utzitakoa irakurtzen du, eta batek ere ez du idazten zerbitzatzen duen enpresaren gobernu-jarrera errespetatu gabe.
Datuen agentea
Salmentak, stocka eta kanpoko seinaleak jaso eta garbitzen ditu ezer aurreikusi aurretik.
Aurreikuspen-agentea
Eskariaren aurreikuspena produktuka eta kokapenka, planaren horizontean.
Ekoizpen-agentea
Aurreikuspena labealdien programa bihurtzen du: loteak, labearen sekuentzia eta benetako ahalmena.
Lan-fluxuen agentea
Lote bakoitzaren lan-fluxua sortzen du, bere kontrol-puntuekin eta eskatzen dituen gaitasunekin.
Langileen agentea
Txandak proposatzen ditu aurreikusitako ekoizpen-kargaren aurka, txandaz txanda.
Erosketa-agentea
Hornitzaileen eskaerak proposatzen ditu osagai-zerrendatik, eskura dagoen stocketik eta entrega-epeetatik.
Transferentzien agentea
Aholkularitza edo betearazpenaObradore zentraletik denda bakoitzera transferentziak, ibilbide optimizatuak eta mugimendu bakoitzak eskatzen duen dokumentu fiskala: barne-albarana IFK bakarraren barruan, faktura parekatuak edo independenteak IFKak desberdinak direnean.
Sareko planaren agentea
Sareko denda guztien eskaria ekoizpen-plan bakarrean batzen du, dendaz dendako egozpenarekin.
Prezioen agentea
Marjinaren estutzea detektatzen du eta prezioa proposatzen; frankizia-sare batean gomendatu baino ezin du egin.
Analisiaren agentea
Plana zergatik den halakoa azaltzen duen negozio-irakurketa idazten du.
Baliozkotze-agentea
Plan osoaren koherentzia egiaztatzen du pertsona batengana iritsi aurretik.
Jakinarazpen-agentea
Alertak negozioan duten eraginaren, premiaren, jarduteko ahalmenaren eta modeloaren konfiantzaren arabera ordenatzen ditu.
Zentinela-agentea
Pasaldia IFK bakoitzeko osotasun fiskalaren egiaztapenarekin ixten du eta anomaliak zaintzen ditu.
Katean edo filial korporatibo batean plana exekutatzen da. Frankiziatu batekin agente berak gomendatu baino ezin du egin: seme bakoitzak lau bandera ditu — ordutegiak, prezioa, ekoizpen-bolumena eta erosketak — eta frankizia-harremana denean itzalita sortzen dira; datu-baseko murrizketa batek eragozten du seme ez den edozein lerroak itzalita izatea. Erosketa-agenteak iradokizun bat igortzen du eta ezer idatzi aurretik itzultzen da. RD 201/2010 eta akordio bertikalen europar araudia (VBER) eskeman daude idatzita, ez estilo-gida batean.
Agente bakoitzaren jarrera ez da agente bakoitzean berriro eratortzen: ebaluatzaile bakar batek ebazten du lehentasun finko batekin — legea, etengailua, enpresaren politika eta, azkenik, agenteak deklaratzen duena. Legea da nagusi: frankiziatu baten gainean ez da inoiz exekutatzen, politikak dioena diola.
Etengailua — edozein politikaren gainetik
Modeloak deriba badu, TPVaren datuak zaharrak badira edo seinale bat modu anomaloan badabil, motorra proposatzera jaisten da eta zergatia esaten du. Lehentasunean enpresaren politikaren gainetik dago, beraz ez dago itzaltzeko laukitxorik.
Autonomia-politikak produktu-familiaka
Familia bakoitzak bere jarrera deklaratzen du — automatikoa, berrikuspena edo sinadura — eta modu automatikoak erabakia deklaratutako bi mugen barruan dagoen bitartean baino ez du irauten: desbideratzea ehunekotan eta eragina eurotan. Desbideratze ezezagun bat ez da bere kabuz onartzen: berrikuspenera jaisten da. Ebaluatzailea eta bere mugak idatzita eta probatuta daude; familiaka editatzen dituen pantaila konektatzen ari da.
4. geruza · Betetzea
Jurisdikzioa konfigurazioa da: betetzea erregistro bati konektatutako herrialde-pakete bat da, ez produktuan zehar banatutako herrialde bakar baten arauak. Espainia da gaur martxan dagoen paketea, Portugal fakturazioa izan ezik paketatuta dago, eta Frantzia eta Mexiko arkitekturan jasota daude.
| Kontrola | Egoera | Zer esan nahi du zehazki |
|---|---|---|
| Espainia — AEAT | Ekoizpenean | Zenbaketa sekuentziala hutsunerik gabe, BEZa tasaka (% 4, % 10, % 21 eta salbuetsia), albarana faktura aurrean, VeriFactu eta SII. Hori da gaur egun plataformako enpresa espainolek aurkezten dutena. |
| Lurralde foralak — TicketBAI | Abian | Eraikia eta XAdES bidez sinatzen eskema foralaren aurka, homologazio forala abian dagoela. Ez dugu martxan deitzen hala izan arte. |
| Portugal — 0.1.0 paketea | Abian | Geografia, jaiegunak, identitate fiskala eta zerga-tasak paketatuta daude. Fakturazioa, nahita, ez: Portugalen faktura bat igortzeak modu itxian huts egiten du arrazoi izendatu batekin, baliozkotu ez dugun formatu bat inprobisatu beharrean. |
| Frantzia · Mexiko | Arkitektatua, ez zabaldua | Arkitektatuak, koderik gabe: jurisdikzio-katea (EB → herrialdea → lurraldea) eta domeinuz domeinuko interfazeak paperean baliozkotu ziren NF525 eta CFDIren aurka. Bietako bat gehitzea pakete bat idaztea da, ez produktua berridaztea. |
Mekanismoak
Orri honetako lau baieztapen ez dira politika-dokumentuak: kodeak betearazten dituen murrizketak dira. Ogibide bat pakete deklaratu gisa iristen da. Etengailuak edozein politikaren gainetik agintzen du. Frankiziatu batek ezin dio bere buruari datu maisuen gaineko autoritaterik eman. Eta jurisdikzio bat produkzioan dago, gainerakoak arkitektura gisa izendatzen diren bitartean.
Agente Orkestrazioa
Exekuzio bat, hamahiru agente, bakoitzak aurrekoak utzitakoa irakurriz: salmentak eta seinaleak, iragarpena, produkzio-plana, erosketa-eskaerak, izakinak, banaketa-ibilbideak eta negozioaren irakurketa. Bakoitzak egoera-makina gisa jokatzen du —jaso, aztertu, gomendatu, itxaron—, beraz exekuzioa deterministikoa da eta urrats bakoitza auditagarria.
Nola lan egiten duten agenteek elkarrekin
Agente bakoitza domeinu batean espezializatzen da baina besteekin lankidetza egiten du partekatutako datu-geruza eta gertaera-bidezko komunikazio baten bidez.
Adimen Fluxua
Datuak salmenta eta kanpo-iturrietatik aurreikuspenaren bidez fluxuan mugitzen dira, erosketak, ekoizpen-programazioa, inbentario-kudeaketa eta logistika bultzatzen dituena — estrategiak irudi orokorra aztertzen duen bitartean eta sentinel-ek anomaliak monitorizatzen dituen bitartean.
Agente bakoitzak egoera-makina bezala funtzionatzen du: datuak biltzen, ereduak aztertzen, gomendioak sortzen eta giza onarpena itxaroten exekutatu aurretik. Honek portaera determinista eta auditoritza osoa bermatzen du.
Plataforma Arkitektura
Eskaerak eztabaidatu ezin duen lerroz lerroko isolamenduarekin: enpresaren goiburuak sarrerako eskaera guztietatik kentzen dira eta egiaztatutako tokenetik berriro sartzen dira, domeinu bakoitzak bere datu-base zifratua du eta ez dago zerbitzuen arteko atzerriko gakorik. Baimentzea tokeneko hiru ate lokal da, eta gorako deirik gabe.
Eskalatze eta Erresilientziarako Eraikia
Domeinuka isolatutako zerbitzuak EBko erabilgarritasun handiko azpiegituran, enpresa anitzeko ogigintza-eragiketetarako pentsatuak, maila enpresarialeko kontrolekin.
Lerroetan oinarritutako isolamendua enpresa-eremuko goiburuekin, sarrerako eskaeratik kendu eta egiaztatutako tokenetik berriro injektatzen direnak. Zerbitzu arteko kanpo-gakorik gabe. Domeinu bakoitzak bere datu-base isolatua du, geldirik enkriptatuta: zerbitzu batek ezin ditu beste baten taulak irakurri, ezta enpresa batek beste baten lerroak ere.
Tokenak maizterra, rola, saila eta baimen-mapa daramatza, beraz atebideak ez du gorako deirik egiten eskaeraren bidean. Hiru egiaztapen lokal eskaera bakoitzean: sinadura eta token motaren politika, errebokazioa eta claim-en freskotasuna. Errebokatutako saio bat baztertu egiten da tokena iraungi ez bada ere.
SAML 2.0 bidezko saio-hasiera bakarra zuen identitate-hornitzailearen aurka, eta erabiltzaileen altak eta bajak SCIM 2.0 bidez sinkronizatuta zuen direktoriotik. Nork lan egiten duen zuekin zuen langile-sistemak erabakitzen du; guk obeditu eta erregistratu egiten dugu.
Guraso-seme maizterrak bide materializatuko kontsultekin, beraz azpizuhaitz bat irakurtzeak ez du inoiz kontsulta errekurtsiborik behar. Guraso batek seme federatu baten datu operatiboak irakurtzea seme horretako baimen esplizitu baten menpe dago — rolak berak ez du inoiz ematen, eta seme batean sartzeak ez du sareko gaitasunik berekin eramaten.
Plataforma zerbitzari bakar baten ordez EBko datu-zentro bateko hainbat makina independenteren gainean exekutatzen da, datu-basearen geruza haien artean errepikatuta. Orkestrazioa auto-konpontzailea da: makina bat galtzen denean, zeraman lana automatikoki birprogramatzen da.
Azpiegitura eta aplikazioa kodean deklaratzen dira. Aldaketa bakoitza bertsionatuta dago, aplikatu aurretik berrikusita eta ondoren auditagarria; ez da ezer eskuz aldatzen martxan dagoen makina batean, beraz plataformaren egoera beti irakurri, alderatu eta atzera bota daiteke.
Harpidetza-middlewareak planaren mugak atebidean aplikatzen ditu URLaren formatik bertatik, beraz zerbitzu batek ere ezin ditu ibilbideak definituz saihestu. Bi maila: Katea eta Taldea, eta bertikal industriala Taldea mailaren gainean.
Konektoreak
Zuen taldeak sortu eta ezeztatzen duen irakurketa-soileko zerbitzu-kontu batekin, edo irteerako konexioak baino irekitzen ez dituen agente batekin, zuen suebakia itxita jarraitzeko. Sartzen den lerro bakoitzak bere jatorria, kanpoko identifikatzailea eta bertan noiz aldatu zen gordetzen ditu. Datu horietarako tratamendu-eragile gara, kontratuarekin.
Nola irakurtzen ditugun zuen sistemak.
Ebaluatzaile teknikoarentzat: zer eskatzen dugun zehazki, zer ez dugun irekitzen eta sartzen den datu bakoitzari buruz zer geratzen den erregistratuta.
Zerbitzu-kontu bat, salmentak, erosketak, stocka eta produktu-maisua irakurtzeko baimenekin. Zuen taldeak sortua eta indargabetzeko modukoa. Inoiz ez pertsona baten kredentzialak.
Bertako sistemetarako, irteerako konexioak baino egiten ez dituen agente bat: bertsionatutako kontsulta-profilekin erauzten du eta HTTPS bidez igotzen. Zuen suebakia ez da irekitzen. Alternatibak: zuek fitxategiak uzten dituzuen SFTP bat, edo irteerako tunel bat.
Sartzen den lerro bakoitzak gordetzen du nondik etorri zen, zein kanpoko identifikatzailerekin eta noiz eguneratu zen jatorrian. Berriz prozesatzeko eta auditatzeko modukoa.
Zuen sistemetatik datozen datuetarako eragile gara: bezeroko DPA bat, lehenetsitako minimizazioa erauzketa-profiletan, EBn ostatatzea eta enpresaka ezabatzea eskaeraren arabera.
Segurtasuna eta Betetze
Bederatzi kontrol, bakoitza bestela norbaitek eskuz itxiko lukeen betebehar bat: HACCP erregistroa eta trazabilitatea, DBEO tratamendu-eragile gisa, jurisdikzioko zerga-erregistroak, gizakiaren onarpena exekutatu aurretik, auditoria-erregistro kateatua, EBko egoitza, makinen arteko jarraitutasuna, zifratzea igorpenean eta atsedenean, eta kanpoko kopiak berreskuratze-bide idatziarekin.
Konfiantza Maila Bakoitzean
Oinarritik eraikia jurisdikzio bakoitzeko arau-eskakizunetarako — pakete bat herrialdeko, Espainia lehena martxan.
Ziurtagirien egoera
Bat ere ez oraindik. Ez da SOC 2 auditoriarik egin, eta ez dago hirugarren independente baten sartze-probarik ere. Dagoena lerroz lerro dago behean: EBko egoitza, tratamendu-enkarguaren kontratua, enpresako saio-hasiera bakarra, gauero egiaztatutako auditoria-erregistro kateatua, eta bidean dauden bi lerroak.
Zer dugu eta zer ez.
Taula hau inork bilatzen ibili behar ez izateko dago. Ez dugun ziurtagiri bat hemen esaten da, dagokion lerroan, eta ez oin-ohar batean.
| Kontrola | Egoera | Zer esan nahi du zehazki |
|---|---|---|
| Datuen egoitza EBn | Ekoizpenean | Prozesamendua eta biltegiratzea EBko datu-zentroetan, guk geuk kudeatzen dugun azpiegituraren gainean. Kanporako inferentzia-jauzirik gabe. |
| DBEO — tratamenduaren eragilea | Ekoizpenean | Bezeroko DPA bat, lehenetsitako minimizazioa erauzketa-profiletan eta enpresaka ezabatzea eskaeraren arabera. |
| Enpresa-identitatea (SSO eta hornikuntza) | Ekoizpenean | SAML 2.0 bidezko saio-hasiera bakarra eta erabiltzaileen alta eta baja automatikoa SCIM 2.0 bidez, Talde planean eskuragarri. Identitate-erantzunak sinaduran, hartzailean, entzulegoan eta denbora-tartean balidatzen dira, eta ez dira inoiz bigarrenez onartzen. |
| Hash-katearekin auditoria-aztarna | Ekoizpenean | CREATE, UPDATE, DELETE eta EXPORT bakoitza erregistro osoa hartzen duen hash batekin kateatzen da, eta prozesu automatiko batek katea gauero ibiltzen du, erregistro bakoitza berriro kalkulatuz eta kate-maila bat bat ez badator abisatuz. Osotasuna katearen gainean egiaztatzen da, ez esportatutako fitxategiaren gainean. |
| Erabilgarritasun handia | Ekoizpenean | Plataforma hainbat makina independenteren gainean exekutatzen da, datu-basearen geruza errepikatuta, eta orkestrazioak automatikoki birprogramatzen du lana haietako bat galtzen denean. |
| Segurtasun-kopiak eta berreskuratze-simulakroak | Abian | Kopiak automatikoak dira eta kanpoan gordetzen dira, eta biltegi bakoitzak berreskuratze-prozedura dokumentatu bat du. Programatutako berreskuratze-simulakroak ez daude oraindik martxan; lehena kronometratu eta erregistratzen den egunean pasatuko dugu errenkada hau martxan egoerara. |
| Espainiako betebehar fiskala | Abian | VeriFactu eta SII ekoizpenean. TicketBAI eraikia eta XAdES bidez sinatzen, homologazio forala abian. |
| SOC 2 Type 1 | Ez lortuta | Ziurtagiri gisa ez lortuta: ez da Type 1 auditoriarik egin eta ez dago partekatzeko txostenik. Gure eragiketa-praktikak SOC 2ren Trust Services Criteria irizpideen inguruan eraikita daude — segurtasuna, erabilgarritasuna eta konfidentzialtasuna — eta ziurtatuta hitza txosten bat existitzen den egunean bakarrik erabiliko dugu. |
30 minutuko elkarrizketa teknikoa motorra eraikitzen dutenekin. NDA lehen deia baino lehen, eskatuz gero.
Ireki motor bera okindegi bizi batean
Eskatu elkarrizketa