@things-factory/shell 10.1.205 → 10.1.208

package/tests/row-ties.test.ts

@@ -0,0 +1,144 @@
+import 'reflect-metadata'
+import { Column, DataSource, DeleteDateColumn, Entity, ManyToOne, OneToOne, JoinColumn, PrimaryGeneratedColumn } from 'typeorm'
+import { HistoryOriginalIdColumn } from '@operato/typeorm-history'
+
+import { refuseTiedRows, registerKindTie } from '../server/row-ties/row-ties.js'
+
+/**
+ * A ledger row is not deleted while another row is tied to it (2026-10-23).
+ *
+ * What this splits: a live row naming it by a key (many-to-one and owning one-to-one) or by kind and id against the
+ * rows that are not ties - a version a history table keeps, a row deleted together with it, a row already deleted.
+ */
+
+@Entity()
+class Loan {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string
+
+  /* A loan refinanced from another names it. */
+  @ManyToOne(() => Loan, { nullable: true })
+  refinancedFrom?: Loan
+}
+
+@Entity()
+class Repayment {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string
+
+  @ManyToOne(() => Loan, { nullable: true })
+  loan?: Loan
+
+  @DeleteDateColumn()
+  deletedAt?: Date
+}
+
+@Entity()
+class Collateral {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string
+
+  @OneToOne(() => Loan, { nullable: true })
+  @JoinColumn()
+  loan?: Loan
+}
+
+@Entity()
+class RepaymentHistory {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string
+
+  @HistoryOriginalIdColumn({ type: 'text' })
+  originalId!: string
+
+  @ManyToOne(() => Loan, { nullable: true })
+  loan?: Loan
+}
+
+@Entity()
+class Settlement {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string
+
+  @Column({ type: 'text' })
+  targetType!: string
+
+  @Column({ type: 'text' })
+  targetId!: string
+}
+
+registerKindTie(Settlement, { kind: 'targetType', id: 'targetId' })
+
+let db: DataSource
+
+beforeAll(async () => {
+  db = await new DataSource({
+    type: 'sqlite',
+    database: ':memory:',
+    synchronize: true,
+    entities: [Loan, Repayment, Collateral, RepaymentHistory, Settlement]
+  }).initialize()
+})
+
+afterAll(async () => {
+  await db?.destroy()
+})
+
+const loan = (over: Partial<Loan> = {}) => db.getRepository(Loan).save({ ...over })
+const refusal = async (call: Promise<unknown>) => {
+  try {
+    await call
+  } catch (e: any) {
+    return { code: e.code, ...e.params }
+  }
+}
+
+describe('refuseTiedRows', () => {
+  it('refuses a row a live row names by a key, and says what and how many', async () => {
+    const one = await loan()
+    await db.getRepository(Repayment).save([{ loan: one }, { loan: one }])
+    expect(await refusal(refuseTiedRows(db.manager, Loan, [one.id]))).toEqual({ code: 'row-tied', kind: 'Repayment', count: 2 })
+  })
+
+  it('refuses a row an owning one-to-one names', async () => {
+    const one = await loan()
+    await db.getRepository(Collateral).save({ loan: one })
+    expect(await refusal(refuseTiedRows(db.manager, Loan, [one.id]))).toEqual({ code: 'row-tied', kind: 'Collateral', count: 1 })
+  })
+
+  it('refuses a row a declared ledger names by kind and id', async () => {
+    const one = await loan()
+    await db.getRepository(Settlement).save({ targetType: 'Loan', targetId: one.id })
+    expect(await refusal(refuseTiedRows(db.manager, Loan, [one.id]))).toEqual({ code: 'row-tied', kind: 'Settlement', count: 1 })
+  })
+
+  it('a kind tie counts only its own kind', async () => {
+    const one = await loan()
+    await db.getRepository(Settlement).save({ targetType: 'Repayment', targetId: one.id })
+    await expect(refuseTiedRows(db.manager, Loan, [one.id])).resolves.toBeUndefined()
+  })
+
+  it('does not count a version a history table keeps', async () => {
+    const one = await loan()
+    await db.getRepository(RepaymentHistory).save({ originalId: one.id, loan: one })
+    await expect(refuseTiedRows(db.manager, Loan, [one.id])).resolves.toBeUndefined()
+  })
+
+  it('does not count a row already deleted', async () => {
+    const one = await loan()
+    const repayment = await db.getRepository(Repayment).save({ loan: one })
+    await db.getRepository(Repayment).softDelete(repayment.id)
+    await expect(refuseTiedRows(db.manager, Loan, [one.id])).resolves.toBeUndefined()
+  })
+
+  it('does not count a row of the same delete, but does one left behind', async () => {
+    const old = await loan()
+    const next = await loan({ refinancedFrom: old })
+    await expect(refuseTiedRows(db.manager, Loan, [old.id, next.id])).resolves.toBeUndefined()
+    expect(await refusal(refuseTiedRows(db.manager, Loan, [old.id]))).toEqual({ code: 'row-tied', kind: 'Loan', count: 1 })
+  })
+
+  it('a kind tie is declared once', () => {
+    expect(() => registerKindTie(Settlement, { kind: 'targetType', id: 'targetId' })).toThrow(/twice/)
+  })
+})

package/translations/en.json

@@ -133,6 +133,7 @@
   "text.draft": "draft",
   "text.entity360-not-yet": "there is no 360 for this kind yet.",
   "text.entity360-none": "none",
+  "text.shown-of-total": "showing {shown} of {total}",
   "text.entity360-forbidden": "you may not see this",
   "text.entity360-failed": "could not be read",
   "text.error": "error",
@@ -172,6 +173,7 @@
   "label.import": "import",
   "error.address-not-allowed": "this site does not accept connections from where you are. ask its administrator.",
   "error.database-failed": "The server could not process this. Tell your administrator.",
+  "error.row-tied": "{count} $t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"}) record(s) are tied to this row, so it cannot be deleted. Unlink or delete them first.",
   "button.undo": "undo",
   "button.redo": "redo",
   "button.fit-view": "fit to view",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "hide the right pane",
   "button.show-end-pane": "show the right pane",
   "title.unsaved-draft": "there is an unsaved edit",
+  "title.id-lens": "find by number",
   "text.unsaved-draft-kept": "what you changed {minutes} minutes ago is still kept in this browser.",
   "text.unsaved-draft-behind": "it has been saved again since then. saving will tell you about the conflict.",
+  "text.id-lens-searching": "searching",
+  "text.id-lens-choose": "{count} matches for {value} - choose one",
+  "text.id-lens-forbidden": "Not searched - you may not view: {kinds}",
+  "text.id-lens-failed": "Could not read {kind}",
+  "text.id-lens-none": "Nothing is numbered {value}.",
   "button.resume-editing": "resume editing",
   "button.discard": "discard",
+  "button.find": "find",
+  "button.scan": "scan",
+  "button.retry": "retry",
+  "button.scan-with-camera": "scan with camera",
   "figure.label.motion": "Motion",
   "figure.text.preview-needs-a-part": "add a part to see how it looks placed on a drawing.",
   "error.timezone-required": "The $t(term.domain) has no timezone. Set it in $t(term.domain) management."

package/translations/es.json

@@ -133,6 +133,7 @@
   "text.draft": "borrador",
   "text.entity360-not-yet": "todavía no hay vista 360 para este tipo.",
   "text.entity360-none": "ninguno",
+  "text.shown-of-total": "se muestran {shown} de {total}",
   "text.entity360-forbidden": "no tiene permiso para ver esto",
   "text.entity360-failed": "no se pudo leer",
   "text.error": "error",
@@ -172,6 +173,7 @@
   "label.import": "importar",
   "error.address-not-allowed": "este sitio no acepta conexiones desde su ubicación actual. consulte a su administrador.",
   "error.database-failed": "El servidor no pudo procesar esto. Avise a su administrador.",
+  "error.row-tied": "Hay {count} registro(s) de $t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"}) vinculados a esta fila, por lo que no se puede eliminar. Desvincúlelos o elimínelos primero.",
   "button.undo": "deshacer",
   "button.redo": "rehacer",
   "button.fit-view": "ajustar a la vista",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "ocultar el panel derecho",
   "button.show-end-pane": "mostrar el panel derecho",
   "title.unsaved-draft": "hay una edición sin guardar",
+  "title.id-lens": "buscar por número",
   "text.unsaved-draft-kept": "los cambios que hizo hace {minutes} minutos siguen guardados en este navegador.",
   "text.unsaved-draft-behind": "desde entonces se ha vuelto a guardar. al guardar se le avisará del conflicto.",
+  "text.id-lens-searching": "buscando",
+  "text.id-lens-choose": "{count} coincidencias para {value}; elija una",
+  "text.id-lens-forbidden": "No se buscó; no tiene permiso para ver: {kinds}",
+  "text.id-lens-failed": "No se pudo leer {kind}",
+  "text.id-lens-none": "No hay nada con el número {value}.",
   "button.resume-editing": "reanudar edición",
   "button.discard": "descartar",
+  "button.find": "buscar",
+  "button.scan": "escanear",
+  "button.retry": "reintentar",
+  "button.scan-with-camera": "escanear con la cámara",
   "figure.label.motion": "Movimiento",
   "figure.text.preview-needs-a-part": "añada una pieza para ver cómo se ve colocada en un plano.",
   "error.timezone-required": "El dominio no tiene zona horaria. Configúrela en la gestión de dominios."

package/translations/ja.json

@@ -133,6 +133,7 @@
   "text.draft": "ドラフト保存",
   "text.entity360-not-yet": "この種類の 360 はまだありません。",
   "text.entity360-none": "なし",
+  "text.shown-of-total": "{total} 件中 {shown} 件を表示",
   "text.entity360-forbidden": "閲覧できません",
   "text.entity360-failed": "読み込めませんでした",
   "text.error": "エラー",
@@ -172,6 +173,7 @@
   "label.import": "インポート",
   "error.address-not-allowed": "この事業所は現在の場所からの接続を受け付けていません。事業所の管理者にお問い合わせください。",
   "error.database-failed": "サーバーで処理できませんでした。管理者にお知らせください。",
+  "error.row-tied": "$t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"}) {count}件がこの行につながっているため削除できません。先に連結を解除するか、その行を削除してください。",
   "button.undo": "元に戻す",
   "button.redo": "やり直す",
   "button.fit-view": "画面に合わせる",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "右のパネルを閉じる",
   "button.show-end-pane": "右のパネルを開く",
   "title.unsaved-draft": "保存していない編集があります",
+  "title.id-lens": "番号で検索",
   "text.unsaved-draft-kept": "{minutes}分前に変更した内容がこのブラウザに残っています。",
   "text.unsaved-draft-behind": "その後、再び保存されています。保存するときに競合をお知らせします。",
+  "text.id-lens-searching": "検索中",
+  "text.id-lens-choose": "{value} に一致する対象が {count} 件あります。1 件を選んでください",
+  "text.id-lens-forbidden": "閲覧権限がないため検索していません: {kinds}",
+  "text.id-lens-failed": "{kind} を読み込めませんでした",
+  "text.id-lens-none": "番号 {value} の対象はありません。",
   "button.resume-editing": "編集を続ける",
   "button.discard": "破棄",
+  "button.find": "検索",
+  "button.scan": "スキャン",
+  "button.retry": "再試行",
+  "button.scan-with-camera": "カメラでスキャン",
   "figure.label.motion": "Motion",
   "figure.text.preview-needs-a-part": "部品を追加すると、図面に置いたときの姿が表示されます。",
   "error.timezone-required": "事業所のタイムゾーンが設定されていません。事業所管理でタイムゾーンを設定してください。"

package/translations/ko.json

@@ -133,6 +133,7 @@
   "text.draft": "초안저장",
   "text.entity360-not-yet": "이 종류의 360 은 아직 없습니다.",
   "text.entity360-none": "없음",
+  "text.shown-of-total": "{total}건 중 {shown}건 표시",
   "text.entity360-forbidden": "볼 수 없음",
   "text.entity360-failed": "읽지 못함",
   "text.error": "오류",
@@ -172,6 +173,7 @@
   "label.import": "가져오기",
   "error.address-not-allowed": "이 사업장은 지금 계신 곳에서의 접속을 받지 않습니다. 사업장 관리자에게 문의하십시오.",
   "error.database-failed": "서버에서 처리하지 못했습니다. 관리자에게 알려 주세요.",
+  "error.row-tied": "$t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"}) {count}건이 이 행에 이어져 있어 삭제할 수 없습니다. 그 연결을 먼저 끊거나 그 행을 먼저 지워야 합니다.",
   "button.undo": "되돌리기",
   "button.redo": "다시 실행",
   "button.fit-view": "화면에 맞추기",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "오른쪽 판 접기",
   "button.show-end-pane": "오른쪽 판 펼치기",
   "title.unsaved-draft": "저장하지 않은 편집이 있습니다",
+  "title.id-lens": "번호로 찾기",
   "text.unsaved-draft-kept": "{minutes}분 전에 수정한 내용이 이 브라우저에 남아 있습니다.",
   "text.unsaved-draft-behind": "그 뒤에 다시 저장되었습니다. 저장할 때 충돌을 알려 드립니다.",
+  "text.id-lens-searching": "찾는 중",
+  "text.id-lens-choose": "검색어 {value}와 일치하는 대상이 {count}개입니다. 하나를 선택하십시오.",
+  "text.id-lens-forbidden": "볼 권한이 없어 찾지 않았습니다: {kinds}",
+  "text.id-lens-failed": "{kind} 정보를 불러오지 못했습니다.",
+  "text.id-lens-none": "번호가 {value} 인 대상이 없습니다.",
   "button.resume-editing": "이어서 편집",
   "button.discard": "버리기",
+  "button.find": "찾기",
+  "button.scan": "스캔",
+  "button.retry": "다시 시도",
+  "button.scan-with-camera": "카메라로 스캔",
   "figure.label.motion": "움직임",
   "figure.text.preview-needs-a-part": "부품을 추가하면 도면에 놓았을 때의 모습이 표시됩니다.",
   "error.timezone-required": "$t(term.domain) 시간대가 정해지지 않았습니다. $t(term.domain) 관리에서 시간대를 정하세요."

package/translations/ms.json

@@ -133,6 +133,7 @@
   "text.draft": "draf",
   "text.entity360-not-yet": "belum ada 360 untuk jenis ini.",
   "text.entity360-none": "tiada",
+  "text.shown-of-total": "menunjukkan {shown} daripada {total}",
   "text.entity360-forbidden": "anda tidak boleh melihat ini",
   "text.entity360-failed": "tidak dapat dibaca",
   "text.error": "Ralat",
@@ -172,6 +173,7 @@
   "label.import": "import",
   "error.address-not-allowed": "tapak ini tidak menerima sambungan dari lokasi anda. sila hubungi pentadbirnya.",
   "error.database-failed": "Pelayan tidak dapat memproses ini. Sila maklumkan kepada pentadbir anda.",
+  "error.row-tied": "{count} rekod $t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"}) terikat pada baris ini, jadi ia tidak boleh dipadam. Nyahpautkan atau padamkannya dahulu.",
   "button.undo": "buat asal",
   "button.redo": "buat semula",
   "button.fit-view": "muat ke paparan",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "sembunyikan panel kanan",
   "button.show-end-pane": "tunjukkan panel kanan",
   "title.unsaved-draft": "ada suntingan yang belum disimpan",
+  "title.id-lens": "cari mengikut nombor",
   "text.unsaved-draft-kept": "perubahan yang anda buat {minutes} minit lalu masih disimpan dalam pelayar ini.",
   "text.unsaved-draft-behind": "ia telah disimpan semula sejak itu. semasa menyimpan, anda akan dimaklumkan tentang konflik.",
+  "text.id-lens-searching": "mencari",
+  "text.id-lens-choose": "{count} padanan untuk {value} - pilih satu",
+  "text.id-lens-forbidden": "Tidak dicari - anda tidak boleh melihat: {kinds}",
+  "text.id-lens-failed": "Tidak dapat membaca {kind}",
+  "text.id-lens-none": "Tiada apa-apa bernombor {value}.",
   "button.resume-editing": "sambung menyunting",
   "button.discard": "buang",
+  "button.find": "cari",
+  "button.scan": "imbas",
+  "button.retry": "cuba lagi",
+  "button.scan-with-camera": "imbas dengan kamera",
   "figure.label.motion": "Motion",
   "figure.text.preview-needs-a-part": "tambah bahagian untuk melihat rupanya apabila diletakkan pada lukisan.",
   "error.timezone-required": "Domain tiada zon waktu. Tetapkannya dalam pengurusan domain."

package/translations/zh.json

@@ -133,6 +133,7 @@
   "text.draft": "草稿",
   "text.entity360-not-yet": "此类暂无 360 视图。",
   "text.entity360-none": "无",
+  "text.shown-of-total": "显示 {total} 个中的 {shown} 个",
   "text.entity360-forbidden": "无权查看",
   "text.entity360-failed": "无法读取",
   "text.error": "错误",
@@ -172,6 +173,7 @@
   "label.import": "导入",
   "error.address-not-allowed": "此站点不接受来自您当前位置的连接。请联系站点管理员。",
   "error.database-failed": "服务器无法处理此请求。请告知管理员。",
+  "error.row-tied": "有 {count} 条$t(label.row-tie-{kind}, {\"defaultValue\": \"{kind}\"})与此行关联，无法删除。请先解除关联或删除这些记录。",
   "button.undo": "撤销",
   "button.redo": "重做",
   "button.fit-view": "适应视图",
@@ -180,10 +182,20 @@
   "button.hide-end-pane": "收起右侧面板",
   "button.show-end-pane": "展开右侧面板",
   "title.unsaved-draft": "有未保存的编辑",
+  "title.id-lens": "按编号查找",
   "text.unsaved-draft-kept": "您 {minutes} 分钟前所做的更改仍保留在此浏览器中。",
   "text.unsaved-draft-behind": "此后已被再次保存。保存时会提示冲突。",
+  "text.id-lens-searching": "正在查找",
+  "text.id-lens-choose": "与 {value} 匹配的对象有 {count} 个，请选择一个",
+  "text.id-lens-forbidden": "无查看权限，未查找: {kinds}",
+  "text.id-lens-failed": "无法读取{kind}",
+  "text.id-lens-none": "没有编号为 {value} 的对象。",
   "button.resume-editing": "继续编辑",
   "button.discard": "放弃",
+  "button.find": "查找",
+  "button.scan": "扫描",
+  "button.retry": "重试",
+  "button.scan-with-camera": "用摄像头扫描",
   "figure.label.motion": "Motion",
   "figure.text.preview-needs-a-part": "添加部件后会显示放置到图面上的效果。",
   "error.timezone-required": "尚未设置单位时区。请在单位管理中设置时区。"