Metadata-Version: 2.4
Name: orderum
Version: 1.0.0
Summary: Literp Order Management Web Tool
Home-page: https://github.com/asinerum/orderum
Author: Asinerum Conlang Project
Author-email: asinerum.com@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: customerum>=1.0.8
Dynamic: license-file

# Literp Customer Order 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
```bash
pip install orderum
```

## Sample Usage [June 27, 2026]
```bash
## nano orderum.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 orderum [-p <PORT>] [-H <HOST>]
## The <PORT> is 20818 by default, but can be edited
## The <HOST> should be 127.0.0.1 for security reason
## chmod +x orderum.sh
## ./orderum.sh
```

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

(C) 2026 Asinerum Conlang Project
