Home /Modules/philosophy/README.help-desk.md

README.help-desk.md

philosophy/module/helper/README.help-desk.md · 60 line(s) · markdown

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:

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