Leagan 1.0.0-alpha.1is déanaí
Caibidil 2.1
Ailtireacht
Cad is leis gach seirbhís sa chairt Nexus agus cé na stórais atá faoina bhun, ansin na rialacha a choinníonn le chéile iad, ó aitheantas idir seirbhísí go dtí an cosán a thógann gach glao samhla.
d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

Nuair a chríochnaigh Tomás Reilly an chéad suiteáil ag Harrow Port Authority, thaispeáin kubectl -n nexus get pods deich Deployment agus seacht StatefulSet, mar aon le trí CronJob. Bhí na Jobs imirce a thóg an bunachar sonraí imithe cheana féin, toisc go scriosann gach ceann é féin nuair a éiríonn leis. Is é an liosta sin an t-ardán ar fad. Foghlaim é, mar go dtosaíonn formhór cheisteanna an dara lá le "cé acu seo a bhfuil úinéireacht aige air sin?"
Freagraíonn an chaibidil seo an cheist sin do gach cuid, leanann sí aon iarratas amháin tríothu, agus ansin clúdaíonn sí na rialacha a ngéilleann siad go léir dóibh. Tógann an chuid eile de Chuid 2 ar an léargas seo.
Na seirbhísí agus cad is leis gach ceann acu
Is cairt Helm amháin í an chairt, nexus, leagan 1.0.0-alpha.1, do Kubernetes 1.33 nó níos déanaí. Ritheann gach ualach oibre faoina ServiceAccount féin, mar úsáideoir neamhfhréimhe, agus gach cumas Linux bainte de. Ritheann glaonna isteach sna seirbhísí a chosnaíonn féiniúlacht agus eochracha thar TLS (Slándáil Chiseal Iompair) frithpháirteach, agus roinneann an API (comhéadan feidhmchláir ríomhchlárúcháin) poiblí próiseas leis an ródaire AI (intleacht shaorga).
| Comhpháirt | Deployment agus Service | Port seirbhíse | An méid atá faoina úinéireacht |
|---|---|---|---|
| Consól | nexus-alpha |
3000 | Na leathanaigh a fheiceann daoine; freastalaíonn sé HTML (Teanga Mharcála Hipirtéacs) ag óstach an chonsóil |
| BFF (cúilín d'aghaidh) | nexus-alpha-bff |
8080 | Sonraí an chonsóil féin, an roghchlár a fhaigheann gach duine, an clár eisiúna |
| Auth | nexus-auth |
9101 (TLS frithpháirteach ar 8443) | Daoine, eagraíochtaí, seisiúin, comharthaí, eochracha API, linn eochracha samhla na heagraíochta |
| Geata | nexus-gateway |
9092, WebSocket 8093 | An AI Provider Router, agus an ciumhais API poiblí do REST (aistriú stáit ionadaíoch) agus MCP (Prótacal Comhthéacs Samhla) |
| Ceolfhoirneoir | nexus-orchestrator |
8080 | Seoladh UNO: glacadh le gach jab agus é a chur i scuaine |
| Sreafaí oibre | nexus-workflows |
8081 | Rith UNO: an t-oibrí a ritheann jabanna atá i scuaine |
| GraphRAG | nexus-graphrag |
8090, WebSocket 8091 | Cuimhne: an graf eolais agus aisghabháil os a chionn |
| Probitas | nexus-probitas |
9151 (HTTPS) | Fianaise: taifid rialachais agus an mórleabhar séalaithe |
| Inneall scileanna | nexus-skills-engine |
8095 | An leabharlann scileanna; scileanna a aimsiú agus a rith |
| Eochracha | nexus-keys |
8080 (HTTPS, TLS frithpháirteach) | Eochracha in aghaidh na heagraíochta in OpenBao, coimeád, féiniúlacht na suiteála |
| Breiseáin | nexus-plugins |
9111 | Clárlann na mbreiseán agus taifid chatalóige; múchta de réir réamhshocraithe |
| Próiseáil comhad | nexus-fileprocess |
9109 | Léamh cáipéisí agus íomhánna uaslódáilte; múchta de réir réamhshocraithe |
Tá na chéad deich gcinn riachtanach. Tá an dá cheann dheireanacha roghnach, agus castar air iad le components.plugins.enabled agus components.fileprocess.enabled nuair a úsáideann suiteáil Enterprise nó pacáiste fearainn iad. Tá lasc dá chuid féin, components.alive.enabled, ag seirbhís roghnach amháin eile, nexus-alive ar phort 8080, agus tá sí múchta de réir réamhshocraithe freisin. Luíonn macasamhla agus acmhainní do gach ceann acu faoi components.<name>.
Is leathanaigh arna rindreáil ag an bhfreastalaí gan aon bhunachar sonraí é an consól. Labhraíonn sé leis an BFF, agus le nexus-auth laistigh den bhraisle, gan dul amach riamh tríd an óstach údaraithe poiblí agus ar ais isteach. Diúltaíonn sé tosú gan a eagrán féin, rud a sheolann an chairt ar aghaidh mar NEXUS_EDITION ón aon luach edition amháin. Oibríonn gach ball d'eagraíocht ann de réir a róil. Tá na leathanaigh riaracháin ann d'úinéirí agus do riarthóirí, agus faigheann ball a osclaíonn ceann acu an leathanach "Not an administrator".
Is é an BFF leath freastalaí an chonsóil agus tá sé tógtha mar bhreiseán de chuid an ardáin, cláraithe mar an táirge Nexus Alpha. Coinníonn sé táblaí an chonsóil féin i mbunachar sonraí ar leith, nexus_alpha, agus socraíonn sé cé na grúpaí roghchláir a fheiceann duine. Nuair a bhíonn obair le déanamh ag an gconsól, iarrann an BFF ar an tseirbhís ar léi í.
Tá nexus-auth scríofa in Go agus is í an t-aon seirbhís a bhuann comharthaí. Maireann comharthaí rochtana 15 nóiméad agus comharthaí athnuachana 12 uair an chloig de réir réamhshocraithe (auth.accessTokenTTL, auth.refreshTokenTTL). Cuireann sé teorainn 5,000 iarratas in aghaidh an nóiméid ar gach duine atá sínithe isteach sula bhfreagraíonn sé le 429 (auth.rateLimitPerMinute). Ritheann sé dhá éisteoir: an ceann simplí ar phort coimeádáin 8080 a shroicheann an Ingress poiblí, agus ceann TLS frithpháirteach ar 8443 nach mór do gach glaoiteoir laistigh den bhraisle a úsáid. Ní chreideann sé X-Forwarded-For ach ó na léimeanna in proxy.trustedCIDRs, liosta de raonta Ródaithe Idir-Fhearainn gan Aicme (CIDR), a bhfuil 10.42.0.0/16, líonra podanna k3s, mar réamhshocrú aige. Má ritheann do rialaitheoir ingress in áit eile, athraigh é. Seachas sin bíonn an chuma ar gach síniú isteach gur ón rialaitheoir a tháinig sé.
Tá dhá jab ag an ngeata a roinneann próiseas amháin. Laistigh den bhraisle is é an AI Provider Router é (an lasc-chlár AI i gCuid 1 agus ar leathanaigh an chonsóil), an t-aon sealbhóir ar dhintiúir samhla eagraíochta (tuilleadh faoi sin thíos). Ag an gciumhais is é an rud a shroicheann api.<domain>: cliaint REST, agus cliaint MCP, a bhfuil an lucht féachana https://<hosts.api>/mcp ar iompar ag a gcomharthaí agus a thagann ón bhfreastalaí údaraithe OAuth 2.1 ag an óstach údaraithe (is é OAuth an caighdeán oscailte d'údarú tarmligthe).
Is iad an ceolfhoirneoir agus na sreafaí oibre le chéile UNO, an t-inneall sreafa oibre. Ritheann gach ríomhaireacht tríothu. Glacann an ceolfhoirneoir le jab ag POST /api/v1/dispatch, freagraíonn sé 202 le jobId, runId agus traceId, agus cuireann sé i scuaine é. Níl aon chonair rite inlíne ann: déanann cliant pobalbhreith ar GET /api/v1/dispatch/{jobId} i gcónaí nó glacann sé le haisghlaoch. Tarraingíonn oibrí na sreafaí oibre jabanna ón scuaine, ceithre cinn ag an am in aghaidh na macasamhla de réir réamhshocraithe (workflows.concurrency), agus tá bealach HTTP amháin go díreach aige, GET /health.
Is é Probitas an tseirbhís fianaise. Freastalaíonn sé TLS é féin, ó dheimhniú a eisíonn an chairt, agus coinníonn sé a tháblaí sa scéimre trust le ról ar leith don mhórleabhar. Déantar a ghnéithe rialachais a lascadh le probitas.flags. Seoltar roinnt acu i mód shadow: ríomhtar agus taifeadtar an breithiúnas, agus ní chuirtear bac ar rud ar bith go dtí go n-athraíonn tú an bhratach.
Is é nexus-keys seirbhís eochracha an ardáin, scríofa in Go. Coinníonn sé eochair in aghaidh na heagraíochta i stór eochracha OpenBao agus rothlaíonn sé gach oíche iad. Scriosann a chuid jabanna oíche freisin eochracha a bhfuil a ndáta coinneála tagtha agus easpórtálann sé a admhálacha chuig imleabhar dá chuid féin. Má scriostar eochair eagraíochta, fágann sin nach féidir na sonraí atá glasáilte fúithi a léamh go deo. Buann sé féiniúlacht na suiteála freisin ag an gcéad túsú, faoi keys.installationName, agus tá an t-ainm sin buan. Roghnaigh go cúramach é: diúltaíonn an chairt d'ainm folamh (INSTALLATION_NAME_MISSING) agus diúltaíonn sí don ainm ina luachanna samplacha féin (INSTALLATION_NAME_EXAMPLE).
Trí óstach phoiblí
Foilsíonn an chairt trí óstainm go díreach, arbh iad féiniúlacht na suiteála le chéile iad. Diúltaíonn gach seirbhís tosú gan iad.
| Ingress | Luach óstaigh | Cúilín |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, port 3000 |
nexus-api |
hosts.api |
nexus-gateway, port 9092 |
nexus-auth |
hosts.auth |
nexus-auth, port 9101 |
Úsáideann na samplaí sa leabhar seo console.harrow.example, api.harrow.example agus auth.harrow.example. Is réada simplí networking.k8s.io/v1 iad na Ingresses le riail amháin an ceann, conair /. Leanann TLS ag an gciumhais tls.mode: existing (Secret a rinne tú, ainmnithe in tls.existingSecret), cert-manager (ClusterIssuer a ritheann tú, ainmnithe in tls.clusterIssuer) nó none (tagann deireadh le TLS os comhair na braisle). Ní chuireann an chairt aon atreorú dá cuid féin leis, ionas go sroicheann dúshlán HTTP ACME (Timpeallacht Uathoibrithe Bainistíochta Deimhnithe) do réiteoir gan athrú. Clúdaíonn Caibidil 2.11, Athruithe: stóir sheachtracha, TLS agus ingress, gach mód.
Níl aon rud eile nochta. Ní éisteann na stóir shonraí, OpenBao ná gach seirbhís inmheánach ach laistigh den ainmspás.
Iarratas, ó thús go deireadh
Seo a tharlaíonn nuair a osclaíonn Aoife Brennan, ceannaire IT ag Harrow, an consól agus nuair a chuireann sí ceist ar an gcúntóir faoi sceideal feistithe na míosa seo.
- Lódálann a brabhsálaí
https://console.harrow.example. Seolann an Ingressnexus-consolechuignexus-alphaar phort 3000 é. - Síníonn sí isteach lena pas-eochair. Labhraíonn na leathanaigh sínithe isteach le
nexus-authtríauth.harrow.example, agus buann nexus-auth comhartha rochtana di a iompraíonn a húsáideoir, a heagraíocht agus, nuair a bhíonn ceann ag a seisiún, a haonad gnó. - Glaonn freastalaí an chonsóil ar an BFF, a sheiceálann a comhartha agus a fhiafraíonn de nexus-auth an bhfuil an táirge ag a heagraíocht agus an nglactar lena ról. Freagraíonn sé leis na grúpaí roghchláir a bhfuil cead aici a fheiceáil.
- Téann a ceist ón BFF chuig bealach seolta an cheolfhoirneora, agus a heagraíocht agus a húsáideoir tógtha ón gcomhartha fíoraithe. Freagraíonn an ceolfhoirneoir 202 agus cuireann sé an jab ar scuaine in Valkey.
- Glacann oibrí sreafaí oibre an jab. Réitíonn an t-inneall scileanna an scil a ritheann sé, agus téann aisghabháil thar cháipéisí Harrow chuig GraphRAG, a léann Neo4j, Qdrant agus a scéimre PostgreSQL.
- Téann glao na samhla chuig an AI Provider Router ag
/internal/ai/chat. Roghnaíonn an ródaire an soláthraí agus an tsamhail ó linn eochracha agus ó pholasaí ródaithe Harrow féin, déanann sé an glao le heochair Harrow, agus cuireann sé an críochnú ar ais. - Tuirlingíonn an toradh ar ró rite an jab. Léann an BFF é agus tarraingíonn an consól an freagra, lena luanna.
Iompraíonn na léimeanna ó sheirbhís go seirbhís comharthaí seirbhíse teilgthe, ritheann na cinn isteach in nexus-auth, nexus-keys agus Probitas thar TLS ó údarás deimhniúcháin na suiteála féin, agus tá gach rochtain sonraí i gcéimeanna 4 go 6 fálaithe d'eagraíocht Harrow sa bhunachar sonraí féin. Míníonn na hailt thíos an dá rud.
An tsraith sonraí
Seolann Nexus a chóip shínithe féin de gach stór, leis an tairiscint foinse do gach ceann sa bheart. Roghnaíodh gach ceann ar son a cheadúnais chomh mór lena fheidhm.
| Stór | Leagan | Ceadúnas | An fáth a bhfuil sé ann | Calafort | Imleabhar réamhshocraithe |
|---|---|---|---|---|---|
| PostgreSQL le PostGIS agus pgvector | PostgreSQL 16, PostGIS 3, pgvector 0.8 | Ceadúnas PostgreSQL; PostGIS GPL-2.0-or-later | An córas taifid do gach seirbhís; PostGIS do shonraí léarscáile; pgvector do veicteoirí a choinnítear le taobh rónna | 5432 | 50 GiB |
| Valkey | 8.1 | BSD-3-Clause | Scuainí jab UNO agus taiscí gearrshaolacha, amhail taisce eochracha API nexus-auth | 6379 | 5 GiB |
| Neo4j Community Edition | 5.26 | GPL-3.0 | An graf eolais a thógann agus a shiúlann GraphRAG | 7687 (Bolt) | 20 GiB |
| Qdrant | 1.15 | Apache-2.0 | Cuardach veicteora do GraphRAG agus don inneall scileanna | 6333 (HTTP), 6334 (glaonna nós imeachta cianda gRPC) | 10 GiB |
| SeaweedFS | 4.48 | Apache-2.0 | Stóráil réada do chomhaid, comhoiriúnach le Amazon Simple Storage Service (S3) | 8333 | 50 GiB |
| OpenBao | 2.6 | MPL-2.0 | An stór eochracha agus a dhíshéalaitheoir, do nexus-keys | 8200 | 5 GiB agus 1 GiB |
Tháinig roinnt roghanna in áit rud éigin níos pobalaithnidiúla. Seasann Valkey isteach do Redis 7.4, a ndiúltaíonn an t-eisiúint dá cheadúnais reatha. Is AGPL-3.0 é MinIO, mar sin is é SeaweedFS an stór réada. Sroicheann GraphRAG Neo4j Community Edition thar Bolt, prótacal líonra, agus sroicheann na seirbhísí PostGIS thar phrótacal PostgreSQL, ionas go bhfanann an GPL le gach ceann acu. Is é OpenBao forc an Linux Foundation de Vault ó roimh athrú ceadúnais Vault.
Ritheann gach stór agus fíordheimhniú ar siúl agus dintiúir ghinte aige: pasfhocal do Valkey, eochair API do Qdrant, eochracha rochtana do SeaweedFS.
Ritheann gach ceann de na cúig stór faoi dataTier sa bhraisle (mode: in-cluster, an réamhshocrú) nó is ceann é a oibríonn tú cheana féin (mode: external, le external.host agus Secret ainmnithe ag external.existingSecret). Maidir le PostgreSQL seachtrach, socraigh sslmode go verify-full nó verify-ca, agus cuir deimhniú údarás deimhniúcháin (CA) an fhreastalaí sa Secret sin; tá na sonraí i gcaibidil 2.11, Athruithe: stóir sheachtracha, TLS agus ingress.
# harrow-values.yaml (Helm values): Harrow's own PostgreSQL, every other store in the cluster
dataTier:
postgres:
mode: external
sslmode: verify-full
external:
host: pg.harrow.example
existingSecret: harrow-postgresIs é an péire OpenBao an eisceacht: ritheann sé taobh istigh den tsuiteáil i gcónaí, toisc go dtúsíonn an Job coimeádta ann é.
Aitheantas idir seirbhísí
Ritheann Nexus gan mogalra seirbhíse. Tagann TLS frithpháirteach ó údarás deimhniúcháin (CA) áitiúil a chruthaíonn an chairt trí cert-manager, rud nach mór a shuiteáil ar dtús (tá v1.21.3 tástáilte).
Déanann Issuer féinshínithe deimhniú CA amháin, nexus-local-ca, ECDSA (Algartam Sínithe Dhigitigh Cuair Éiliptigh) P-256, bailí ar feadh deich mbliana. Síníonn an dara Issuer leis an CA sin. Faigheann gach ualach oibre a ghlaonn ar fhreastalaí TLS laistigh den tsuiteáil a dheimhniú cliaint féin, darbh ainm <service-account>-client-tls, bailí ar feadh 90 lá agus athnuaite 15 lá roimh dhul in éag. Is é an t-aon ainm atá air ná aitheantóir aonfhoirmeach acmhainne (URI) i bhfoirm féiniúlachta SPIFFE:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Aimsíonn gach ualach oibre deimhniú poiblí an CA mar ca.crt ina Secret deimhnithe féin. Ní fheistíonn aon phod eochair an CA, agus níl trust-manager ag teastáil uait.
Fíoraíonn trí sheirbhís glaoiteoirí de réir deimhnithe. Déanann nexus-auth é ar a dara héisteoir, port 8443, agus diaileann gach glaoiteoir laistigh den bhraisle an ceann sin. Déanann nexus-keys é ar an aon éisteoir amháin atá aige. Freastalaíonn Probitas TLS óna dheimhniú féin, nexus-probitas-tls, a athléann sé nuair a athnuaíonn cert-manager é. Ní chuireann ceann ar bith acu muinín i gceanntásc X-Forwarded-Client-Cert.
Faigheann gach ualach oibre comharthaí Kubernetes uair an chloig ag /var/run/secrets/nexus freisin, ceann amháin in aghaidh na seirbhíse a nglaonn sé uirthi, agus an tseirbhís sin mar an lucht féachana. Mapálann an ConfigMap nexus-service-identities gach <namespace>/<service-account> chuig ainm seirbhíse nó breiseáin, agus níl aon fhéiniúlacht ag ualach oibre atá in easnamh uaidh agus diúltaítear dó. Seiceálann an ceolfhoirneoir agus Probitas na comharthaí seo leis an API Kubernetes. De na seirbhísí atá ag rith, níl system:auth-delegator nó comhartha API feistithe ach ag an dá cheann sin; is é an t-aon ualach oibre eile a bhfuil comhartha aige ná an Job coimeádta a ritheann ag am na suiteála.
Dúnann polasaí líonra an rud nach ndúnann féiniúlacht. Tosaíonn an chairt ó dhiúltú réamhshocraithe, ansin ligeann sí trácht isteach idir podanna na suiteála féin, DNS (Córas Ainmneacha Fearainn), ainmspás an rialaitheora ingress (networkPolicy.ingressNamespace, kube-system de réir réamhshocraithe) chuig na trí Service phoiblí, agus an freastalaí API don dá athbhreithneoir comharthaí. Iompraíonn na podanna OpenBao lipéad difriúil ón gcuid eile den ardán, mar sin ní shroicheann an riail oscailte laistigh den ainmspás iad: ní théann ach nexus-keys, a chuid Jobs agus an Job coimeádta tríothu, ar phort 8200. Téann aon rud eile nach mór d'ualach oibre a shroicheadh lasmuigh den ainmspás, amhail d'athsheachadán ríomhphoist, isteach in networkPolicy.externalEgressCIDRs, atá folamh de réir réamhshocraithe.
Imircí agus an mórleabhar scéime
Ritheann imircí mar chrúcaí Helm, ar post-install agus pre-upgrade. Ritheann crúca iar-shuiteála tar éis Deployments na heisiúna a bheith cruthaithe. Mar sin ar an gcéad suiteáil tosaíonn na seirbhísí fad is nach bhfuil a scéimrí ann fós, agus rachaidís i lúb thuairteála in aghaidh bunachar sonraí gan aon ról, gan aon phasfhocal agus gan aon táblaí. Seachnaíonn Nexus é sin le mórleabhar.
Ritheann na crúcaí in ord meáchain, agus fanann Helm le gach Job sula dtosaíonn an chéad mheáchan eile:
| Meáchan | Crúca | An méid a dhéanann sé |
|---|---|---|
| -30 | nexus-migrations-env agus réamhriachtanais |
Cruthaíonn sé an Secret do chrúcaí amháin le dintiúir an imirceora, agus gach rud a léann an Job coimeádta |
| -20 | nexus-db-bootstrap |
Cruthaíonn sé na bunachair shonraí nexus agus nexus_alpha, ról an imirceora, ról am rite gach seirbhíse, na síntí agus an mórleabhar |
| -15 | nexus-openbao-custody-init |
Túsíonn sé an stór eochracha agus an díshéalaitheoir agus buann sé féiniúlacht na suiteála |
| -12 | nexus-graphrag-migrations |
Scéimre GraphRAG, a bhfuil úinéireacht aige ar réada a dtagraíonn bonnlíne nexus-auth dóibh |
| -10 | nexus-auth-migrations |
An scéimre féiniúlachta |
| -5 | imircí an cheolfhoirneora, an gheata agus Probitas | A scéimrí; seiceálann Probitas go bhfuil na táblaí údaraithe ann ar dtús |
| 0 | nexus-alpha-bff-migrations |
Bunachar sonraí an chonsóil féin |
Tá backoffLimit: 0 ag gach Job imirce, mar sin má theipeann ar imirce teipeann ar an tsuiteáil.
Is tábla amháin é an mórleabhar, nexus_release.schema_applied, le ró in aghaidh an tslabhra agus an achoimre íomhá. Ní scríobhann gach crúca a ró ach amháin tar éis dá reathaire imirce filleadh. Iompraíonn gach Deployment a úsáideann PostgreSQL coimeádán túsaithe, wait-for-schema, a léann an tábla sin mar ról nach bhfuil cead aige aon rud eile a léamh (nexus_ledger_reader) agus a fhanann go dtí go dtaispeánann gach slabhra a bhraitheann sé air ró d'íomhá na heisiúna seo. Ansin tosaíonn an tseirbhís. Fanann oibrí na sreafaí oibre le slabhra an cheolfhoirneora, ós rud é go roinneann sé an bunachar sonraí sin, agus ní fhanann an t-inneall scileanna ach leis an túsú.
Seiceálann sé arís agus arís eile gach 3 shoicind (schemaWait.intervalSeconds) agus éiríonn sé as tar éis 1,800 (schemaWait.timeoutSeconds) le líne a ainmníonn na slabhraí atá fós in easnamh. Ní thosaíonn coimeádán na seirbhíse féin riamh in aghaidh scéimre mhícheart.
kubectl -n nexus logs deploy/nexus-gateway -c wait-for-schemaSin an fáth nach mór duit helm install --wait a rith riamh. Le --wait, fanann Helm leis na Deployments sula ritheann sé na crúcaí iar-shuiteála, agus fanann na Deployments leis na crúcaí. Ní bhogann ceachtar acu. Suiteáil gan é agus fan ina dhiaidh sin; tugann caibidil 2.6, Suiteáil Community ar Kubernetes, an t-ordú cruinn.
Leithlisiú ar thrí ais
Tá gach léamh, scríobh, glao uirlise agus seoladh scile in Nexus scópáilte ar thrí ais.
| Ais | Réimse | An rud a scarann sé |
|---|---|---|
| Tionónta | organization_id |
Eagraíocht amháin ó cheann eile, teorainn chrua |
| Úinéir | owner_user_id |
Rudaí duine amháin ó rudaí gach duine eile, fiú laistigh d'eagraíocht amháin |
| Aonad | business_unit_id |
Foroinn d'eagraíocht, roghnach |
Cuireann ais an úinéara iontas ar dhaoine. Tá bosca poist nó leabhar nótaí pearsanta príobháideach dá úinéir fiú ó chomhghleacaithe san aonad céanna leis an ról céanna. Socraíonn riarthóir polasaí agus ní léann sé ábhar.
Tagann na haiseanna ón iarratas fíordheimhnithe agus ó áit ar bith eile ní thagann siad. Ní féidir le haon athróg thimpeallachta, ceanntásc, paraiméadar fiosrúcháin ná deighleog conaire iad a shocrú. Diúltaítear do chorp iarratais a ainmníonn eagraíocht le TENANT_NOT_A_PARAMETER. Diúltaíonn dromchla nach féidir leis a lua cén tionónta, úinéir agus aonad ar leo ró le 403 SCOPE_PREDICATE_MISSING, agus liostaíonn an corp cé na haiseanna a réitíodh agus cé na cinn nár réitíodh. Ní thiteann sé siar riamh ar léamh níos leithne.
tá feidhm aige sin in dhá áit ag an am céanna.
Sa bhunachar sonraí. Nascann gach seirbhís mar a róil am rite féin: nexus_auth, auth_app agus auth_platform don tseirbhís fhéiniúlachta, nexus_probitas agus nexus_probitas_ledger do Probitas, agus nexus_gateway, nexus_graphrag, nexus_skills, orchestrator_app, workflows_app agus an chuid eile do na cinn eile. Níl ceann ar bith acu ina fhorúsáideoir ná níl BYPASSRLS aige. Níl úinéireacht ag ceann ar bith acu ar na táblaí a úsáideann sé ach an oiread, mar sin baineann gach polasaí slándála ar leibhéal ró (RLS) leis. Roinneann na róil grúpa, nexus_runtime, a dheonaíonn nasc agus úsáid scéimre agus gan aon chearta tábla ar chor ar bith; deonaítear a táblaí féin do gach seirbhís trína himircí féin. Ní féidir na socruithe tionónta a léann polasaithe RLS a shocrú ach trí fheidhm bind_scope gach seirbhíse, a ritheann mar a húinéir. Cúlghaireann an túsú set_config ó gach duine eile, agus diúltaíonn an ceolfhoirneoir agus Probitas tosú dá bhféadfadh a ról am rite glaoch air go díreach (tugann Probitas DB_ROLE_SETS_SCOPE_DIRECTLY air sin). Is leis an Job túsaithe agus le céim sholáthair an BFF na haon naisc fhorúsáideora sa tsuiteáil ar fad.
Sa bhuneilimint chomhroinnte fiosrúcháin scópáilte. Faigheann gach stór san ardán agus gach breiseán a thógtar ar an SDK (paca forbartha bogearraí) fál amháin le hoidhreacht a thógann anabairt SQL ó scóp réitithe. Glacann a fheidhm scóip leis an bhféiniúlacht fhíoraithe agus níl aon pharaiméadar eagraíochta aici, ionas nach féidir le glaoiteoir ceann a chur isteach, agus ní féidir le haon bhealach rogha a dhéanamh gan a bheith páirteach.
Níl ach trasnú amháin go díreach ar theorainn an tionónta, agus tá sé cúng: deontas taifeadta. Taifeadann beirt ag an eagraíocht a bhfuil na rónna aici cén eagraíocht a fhéadfaidh cé na táblaí a léamh, agus cá fhad. Ritheann gach léamh in idirbheart inléite amháin agus logáiltear sa dá thionónta é. Ní léann úinéirí ná riarthóirí trasna riamh, agus ní féidir leis an léitheoir deontas a leathnú.
An cosán AI
Cuireann glaoiteoirí mianta in iúl. Is leis an AI Provider Router an dintiúr agus is é a dhéanann an rogha dheireanach.
Téann gach glao samhla in Nexus trí bhealaí /internal/ai/* an ródaire, agus ní ligeann an ródaire isteach ach glaoiteoirí ainmnithe. Socraíonn an chairt trí liosta ar an ngeata:
| Bealaí | Cé a fhéadfaidh glaoch |
|---|---|
| Comhrá agus sruthú comhrá | nexus-orchestrator, nexus-workflows, nexus-skills-engine |
| Leabuithe agus athrangú | nexus-graphrag, nexus-skills-engine, nexus-workflows |
| Gach rud eile, lena n-áirítear rith uirlisí | nexus-orchestrator, nexus-workflows |
Diúltaítear do ghlao gan aon fhéiniúlacht ghlaoiteora le 403 MISSING_CALLER_IDENTITY, agus do ghlaoiteoir nach bhfuil ar an liosta le 403 UNAUTHORIZED_CALLER. Níl breiseáin ar aon liosta, agus is d'aon ghnó atá sé sin: tarlaíonn glaonna samhla breiseáin thar a cheann, trí sheoladh UNO.
Is é an rud a fhéadfaidh glaoiteoir a sheoladh ná mian: soláthraí agus samhail is fearr leis, mar aon le próifíl chumais amhail íosfhad comhthéacs nó úsáid uirlisí. Ní chomhlíonann an ródaire mian ach amháin nuair a bhíonn an soláthraí sin cumasaithe agus dintiúrtha ag an eagraíocht; seachas sin cuireann sé ceann eile ina áit, laistigh den soláthraí céanna ar dtús, ansin trasna sholáthraithe eile na heagraíochta. Ní dhéanann próifíl chumais ach scagadh, agus is riachtanas crua é riachtanas cónaitheachta sonraí inti. Nuair nach n-oireann dada, níl aon samhail chúltaca ann: faigheann an glaoiteoir 422 MODEL_CAPABILITY_UNAVAILABLE nó 422 NO_PROVIDER_FOR_ROLE, le teaghrán leasaithe a thaispeánann an consól do riarthóir.
Is leis an eagraíocht na heochracha. Cuireann riarthóirí gach eagraíochta a n-eochracha soláthraí féin isteach ina linn ón gconsól, agus réitíonn an ródaire ag am an ghlao iad. Níl aon eochair shamhla ina luach cairte agus ní sheoltar ceann ar bith le Nexus. Ní fhaigheann eagraíocht gan aon eochair aon fhreagraí AI, agus deir an consól é sin go soiléir; ní líonann dada an bhearna ó áit éigin eile.
Múnlaíonn dhá luach cairte an ródaire. Ainmníonn ai.localProvider.baseUrl freastalaí samhla atá comhoiriúnach le OpenAI a ritheann tú féin, a ródáiltear díreach mar aon soláthraí eile. Liostaíonn ai.installationHosts do fhreastalaithe samhla ar ainmneacha príobháideacha, rud a áiríonn an ródaire mar chuid de laistigh den suiteáil. Déanann GraphRAG leabú tríd an ródaire freisin, mar an eagraíocht ar léi an t-ábhar. Ritheann an tsamhail leabaithe réamhshocraithe sa bhraisle gan chárta grafaicí; is faoi gach eagraíocht atá an rogha leabuithe óstáilte a úsáid.
Gan teiliméadracht
Ní fhágann aon rud suiteáil mura seolann tú féin é. Ní féidir le luach telemetry.enabled na cairte a bheith ach ina false; diúltaíonn an scéimre d'aon rud eile. Tá tuairisciú na sraithe sonraí féin múchta freisin: tá tuarascáil úsáide Neo4j agus teiliméadracht Qdrant díchumasaithe sa chairt.
Agus networkPolicy.enabled ar siúl, arb é an réamhshocrú é, ní féidir le haon phod an t-idirlíon a bhaint amach mura liostaíonn tú an ceann scríbe in networkPolicy.externalEgressCIDRs. Is ceann scríbe den sórt sin é soláthraí samhla óstáilte, agus is amhlaidh atá le d'athsheachadán ríomhphoist.
D'athraigh an riail chéanna réamhshocrú amháin a thabharfaidh tú faoi deara. Teastaíonn seirbhís idirlín ó CAPTCHA nexus-auth le haghaidh clárúchán, mar sin ar shuiteáil tá sé múchta, agus fanann clárúchán strainséara ar cheadú riarthóra (403 SIGNUP_REQUIRES_APPROVAL). Tá an scáileán a chuireann bac ar chlárúcháin ó líonraí óstála múchta freisin, toisc go dteastaíonn bunachair sonraí ceadúnaithe uaidh nach seolann Nexus. Cailleann tú an scagadh sin.

