@things-factory/organization 10.1.218 → 10.1.222

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/organization",
-  "version": "10.1.218",
+  "version": "10.1.222",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -41,5 +41,5 @@
     "@things-factory/contact": "^10.1.218",
     "@things-factory/shell": "^10.1.208"
   },
-  "gitHead": "b4e60fdfe307cecebb2264267f616749a502d5fe"
+  "gitHead": "afdd6a9b1c8b440e39d4fec48bfbad1a0c02fccc"
 }

package/tests/audience.test.ts

@@ -0,0 +1,85 @@
+/**
+ * Whom an audience names (ADR-0163 decision 2) - the one rule a shared dashboard card and an announcement ask.
+ */
+import { audienceReaches, audienceTargetRefusal, departmentsOfEmployees, withAncestors, withDescendants } from '../server/service/audience/audience'
+
+/* 본부 > 영업팀 > 영업1파트, and 경영지원 on its own. */
+const TREE = new Map<string, string | null>([
+  ['hq', null],
+  ['sales', 'hq'],
+  ['sales-1', 'sales'],
+  ['admin', null]
+])
+
+const member = (departmentIds: string[], roleIds: string[] = []) => ({ userId: 'u-me', domainId: 'd1', departmentIds, roleIds })
+
+describe('who an audience reaches', () => {
+  it('★ the domain, a person, a department one stands in, a role one holds - and no one else', () => {
+    const me = member(['sales'], ['role-hr'])
+    expect(audienceReaches([{ scope: 'DOMAIN', targetId: 'd1' }], me)).toBe(true)
+    expect(audienceReaches([{ scope: 'DOMAIN', targetId: 'd2' }], me)).toBe(false)
+    expect(audienceReaches([{ scope: 'USER', targetId: 'u-me' }], me)).toBe(true)
+    expect(audienceReaches([{ scope: 'USER', targetId: 'u-other' }], me)).toBe(false)
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'sales' }], me)).toBe(true)
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'admin' }], me)).toBe(false)
+    expect(audienceReaches([{ scope: 'ROLE', targetId: 'role-hr' }], me)).toBe(true)
+    expect(audienceReaches([{ scope: 'ROLE', targetId: 'role-finance' }], me)).toBe(false)
+    expect(audienceReaches([], me)).toBe(false)
+  })
+
+  it('★ a department reaches the people of the departments under it (the user, 2026-10-26), not those above or beside', () => {
+    const inPart = member(withAncestors(['sales-1'], TREE))
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'hq' }], inPart)).toBe(true)
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'sales' }], inPart)).toBe(true)
+    const inTeam = member(withAncestors(['sales'], TREE))
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'sales-1' }], inTeam)).toBe(false)
+    expect(audienceReaches([{ scope: 'DEPARTMENT', targetId: 'admin' }], inTeam)).toBe(false)
+  })
+
+  it('a person without a user or a domain is reached by nothing', () => {
+    expect(audienceReaches([{ scope: 'DOMAIN', targetId: 'd1' }], { userId: '', domainId: 'd1', departmentIds: [], roleIds: [] })).toBe(false)
+  })
+})
+
+describe('the department tree', () => {
+  it('★ up from a department to the top, and down to every department under it', () => {
+    expect(withAncestors(['sales-1'], TREE).sort()).toEqual(['hq', 'sales', 'sales-1'])
+    expect(withDescendants(['hq'], TREE).sort()).toEqual(['hq', 'sales', 'sales-1'])
+    expect(withDescendants(['admin'], TREE)).toEqual(['admin'])
+  })
+
+  it('a loop in the tree ends the walk', () => {
+    const loop = new Map<string, string | null>([
+      ['a', 'b'],
+      ['b', 'a']
+    ])
+    expect(withAncestors(['a'], loop).sort()).toEqual(['a', 'b'])
+    expect(withDescendants(['a'], loop).sort()).toEqual(['a', 'b'])
+  })
+
+  it('★ only active employee records count, and a record without a department adds none', () => {
+    expect(
+      departmentsOfEmployees([
+        { active: true, department: { id: 'sales' } },
+        { active: false, department: { id: 'admin' } },
+        { active: null, department: { id: 'hq' } },
+        { active: true, department: null },
+        { active: true, department: { id: 'sales' } }
+      ])
+    ).toEqual(['sales'])
+  })
+})
+
+describe('what may be addressed', () => {
+  const domain = { domainId: 'd1', departmentIds: ['hq', 'sales'], roleIds: ['role-hr'] }
+  it('★ a known scope with a target of this domain', () => {
+    expect(audienceTargetRefusal({ scope: 'DOMAIN', targetId: 'd1' }, domain)).toBeUndefined()
+    expect(audienceTargetRefusal({ scope: 'DOMAIN', targetId: 'd2' }, domain)).toBe('another-domain')
+    expect(audienceTargetRefusal({ scope: 'DEPARTMENT', targetId: 'sales' }, domain)).toBeUndefined()
+    expect(audienceTargetRefusal({ scope: 'DEPARTMENT', targetId: 'elsewhere' }, domain)).toBe('unknown-department')
+    expect(audienceTargetRefusal({ scope: 'ROLE', targetId: 'role-hr' }, domain)).toBeUndefined()
+    expect(audienceTargetRefusal({ scope: 'ROLE', targetId: 'role-x' }, domain)).toBe('unknown-role')
+    expect(audienceTargetRefusal({ scope: 'TEAM', targetId: 'x' }, domain)).toBe('unknown-scope')
+    expect(audienceTargetRefusal({ scope: 'USER', targetId: '' }, domain)).toBe('no-target')
+  })
+})