Feat/contacts #2

2026-10-23T16:12:34-05:00

iamdoubz commented

2026-10-23 16:12:34 -05:00

Contact and Contract people management integrations

Contact and [Contract](https://github.com/arvarik/contrack) people management integrations

iamdoubz added 6 commits 2026-10-23 16:12:34 -05:00

spec: contacts (11), Simple or Contrack, picked at setup 32f4590369

Owner decisions 2026-10-23: vCard import for admins and users; desk-phone caller name while
ringing is its own task (C4); the company is one Contrack account shown to everyone, each user
has their own; sharing offers a copy the colleague accepts or denies; imports skip duplicates.

contacts: my book, the company book, vCard/CSV import, sharing with Accept/Deny a754974a90

C1 (spec 11): /api/me/contacts and /api/contacts (admin), our own vCard 2.1/3.0/4.0 and CSV
readers with a preview, contact_shares (migration 0009) for offers, and contact names in call
history, voicemail, Home, the softphone and the call report email. Admin → Contacts.

contacts: Contrack as the robust contacts (C3), picked in Settings or the setup wizard

ci / check (push) Successful in 1m0s

Details

ci / images (push) Successful in 32s

Details

692dd59552

Spec 11 §4: contacts.provider and contacts.contrack (local address only, company token
write-only), each person's own token (users.contrack_token_enc, migration 0010) in My settings,
books read from Contrack with a 5-minute cache, Add to contacts and accepted shares created in
Contrack, the company account on desk phones. Setup wizard step 8 Contacts. deploy/contrack
(2.0.2, pinned), Caddy/nginx blocks, decision 0003, admin guide Contacts. Tested against a fake
and a real Contrack 2.0.2 (contrack-live.test.ts).

contacts: caller names on desk phones while they ring (C4)

ci / check (push) Successful in 1m2s

Details

ci / images (push) Successful in 22s

Details

b05361e840

Spec 11 §6.1: sp-sub-dial-user asks /api/internal/caller-name (func_curl, 2 s at most; this
machine only, with an APP_SECRET-derived key, not logged) for the ringing user's name for the
caller, and sets it on each ringing leg (pre-dial handler, CONNECTEDLINE), never on the call, so
forwards and other members don't see someone else's contacts. Ring group/queue/number prefixes
kept. Contrack lookups never wait (cache, contactsWarm every 5 min). Proven on real Asterisk
with baresip: apps/api/test/asterisk/cnam-test.ts.

contacts: calls on the Contrack timeline, summaries opt-in (C5)

ci / check (push) Successful in 1m7s

Details

ci / images (push) Successful in 20s

Details

e6a1373f36

Spec 11 §4.4: the contrackLog job puts each connected person's calls with their Contrack
contacts on that contact's timeline once (contrack_call_log, migration 0011), from when they
connected. With summaries on (My settings → Contacts, needs call summaries), the escaped summary
and action items go in, and the first action item becomes a follow-up due the next day. Waits up
to 30 min for a summary; Contrack down is retried, refusals noted once. Tested against a fake and
a real Contrack 2.0.2.

contacts: owners' contacts on their desk phones, copy builtin contacts to Contrack (C6)

ci / check (push) Successful in 1m2s

Details

ci / images (push) Successful in 20s

Details

ci / check (pull_request) Successful in 1m4s

Details

ci / images (pull_request) Successful in 5s

Details

604e40adf1

Spec 11 §6.2: a phone's directory is the extensions, its owner's own contacts (accepted shares
included), then the company's, in both modes. In Contrack mode, contacts from before Contrack
are offered for copying (contrack.toCopy, POST …/copy-to-contrack: one Contrack bulk import,
skipping what's already there; the builtin rows stay). Tested against a fake and a real
Contrack 2.0.2.

iamdoubz merged commit 53aefaa5d7 into main

2026-10-23 16:14:19 -05:00

iamdoubz deleted branch feat/contacts

2026-10-23 16:14:19 -05:00

iamdoubz referenced this issue from a commit

2026-10-28 16:45:13 -05:00

security: sign-in by email and connecting accounts (08 §7 #1 #2 #5 #8)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: spng/selfphoneng#2