Help / reach-out desk (C + C++)
A premium reach-out subsystem: a user submits a Question or Query, and the program lists the respondents who can address it — Management, co-series authors, telegenically-aware authors, mayors, and city spokespersons — with each respondent's reach channels and whether they are alive and known of Science.
Data boundary (read this)
This library ships no real personal contact data. The bundled directory is synthetic placeholder data on reserved, non-routable ranges:
- emails at
example.com/example.org(RFC 2606), - phone numbers in the fictitious
555-01xxblock, - IPs in
192.0.2.0/24,198.51.100.0/24,203.0.113.0/24(RFC 5737).
The library performs no network I/O — it never emails, calls, or connects
to any IP or port; it only stores and lists records. Load your own real,
authorized contacts later through sl_help_desk_add_contact /
HelpDesk::addContact (that is the loader seam); the placeholder generator is
only for demos and tests.
What a contact has
id, name, organization, email, phone, remote_ip + remote_port,
role, a channel bitmask (email / phone / remote), topic_tags, and two status
flags: alive and known_of_science.
Roles: management, co-series author, telegenically-aware author, mayor, city spokesperson.
Query → respondents → status
sl_help_desk_query (C) and HelpDesk::ask (C++) match the query terms,
case-insensitively, against each contact's name, organization, role, and topic
tags, rank by number of terms matched, and return respondents carrying their
alive / known_of_science status. *_query_role / askRole filter to one
role.
The C++ wrapper is inheritable: override reachable() to apply policy.
ScienceHelpDesk demonstrates a policy that surfaces only living respondents
known of Science.
Sizing and scaling
Built to hold about 500 contacts for a company of ~1000 (both are
constructor parameters). Query matching is a single linear scan — O(n) in
the number of contacts — so cost scales linearly with directory size. The
reported total reflects the whole directory even when only a small result
window is requested.
Build, test, run
make make test ./build/help-example-c "city transit mayor" # query from argv echo "research science methods" | ./build/help-example-c ./build/help-example-cpp