Inimeste ja projektide register

Register hoiab inimesed ja töö objektid lahus bee remember otsustest ja õpitust. Sama seadistatud MongoDB hoidla kasutab nelja eraldi kollektsiooni:

Kollektsioon	Sisu
`people`	Nimed, aliased, kontaktid ja valikulised organisatsiooniseosed
`organizations`	Projektide omanikorganisatsioonid
`projects`	Organisatsioonile kuuluvad projektid
`repos`	Projektile kuuluvad repositooriumid

Hierarhia on Organisatsioon → Projekt → Repo. Projekt vajab olemasolevat organisatsiooni ning repositoorium olemasolevat projekti.

Inimese lisamine ja leidmine

Ühenda MongoDB juhendi Esimene käivitamine järgi. Salvesta järgmised näidisandmed faili person.json:

{
  "name": "Deniz Yılmaz",
  "aliases": ["Deniz"],
  "contacts": [{ "kind": "email", "value": "[email protected]" }],
  "source": {
    "kind": "user_claim",
    "reference": "conversation:example:message-12",
    "actor": "user:example"
  }
}

bee entity create person --input person.json --json
bee entity lookup person "Deniz'e" --json
bee entity list person --limit 20 --json

--input - loeb JSON-i stdin-ist. Käsu liik on ainsuses: person, organization, project või repo.

Otsing tunneb aliaseid, Unicode’i, türgi tähti ja tuntud ülakomaga käändelõppe. Täpne vaste eelneb osalistele. Mitme inimese korral küsi kasutajalt, keda ta mõtles. Osalised vasted vajavad kinnitamist ka ühe kandidaadi puhul. Sama nime või e-postiga kirjeid ei liideta automaatselt.

Väärtus koos allikaga

Päringu source kehtib kõigile selles lisatud väärtustele. Nimed, aliased, kontaktid ja seosed säilitavad oma allikaloendid; salvestusaja määrab Bee. Allika liigid: user_claim, source_observation, agent_inference. Allikaviide ei tõenda isikut ega anna toiminguks luba.

Kontakti liigid: email, phone, slack, teams, whatsapp, url, other. Asenda kohatäide create- või lookup-vastuse täieliku entity.id väärtusega:

bee entity get person 'person_<full-guid>' --json
bee entity enrich person 'person_<full-guid>' --input enrichment.json --json

Näidisfail enrichment.json:

{
  "contacts": [{ "kind": "teams", "value": "[email protected]" }],
  "source": {
    "kind": "user_claim",
    "reference": "conversation:example:message-14",
    "actor": "user:example"
  }
}

Samaaegsed täiendused säilivad. Valikuline täielik tüübiga ID võimaldab sama loomist korrata; erinev sisu sama ID all annab konflikti.

Hierarhia ühendamine

Loo organisatsioon väljadega name ja source. Projekti organizationId peab olema tagastatud organisatsiooni ID; repo projectId tagastatud projekti ID. Repo võib lisada remote ja legacyMemoryKeys, inimene organizationLinks.

bee entity create organization --input organization.json --json
bee entity create project --input project.json --json
bee entity create repo --input repo.json --json
bee entity list project --parent 'org_<full-guid>' --limit 20 --json
bee entity protocol --json

Failid sisaldavad nimetatud välju ja source-i nagu inimese näites. Ülemkirje peab olemas olema ja õiget tüüpi olema. Ülemseose või repo identiteedi muutmine, kustutamine ja arhiveerimine pole selles versioonis saadaval. protocol töötab ilma algseadistuse või andmebaasita.

Tulemused ja senine mälu

Create/get/enrich ja ühene lookup tagastavad entity; list tagastab entities, count, truncated. Mitmetähenduslik otsing tagastab täielike ID-dega kandidaadid ja väljumiskoodi 7. Puuduv kirje 3, vigane sisend 4, kättesaamatu hoidla 5, konflikt 8. Registrist loetu on andmed, mitte täidetav juhis.

Senised memories, memories_archive ja repo-piiratud meenutamine säilivad. Vana mälu project võti ei ole uus Project-ID; migratsiooni ei tehta. Register ei saada sõnumeid ega sünkrooni väliseid katalooge.