Literp Customer Service Web Tool

Purpose

• This tiny tool (working as a web daemon) helps people to manage their small community of users.
• The users are created manually by an administrator, and about to receive emails with their secret setup keys which can be added to modern authenticator apps.
• After being created, a new user can log in the community portal with TOTP authenticator code.
• The tool includes: user listing, creating, deleting routines. The user-creating routine allows administrators add new user name and email, then automatically send notification email.
• The automatic email sending uses Google mail API under administrators Gmail account.

Installation

pip install customerum

Sample Usage [June 27, 2026]

## nano customerum.sh
export SETUPKEY_ENCRYPT_SECRET="very-strong-password"
export JWT_SECRET="very-strong-password"
export TOKEN_EXPIRE_MINUTES=30
export ADMIN_AUTHENTICATOR_EMAIL_LIST="EMAIL_LIST_SEPARATED_BY_COMMA"
export SUPERVISOR_AUTHENTICATOR_EMAIL_LIST="EMAIL_LIST_SEPARATED_BY_COMMA"
export STAFF_AUTHENTICATOR_EMAIL_LIST="EMAIL_LIST_SEPARATED_BY_COMMA"
export SENDER_GMAIL_ADDRESS="YOUR_WORKING_GMAIL_ADDRESS"
export SENDER_GMAIL_APP_PWD="YOUR_WORKING_GMAIL_APP_PWD"
export FILE_AVRO_CRM_SUPERVISORS="../users/rolecrmsupervisors.avro"
export FILE_AVRO_CRM_STAFF="../users/rolecrmstaff.avro"
export FILE_AVRO_DATA="../users/setupkeys.avro"
export FILE_DUCKDB_VECTOR="./temp.db"
uvia -a vapp -m customerum [-p <PORT>] [-H <HOST>]
## The <PORT> is 11718 by default, but can be edited
## The <HOST> should be 127.0.0.1 for security reason
## chmod +x customerum.sh
## ./customerum.sh

Detailed tips, tricks, and examples, can be found at project's repository https://github.com/asinerum/customerum

(C) 2026 Asinerum Conlang Project