billium 1.0.0__tar.gz

billium-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Asinerum Conlang Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

billium-1.0.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: billium
+Version: 1.0.0
+Summary: Literp Billing Web Tool
+Home-page: https://github.com/asinerum/billium
+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: tagrepo>=1.0.16
+Requires-Dist: invoiceum>=1.0.0
+Dynamic: license-file
+
+# Literp Billing Tool
+
+## Installation
+```bash
+pip install billium
+```
+
+## Sample Usage [Nov 1, 2026]
+```bash
+## nano billium.sh
+export LLM_TRANSFORMER_MODEL="./all-MiniLM-L6-v2"
+export SETUPKEY_ENCRYPT_SECRET="very-strong-password"
+export JWT_SECRET="very-strong-password"
+export TOKEN_EXPIRE_MINUTES=30
+export ADMIN_AUTHENTICATOR_EMAIL_LIST=someone@company.com
+export SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FILE_AVRO_DATA="./users/setupkeys.avro"
+export FILE_AVRO_FINANCE_SUPERVISORS="./users/rolefbksupervisors.avro"
+export FILE_AVRO_FINANCE_STAFF="./users/rolefbkstaff.avro"
+export FILE_AVRO_SUPERVISORS="./users/rolecrmsupervisors.avro"
+export FILE_AVRO_STAFF="./users/rolecrmstaff.avro"
+export FILE_DUCKDB_VECTOR="./temp.db"
+uvia -a vapp -m billium [-p <PORT>] [-H <HOST>]
+## The <PORT> is 21921 by default, but can be edited
+## The <HOST> should be 127.0.0.1 for security reason
+## chmod +x billium.sh
+## ./billium.sh
+```
+
+Detailed tips, tricks, and examples, can be found at project's repository
+https://github.com/asinerum/billium
+
+(C) 2026 Asinerum Conlang Project

billium-1.0.0/README.md

@@ -0,0 +1,36 @@
+# Literp Billing Tool
+
+## Installation
+```bash
+pip install billium
+```
+
+## Sample Usage [Nov 1, 2026]
+```bash
+## nano billium.sh
+export LLM_TRANSFORMER_MODEL="./all-MiniLM-L6-v2"
+export SETUPKEY_ENCRYPT_SECRET="very-strong-password"
+export JWT_SECRET="very-strong-password"
+export TOKEN_EXPIRE_MINUTES=30
+export ADMIN_AUTHENTICATOR_EMAIL_LIST=someone@company.com
+export SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FILE_AVRO_DATA="./users/setupkeys.avro"
+export FILE_AVRO_FINANCE_SUPERVISORS="./users/rolefbksupervisors.avro"
+export FILE_AVRO_FINANCE_STAFF="./users/rolefbkstaff.avro"
+export FILE_AVRO_SUPERVISORS="./users/rolecrmsupervisors.avro"
+export FILE_AVRO_STAFF="./users/rolecrmstaff.avro"
+export FILE_DUCKDB_VECTOR="./temp.db"
+uvia -a vapp -m billium [-p <PORT>] [-H <HOST>]
+## The <PORT> is 21921 by default, but can be edited
+## The <HOST> should be 127.0.0.1 for security reason
+## chmod +x billium.sh
+## ./billium.sh
+```
+
+Detailed tips, tricks, and examples, can be found at project's repository
+https://github.com/asinerum/billium
+
+(C) 2026 Asinerum Conlang Project

billium-1.0.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"

billium-1.0.0/setup.cfg

@@ -0,0 +1,31 @@
+[metadata]
+name = billium
+version = 1.0.0
+author = Asinerum Conlang Project
+author_email = asinerum.com@gmail.com
+description = Literp Billing Web Tool
+long_description = file: README.md
+long_description_content_type = text/markdown
+url = https://github.com/asinerum/billium
+license = MIT
+classifiers = 
+	Programming Language :: Python :: 3
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+
+[options]
+package_dir = 
+	= src
+packages = find:
+python_requires = >=3.7
+install_requires = 
+	tagrepo >= 1.0.16
+	invoiceum >= 1.0.0
+
+[options.packages.find]
+where = src
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

billium-1.0.0/src/billium/__init__.py

@@ -0,0 +1,3 @@
+from .bill import *
+
+__version__ = "1.0.0"

billium-1.0.0/src/billium/bill.py

@@ -0,0 +1,249 @@
+"""
+Literp Billing Tool
+Dependencies:
+  pip install [tagrepo] uvia vapp billium
+Start daemon:
+  export LLM_TRANSFORMER_MODEL="./all-MiniLM-L6-v2"
+  export SETUPKEY_ENCRYPT_SECRET="very-strong-password"
+  export JWT_SECRET="very-strong-password"
+  export TOKEN_EXPIRE_MINUTES=30
+  export ADMIN_AUTHENTICATOR_EMAIL_LIST=someone@company.com
+  export SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+  export STAFF_AUTHENTICATOR_EMAIL_LIST=""
+  export FINANCE_SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+  export FINANCE_STAFF_AUTHENTICATOR_EMAIL_LIST=""
+  export FILE_AVRO_DATA="./users/setupkeys.avro"
+  export FILE_AVRO_FINANCE_SUPERVISORS="./users/rolefbksupervisors.avro"
+  export FILE_AVRO_FINANCE_STAFF="./users/rolefbkstaff.avro"
+  export FILE_AVRO_SUPERVISORS="./users/rolecrmsupervisors.avro"
+  export FILE_AVRO_STAFF="./users/rolecrmstaff.avro"
+  export FILE_DUCKDB_VECTOR="./temp.db"
+  uvia -a vapp -m billium [-p <PORT>] [-H <HOST>]
+VAPP routes:
+  Route: /callback -> callbackpage()
+  Route: /login -> loginpage()
+  Route: /call -> callpage()
+  GET -> request.query_params = {function, access_token, jsondata, module}
+"""
+
+from invoiceum import *
+
+from .param import get_request_bill_options, get_request_payout_options
+
+from .task import *
+from .title import *
+
+APP_PORT = 21921 ## for <uvia> and <vapp>
+
+## core <uvia> functions
+
+def homepage():
+  async def submit(request: Request):
+    return HTMLResponse(Template(APP_TMP_DIRECTORY_MENU).render(
+      APP_CHARSET=APP_CHARSET,
+      APP_VIEWPORT=APP_VIEWPORT,
+      APP_TITLE=APP_DESC,
+      FORM_TITLE=FORM_TITLE,
+      directory_items=[
+        {"href": "/login", "name": LABEL_MENU_LOGIN},
+        {"href": call_function(FUNCTION_BILL_INSERT), "name": LABEL_BILL_INSERT},
+        {"href": call_function(FUNCTION_DRAFT_BILLS_SELECT), "name": LABEL_DRAFT_BILLS_SELECT},
+        {"href": call_function(FUNCTION_NO_DRAFT_BILLS_SELECT), "name": LABEL_NO_DRAFT_BILLS_SELECT},
+        {"href": call_function(FUNCTION_BILLS_REVIEW), "name": LABEL_BILLS_REVIEW},
+        {"href": call_function(FUNCTION_PAYOUT_INSERT), "name": LABEL_PAYOUT_INSERT},
+        {"href": call_function(FUNCTION_DRAFT_PAYOUTS_SELECT), "name": LABEL_DRAFT_PAYOUTS_SELECT},
+        {"href": call_function(FUNCTION_NO_DRAFT_PAYOUTS_SELECT), "name": LABEL_NO_DRAFT_PAYOUTS_SELECT},
+        {"href": call_function(FUNCTION_PAYOUTS_REVIEW), "name": LABEL_PAYOUTS_REVIEW},
+        {"href": call_function(FUNCTION_TAX_COLLECT), "name": LABEL_TAX_COLLECT},
+        {"href": call_function(FUNCTION_BILLS_SEARCH), "name": LABEL_BILLS_SEARCH},
+        {"href": call_function("logout"), "name": LABEL_MENU_LOGOUT},
+      ]
+    ))
+  return submit
+
+def callpage():
+  async def submit(request: Request):
+    return await process_function_call(request, auth_functions, HTMLResponse, _callpage)
+  return submit
+
+async def _callpage(request, func: str):
+  if func == FUNCTION_CUSTOMERS_POPUP:
+    search = request.query_params.get("search")
+    return HTMLResponse(popup_customers_page(request, search))
+  elif func == FUNCTION_PRODUCTS_POPUP:
+    search = request.query_params.get("search")
+    return HTMLResponse(popup_products_page(request, search))
+  elif func == FUNCTION_BILLS_POPUP:
+    search = request.query_params.get("search")
+    return HTMLResponse(popup_bills_page(request, search))
+  elif func == FUNCTION_TYPE_POPUP:
+    return HTMLResponse(popup_type_page(request))
+  elif func == FUNCTION_BILL_INSERT:
+    if request.method == 'GET':
+      return HTMLResponse(insert_bill_page(request))
+    else:
+      form = await request.form()
+      dated = form.get(DATED) or nowdate()
+      due = form.get(DUE) or ""
+      form = inputfilter(dstrip(form), Bills, excludes=[])
+      form[DATED] = dated
+      form[DUE] = due
+      insert = insert_bill_page(request, **form)
+      if insert == CALLBACK: return RedirectResponseGet(url=call_function(FUNCTION_BILLS_SELECT))
+      return HTMLResponse(insert)
+  elif func == FUNCTION_BILLS_SELECT:
+    return HTMLResponse(select_bills_page(request, **get_request_bill_options(request)))
+  elif func == FUNCTION_DRAFT_BILLS_SELECT:
+    return HTMLResponse(select_draft_bills_page(request, **get_request_bill_options(request)))
+  elif func == FUNCTION_NO_DRAFT_BILLS_SELECT:
+    return HTMLResponse(select_no_draft_bills_page(request, **get_request_bill_options(request)))
+  elif func == FUNCTION_BILL_SELECT:
+    bill_id = request.query_params.get("id")
+    return HTMLResponse(select_bill_page(request, bill_id))
+  elif func == FUNCTION_CUSTOMER_SELECT:
+    customer_id = request.query_params.get("id")
+    return HTMLResponse(select_customer_page(request, customer_id))
+  elif func == FUNCTION_PRODUCT_SELECT:
+    product_id = request.query_params.get("id")
+    return HTMLResponse(select_product_page(request, product_id))
+  elif func == FUNCTION_BILL_NOTE_UPDATE: ## hidden
+    bill_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(update_bill_note_page(request, bill_id))
+    else:
+      form = await request.form()
+      form = inputfilter(dstrip(form), Bills, includes=UPDATE_INPUTS["Bills"])
+      update = update_bill_note_page(request, bill_id, **form)
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_BILL_SELECT}&id={bill_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_BILL_UPDATE: ## hidden
+    bill_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(update_bill_page(request, bill_id))
+    else:
+      form = await request.form()
+      form = inputfilter(dstrip(form), Bills, includes=UPDATE_INPUTS[Bills])
+      update = update_bill_page(request, bill_id, **form)
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_BILL_SELECT}&id={bill_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_BILL_UPGRADE:
+    bill_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(upgrade_bill_page(request, bill_id))
+    else:
+      form = await request.form()
+      status = form.get(STATUS)
+      update = upgrade_bill_page(request, bill_id, status=status)
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_BILL_SELECT}&id={bill_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_BILLITEM_INSERT:
+    bill_id = request.query_params.get("bill_id")
+    if request.method == 'GET':
+      return HTMLResponse(insert_billitem_page(request, bill_id=bill_id))
+    else:
+      form = await request.form()
+      form = inputfilter(dstrip(form), Billitems, excludes=[DATED])
+      insert = insert_billitem_page(request, bill_id=bill_id, **form)
+      if insert == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_BILLITEMS_SELECT}&bill_id={bill_id}"))
+      return HTMLResponse(insert)
+  elif func == FUNCTION_BILLITEMS_SELECT:
+    bill_id = request.query_params.get("bill_id")
+    return HTMLResponse(select_billitems_page(request, bill_id))
+  elif func == FUNCTION_BILLITEM_SELECT:
+    billitem_id = request.query_params.get("id")
+    return HTMLResponse(select_billitem_page(request, billitem_id))
+  elif func == FUNCTION_BILLITEM_UPDATE: ## hidden
+    billitem_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(update_billitem_page(request, billitem_id))
+    else:
+      form = await request.form()
+      form = inputfilter(dstrip(form), Billitems, includes=UPDATE_INPUTS[Billitems])
+      update = update_billitem_page(request, billitem_id, **form) ## refresh subtotal
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_BILLITEM_SELECT}&id={billitem_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_BILLS_REVIEW:
+    if request.method == 'GET':
+      return HTMLResponse(review_bills_page(request))
+    else:
+      form = await request.form()
+      status = form.get(STATUS)
+      return RedirectResponseGet(url=call_function(f"{FUNCTION_BILLS_SELECT}&status={status}"))
+  elif func == FUNCTION_BILLS_SEARCH:
+    author = request.query_params.get("author")
+    if request.method == 'GET':
+      return HTMLResponse(search_bills_page(request))
+    else:
+      form = await request.form()
+      search = form.get("search")
+      seek = form.get("seek")
+      reset = form.get("reset")
+      search = search_bills_page(request, search=search, reset=boolean(reset), seek=seek, author=author)
+      return HTMLResponse(search)
+  elif func == FUNCTION_BILLS_AUTHOR_SEARCH: ## hidden
+    if request.method == 'GET':
+      return HTMLResponse(search_bills_author_page(request))
+    else:
+      form = await request.form()
+      search = form.get("search")
+      seek = form.get("seek")
+      reset = form.get("reset")
+      search = search_bills_author_page(request, search=search, reset=boolean(reset), seek=seek)
+      return HTMLResponse(search)
+  elif func == FUNCTION_PAYOUT_INSERT:
+    if request.method == 'GET':
+      return HTMLResponse(insert_payout_page(request))
+    else:
+      form = await request.form()
+      dated = form.get(DATED) or nowdate()
+      form = inputfilter(dstrip(form), Payouts, excludes=[])
+      form[DATED] = dated
+      insert = insert_payout_page(request, **form)
+      if insert == CALLBACK: return RedirectResponseGet(url=call_function(FUNCTION_PAYOUTS_SELECT))
+      return HTMLResponse(insert)
+  elif func == FUNCTION_PAYOUTS_SELECT:
+    return HTMLResponse(select_payouts_page(request, **get_request_payout_options(request)))
+  elif func == FUNCTION_PAYOUT_SELECT:
+    payout_id = request.query_params.get("id")
+    return HTMLResponse(select_payout_page(request, payout_id))
+  elif func == FUNCTION_PAYOUT_UPDATE: ## hidden
+    payout_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(update_payout_page(request, payout_id))
+    else:
+      form = await request.form()
+      form = inputfilter(dstrip(form), Payouts, includes=UPDATE_INPUTS[Payouts])
+      update = update_payout_page(request, payout_id, **form)
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_PAYOUT_SELECT}&id={payout_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_PAYOUT_UPGRADE:
+    payout_id = request.query_params.get("id")
+    if request.method == 'GET':
+      return HTMLResponse(upgrade_payout_page(request, payout_id))
+    else:
+      form = await request.form()
+      status = form.get(STATUS)
+      update = upgrade_payout_page(request, payout_id, status=status)
+      if update == CALLBACK: return RedirectResponseGet(url=call_function(f"{FUNCTION_PAYOUT_SELECT}&id={payout_id}"))
+      return HTMLResponse(update)
+  elif func == FUNCTION_DRAFT_PAYOUTS_SELECT:
+    return HTMLResponse(select_draft_payouts_page(request, **get_request_payout_options(request)))
+  elif func == FUNCTION_NO_DRAFT_PAYOUTS_SELECT:
+    return HTMLResponse(select_no_draft_payouts_page(request, **get_request_payout_options(request)))
+  elif func == FUNCTION_PAYOUTS_REVIEW:
+    if request.method == 'GET':
+      return HTMLResponse(review_payouts_page(request))
+    else:
+      form = await request.form()
+      status = form.get(STATUS)
+      return RedirectResponseGet(url=call_function(f"{FUNCTION_PAYOUTS_SELECT}&status={status}"))
+  elif func == FUNCTION_TAX_COLLECT:
+    if request.method == 'GET':
+      return HTMLResponse(collect_tax_bills_page(request))
+    else:
+      form = await request.form()
+      dated = form.get(DATED) or first_date_of_current_month()
+      dated_end = form.get(DATED_END) or nowdate()
+      return HTMLResponse(collect_tax_bills_page(request, dated, dated_end))
+  else:
+    return HTMLResponse("Function not found or not accessible")

billium-1.0.0/src/billium/data.py

@@ -0,0 +1,114 @@
+from tagrepo.dataframe import _get_row_html, _get_row_dict
+
+from invoiceum.data import *
+
+from .syslogin import *
+from .environ import *
+from .schema import *
+
+## data constants
+
+BILL_INSERT_FIELDS = arrayfilter(INSERT_INPUTS[Bills], excludes=[])
+BILLITEM_INSERT_FIELDS = arrayfilter(INSERT_INPUTS[Billitems], excludes=[BILL_ID, DATED, SUBTOTAL])
+PAYOUT_INSERT_FIELDS = arrayfilter(INSERT_INPUTS[Payouts], excludes=[])
+
+## selecting derivatives
+
+def calculate_bill_amount(bill_id: str) -> float:
+  df = sql_simple_query_model("Billitems", select="quantity,price,subtotal", where=f"bill_id='{bill_id}'")
+  return 0 if df is None or not len(df) else numfloat((df['quantity'] * df['price']).sum())
+
+def get_bill_name(bill_id: str) -> str:
+  return select_name_by_id(bill_id, model="Bills")
+
+def get_bill(bill_id: str) -> dict:
+  return _get_row_dict("Bills", bill_id)
+
+def select_pure_bill(bill_id: str) -> str:
+  return _get_row_html("Bills", bill_id)
+
+def select_bill(bill_id: str) -> str:
+  return select_pure_row("Bills",
+    linkfields=SELECT_LINK_FIELDS[Bills],
+    linkrefs={CUSTOMER_ID: call_function(f"{FUNCTION_CUSTOMER_SELECT}&id=")},
+    where=f"id='{bill_id}'", limit=1)
+
+def select_billitem(billitem_id: str) -> str:
+  return select_pure_row("Billitems",
+    linkfields=SELECT_LINK_FIELDS[Billitems],
+    linkrefs={BILL_ID: call_function(f"{FUNCTION_BILL_SELECT}&id="), PRODUCT_ID: call_function(f"{FUNCTION_PRODUCT_SELECT}&id=")},
+    where=f"id='{billitem_id}'", limit=1)
+
+def get_billitem(billitem_id: str) -> dict:
+  return _get_row_dict("Billitems", billitem_id)
+
+def bill_not_updatable(bill: any) -> bool:
+  if type(bill) is dict: return bill.get(STATUS) not in UPDATABLE_BILLS
+  return not check_record_exist(bill, model="Bills", field=ID, where=BILL_IS_UPDATABLE)
+
+def bill_closed(bill: any) -> bool:
+  if type(bill) is dict: return bill.get(STATUS) in CLOSED_BILLS
+  return check_record_exist(bill, model="Bills", field=ID, where=BILL_CLOSED)
+
+def bill_item_duplicated(name: str, bill_id: str) -> bool:
+  return check_record_exist(name, model="Billitems", field=NAME, where=f"bill_id='{bill_id}'")
+
+def select_payout(payout_id: str) -> str:
+  return select_pure_row("Payouts",
+    linkfields=SELECT_LINK_FIELDS[Payouts],
+    linkrefs={BILL_ID: call_function(f"{FUNCTION_BILL_SELECT}&id=")},
+    where=f"id='{payout_id}'", limit=1)
+
+def get_payout(payout_id: str) -> dict:
+  return _get_row_dict("Payouts", payout_id)
+
+def payout_not_updatable(payout: any) -> bool:
+  if type(payout) is dict: return payout.get(STATUS) not in UPDATABLE_PAYOUTS
+  return not check_record_exist(payout, model="Payouts", field=ID, where=PAYOUT_IS_UPDATABLE)
+
+def payout_closed(payout: any) -> bool:
+  if type(payout) is dict: return payout.get(STATUS) in CLOSED_PAYOUTS
+  return check_record_exist(payout, model="Payouts", field=ID, where=PAYOUT_CLOSED)
+
+## listing derivatives
+
+def list_bills(popindex: int=1, **kwargs) -> str:
+  model = "Bills"
+  show = LISTING_FIELDS[Bills][popindex:]
+  df = sql_simple_query_model(model, **kwargs)
+  return df_list_insert_rows(df, show,
+    header=LISTING_HEADERS[Bills][popindex:],
+    open_func=LISTING_LINK_BUTTON_FUNCTIONS[Bills][popindex:],
+    callfunction=LISTING_LINK_CALL_FUNCTIONS[Bills][popindex:],
+    idfield=LISTING_LINK_ID_FIELDS[Bills][popindex:],
+    linkfield=LISTING_LINK_REF_FIELDS[Bills][popindex:])
+
+def list_bills_to_insert_billitem(**kwargs) -> str:
+  return list_bills(0, **kwargs) ## remove add_item
+
+def list_billitems(bill_id: str) -> str:
+  return list_review_rows("Billitems",
+    show=LISTING_FIELDS[Billitems],
+    callfunction="select-billitem",
+    where=f"bill_id='{bill_id}'")
+
+def list_pick_bills(**kwargs) -> str:
+  return list_select_rows(model="Bills", show=SELECT_LISTING_FIELDS[Bills], header=LISTING_HEADERS["Bills"], **kwargs) ## ambiguous "Bills"
+
+def list_select_payouts(**kwargs) -> str:
+  return list_review_rows(model="Payouts", show=LISTING_FIELDS[Payouts], callfunction=FUNCTION_PAYOUT_SELECT, **kwargs)
+
+list_payouts = list_select_payouts
+
+def list_tax_bills(dated: str, dated_end: str, statuses: str=BILL_TAXABLE_STATUSES, join_clause="db_main.customer_id=db_sub.id") -> str: ## kept <db_main.customer_id> in <invoiceum.Invoices>
+  df = avro_sql_select_combo(model_main="Bills", model_sub="Customers",
+    select=f"db_main.id, db_main.dated, db_sub.name AS supplier, db_sub.{CUSTOMER_TAX_CODE} AS taxcode, db_main.tax, db_main.taxrate", ## updated <AS customer> in <invoiceum.Invoices>
+    where=f"{join_clause} AND db_main.status IN {statuses} AND db_main.dated BETWEEN '{dated}' AND '{dated_end}'",
+    sort="db_main.dated,db_sub.name", asc=True, limit=LIST_MAX_ROWS)
+  if df is None or not len(df): return NO_DATA_AVAILABLE
+  return df_list_review_rows(df, show=REVIEW_LISTING_FIELDS[Bills], callfunction=FUNCTION_BILL_SELECT)
+
+## vector search
+
+def get_search_bill_option(request, seek: str="", author: str="") -> dict:
+  return get_search_status_option(request=request, seek=seek, author=author, status_list=BILL_STATUS_LIST)

billium-1.0.0/src/billium/environ.py

@@ -0,0 +1,17 @@
+from invoiceum.environ import *
+
+set_environ('CONFIRM_BILL_COMPLETED', 'Confirm: this bill was completed?')
+set_environ('CONFIRM_BILL_CANCELLED', 'Confirm: this bill was cancelled?')
+
+set_environ('WRONG_BILL_ID', 'Error: invalid bill id')
+set_environ('BAD_BILL_ID', 'Error: invalid bill id, or bill is not updatable')
+set_environ('BILL_ITEM_DUPLICATED', 'Error: bill line item is duplicated')
+
+set_environ('BILL_NOT_EXIST', 'Warning: bill does not exist')
+set_environ('BILL_NOT_EXIST_OR_CLOSED', 'Warning: bill does not exist or was closed')
+set_environ('BILL_NO_REVERSE_TO_DRAFT', 'Warning: bill cannot be reversed to draft')
+set_environ('BILL_ALREADY_EXISTS', 'Warning: bill with this name already exists')
+
+set_environ('PAYOUT_ALREADY_EXISTS', 'Warning: payout with this name already exists')
+set_environ('PAYOUT_NOT_EXIST_OR_CLOSED', 'Warning: payout does not exist or was closed')
+set_environ('BAD_PAYOUT_ID', 'Error: invalid payout id, or payout is not updatable')

billium-1.0.0/src/billium/param.py

@@ -0,0 +1,13 @@
+from invoiceum.param import *
+
+from .schema import BILL_SORT_FIELDS, PAYOUT_SORT_FIELDS
+
+def adjust_bill_listing_options(where: str, author: str, sort: str, asc: str, limit: str, request=None) -> tuple:
+  return adjust_listing_options(where, author, sort, asc, limit, sort_fields=BILL_SORT_FIELDS, request=request)
+
+def adjust_payout_listing_options(where: str, author: str, sort: str, asc: str, limit: str, request=None) -> tuple:
+  return adjust_listing_options(where, author, sort, asc, limit, sort_fields=PAYOUT_SORT_FIELDS, request=request)
+
+get_request_bill_options = get_request_data_options ## sort:DATED.desc
+
+get_request_payout_options = get_request_data_options ## sort:DATED.desc

billium-1.0.0/src/billium/schema.py

@@ -0,0 +1,94 @@
+from invoiceum.schema import *
+
+from tagrepo.schema16 import * ## override <.15> things in <invoiceum>
+
+from .syslogin import *
+
+BILL_SORT_FIELDS = INVOICE_SORT_FIELDS
+PAYOUT_SORT_FIELDS = PAYMENT_SORT_FIELDS
+
+UPDATABLE_BILLS = UPDATABLE_INVOICES
+CLOSED_BILLS = CLOSED_INVOICES
+OPEN_BILLS = [BILL_RECEIVED, INVOICE_OVERDUE] ## USABLE
+
+BILL_CLOSED = INVOICE_CLOSED
+BILL_NOT_CLOSED = INVOICE_NOT_CLOSED
+BILL_IS_LISTABLE = INVOICE_IS_LISTABLE
+BILL_IS_UPDATABLE = INVOICE_IS_UPDATABLE
+BILL_IS_USABLE = f"status IN ('{BILL_RECEIVED}', '{INVOICE_OVERDUE}')"
+
+UPDATABLE_PAYOUTS = UPDATABLE_PAYMENTS
+CLOSED_PAYOUTS = CLOSED_PAYMENTS
+
+PAYOUT_CLOSED = PAYMENT_CLOSED
+PAYOUT_NOT_CLOSED = PAYMENT_NOT_CLOSED
+PAYOUT_IS_LISTABLE = PAYMENT_IS_LISTABLE
+PAYOUT_IS_UPDATABLE = PAYMENT_IS_UPDATABLE
+
+BILL_TAXABLE_STATUSES = f"('{BILL_RECEIVED}', '{INVOICE_OVERDUE}', '{INVOICE_PAID}')"
+
+## complex data view: use with caution
+
+REVIEW_LISTING_FIELDS |= { ## complex view
+  Bills: [HEADER_REVIEW, DATED, "supplier", "taxcode", TAXRATE, TAX], ## updated <invoiceum.Invoices>
+}
+
+LISTING_LINK_BUTTON_FUNCTIONS |= { ## complex view
+  Bills: [add_button, view_button],
+}
+
+LISTING_LINK_CALL_FUNCTIONS |= { ## complex view
+  Bills: [FUNCTION_BILLITEM_INSERT, FUNCTION_BILL_SELECT],
+}
+
+LISTING_LINK_ID_FIELDS |= { ## complex view
+  Bills: [ID, ID],
+}
+
+LISTING_LINK_REF_FIELDS |= { ## complex view
+  Bills: [BILL_ID, ID], ## add-item-line/view-item
+}
+
+## common data frame show
+
+LISTING_FIELDS |= { ## dataset viewer: all columns
+  Bills: [HEADER_INSERT, HEADER_REVIEW, DATED, NAME, AMOUNT, DISCOUNT, DUE, TAXRATE, STATUS],
+  Billitems: [HEADER_REVIEW, NAME, QUANTITY, PRICE, SUBTOTAL],
+  Payouts: [HEADER_REVIEW, DATED, NAME, AMOUNT, TYPE, REF, STATUS],
+}
+
+SELECT_LINK_FIELDS |= { ## single record viewer: vertical view with links
+  Bills: [CUSTOMER_ID],
+  Billitems: [BILL_ID, PRODUCT_ID], ## PRODUCT_ID maybe blank
+  Payouts: [BILL_ID],
+}
+
+SELECT_LISTING_FIELDS |= { ## dataset viewer for popup picker
+  Bills: [HEADER_SELECT, NAME, STATUS, ID],
+}
+
+LISTING_HEADERS |= { ## dataset viewer: headers of extra columns
+  Bills: [HEADER_INSERT, HEADER_REVIEW],
+  "Bills": HEADER_SELECT, ## popup picker
+}
+
+## common data input options
+
+INSERT_INPUTS |= {
+  Bills: [DATED, DUE, CUSTOMER_ID, NAME, AMOUNT, DISCOUNT, TAXRATE, OFFER_ID, NOTE],
+  BillsStatus: [ID, STATUS],
+  Billitems: [BILL_ID, PRODUCT_ID, DATED, NAME, QUANTITY, PRICE, SUBTOTAL, NOTE], ## PRODUCT_ID maybe blank
+  Payouts: [DATED, BILL_ID, NAME, AMOUNT, TYPE, REF, NOTE],
+}
+
+UPDATE_INPUTS |= {
+  Bills: [AUTHOR_ID, NOTE, AMOUNT, DISCOUNT, TAXRATE],
+  "Bills": [AUTHOR_ID, NOTE],
+  BillsStatus: [STATUS],
+  Billitems: [NAME, QUANTITY, PRICE, NOTE],
+  Payouts: [NAME, AUTHOR_ID, REF, TYPE, NOTE],
+}
+
+SEARCH_INPUTS |= {
+  Bills: [NAME, NOTE, AUTHOR_ID],
+}

billium-1.0.0/src/billium/syslogin.py

@@ -0,0 +1,64 @@
+from invoiceum.syslogin import *
+
+FUNCTION_BILL_INSERT = 'insert-bill'
+FUNCTION_BILL_SELECT = 'select-bill'
+FUNCTION_BILL_NOTE_UPDATE = 'note-bill' ##RES
+FUNCTION_BILL_UPDATE = 'update-bill' ##RES
+FUNCTION_BILL_UPGRADE = 'upgrade-bill'
+
+FUNCTION_BILLS_SELECT = 'select-bills'
+FUNCTION_DRAFT_BILLS_SELECT = 'select-draft-bills'
+FUNCTION_NO_DRAFT_BILLS_SELECT = 'select-no-draft-bills'
+FUNCTION_BILLS_SEARCH = 'search-bills'
+FUNCTION_BILLS_REVIEW = 'review-bills' ##HID
+FUNCTION_BILLS_UPDATE = 'update-bills' ##HID
+
+FUNCTION_BILLITEM_INSERT = 'insert-billitem'
+FUNCTION_BILLITEM_SELECT = 'select-billitem'
+FUNCTION_BILLITEM_UPDATE = 'update-billitem'
+FUNCTION_BILLITEMS_SELECT = 'select-billitems'
+
+FUNCTION_BILLS_AUTHOR_SEARCH = 'search-author-bills'
+FUNCTION_BILLS_GLOBAL_SELECT = 'select-global-bills'
+
+FUNCTION_PAYOUT_INSERT = 'insert-payout'
+FUNCTION_PAYOUT_SELECT = 'select-payout'
+FUNCTION_PAYOUT_UPDATE = 'update-payout'
+FUNCTION_PAYOUT_UPGRADE = 'upgrade-payout' ## HID
+FUNCTION_PAYOUTS_SELECT = 'select-payouts'
+FUNCTION_PAYOUTS_REVIEW = 'review-payouts'
+FUNCTION_PAYOUTS_SEARCH = 'search-payouts' ## HID
+FUNCTION_DRAFT_PAYOUTS_SELECT = 'select-draft-payouts'
+FUNCTION_NO_DRAFT_PAYOUTS_SELECT = 'select-no-draft-payouts'
+
+FUNCTION_BILLS_POPUP = 'popup-bills'
+
+auth_functions |= {
+  FUNCTION_BILL_INSERT: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILL_SELECT: {"func": check_author_login, "args": {"model": "Bills", "id": ["id"]}},
+  FUNCTION_BILL_NOTE_UPDATE: {"func": check_author_login, "args": {"model": "Bills", "id": ["id"]}},
+  FUNCTION_BILL_UPDATE: {"func": check_author_login, "args": {"model": "Bills", "id": ["id"]}},
+  FUNCTION_BILL_UPGRADE: {"func": check_author_login, "args": {"model": "Bills", "id": ["id"]}},
+  FUNCTION_BILLS_SELECT: {"func": check_staff_login, "args": {}},
+  FUNCTION_DRAFT_BILLS_SELECT: {"func": check_staff_login, "args": {}},
+  FUNCTION_NO_DRAFT_BILLS_SELECT: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLS_SEARCH: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLS_REVIEW: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLS_UPDATE: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLITEM_INSERT: {"func": check_author_login, "args": {"model": "Bills", "id": ["bill_id"]}},
+  FUNCTION_BILLITEM_SELECT: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLITEM_UPDATE: {"func": check_supervisor_login, "args": {}},
+  FUNCTION_BILLITEMS_SELECT: {"func": check_author_login, "args": {"model": "Bills", "id": ["bill_id"]}},
+  FUNCTION_BILLS_AUTHOR_SEARCH: {"func": check_staff_login, "args": {}},
+  FUNCTION_BILLS_GLOBAL_SELECT: {"func": check_staff_login, "args": {}},
+  FUNCTION_PAYOUT_INSERT: {"func": check_finance_staff_login, "args": {}},
+  FUNCTION_PAYOUT_SELECT: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_PAYOUT_UPDATE: {"func": check_finance_supervisor_login, "args": {}},
+  FUNCTION_PAYOUT_UPGRADE: {"func": check_finance_staff_login, "args": {}},
+  FUNCTION_PAYOUTS_SELECT: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_PAYOUTS_REVIEW: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_PAYOUTS_SEARCH: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_DRAFT_PAYOUTS_SELECT: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_NO_DRAFT_PAYOUTS_SELECT: {"func": [check_finance_staff_login, check_staff_login], "args": [{}, {}]},
+  FUNCTION_BILLS_POPUP: {"func": check_finance_staff_login, "args": {}},
+}

billium-1.0.0/src/billium/task.py

@@ -0,0 +1,299 @@
+from tagrepo.database import _log_insert, _log_update
+
+from invoiceum.task import *
+
+from .param import adjust_bill_listing_options, adjust_payout_listing_options
+from .template import _selecting_page_, _picking_page_
+
+from .data import *
+from .template import *
+
+def insert_bill_page(request, **form) -> str:
+  if not form.get(NAME):
+    return bill_creating_page()
+  elif not check_record_exist(form.get(CUSTOMER_ID), model="Customers", field=ID):
+    return WRONG_CUSTOMER_ID
+  elif check_record_exist(form[NAME], model="Bills"):
+    return BILL_ALREADY_EXISTS
+  elif not valid_percent(numfloat(form.get(DISCOUNT))) or not valid_percent(numfloat(form.get(TAXRATE))):
+    return BAD_INPUT_DATA
+  else:
+    form[AUTHOR_ID] = request.session.get(SESSION_USER)
+    refresh_form_data_tax(form)
+    insert = safe_avro_file_insert("Bills", multi=True, **form)
+    if not insert: return FAILED_SAVE_DATA
+    _log_insert(request, form, "Bills")
+    return CALLBACK
+
+def select_bills_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = BILL_NOT_CLOSED if status not in BILL_STATUS_LIST else f"status IN ('{status}')"
+  where, sort, asc, limit = adjust_bill_listing_options(where, author, sort, asc, limit, request=request)
+  return bills_listing_page(
+    title=BILLS_LISTING_TITLE,
+    action=f"{FUNCTION_BILLS_SELECT}&status={status}&author={request.session.get(SESSION_USER)}",
+    content=list_bills(where=where, sort=sort, asc=asc, limit=limit))
+
+def select_draft_bills_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = BILL_IS_UPDATABLE
+  where, sort, asc, limit = adjust_bill_listing_options(where, author, sort, asc, limit, request=request)
+  return draft_bills_listing_page(
+    title=DRAFT_BILLS_LISTING_TITLE,
+    action=f"{FUNCTION_DRAFT_BILLS_SELECT}&author={request.session.get(SESSION_USER)}",
+    content=list_bills_to_insert_billitem(where=where, sort=sort, asc=asc, limit=limit))
+
+def select_no_draft_bills_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = BILL_IS_LISTABLE
+  where, sort, asc, limit = adjust_bill_listing_options(where, author, sort, asc, limit, request=request)
+  return no_draft_bills_listing_page(
+    title=NO_DRAFT_BILLS_LISTING_TITLE,
+    action=f"{FUNCTION_NO_DRAFT_BILLS_SELECT}&author={request.session.get(SESSION_USER)}",
+    content=list_bills(where=where, sort=sort, asc=asc, limit=limit))
+
+def select_bill_page(request, bill_id: str) -> str:
+  ## <request> is reserved
+  return bill_selecting_page(
+    (select_bill(bill_id) or NO_DATA_AVAILABLE)
+    + html_link_buttons([call_function(f"{FUNCTION_BILLITEM_INSERT}&bill_id={bill_id}")], [LABEL_CREATE_BILLITEM_BUTTON], [STYLE_SUBMIT_BUTTON])
+    + html_link_buttons([call_function(f"{FUNCTION_BILLITEMS_SELECT}&bill_id={bill_id}")], [LABEL_SELECT_BILLITEM_BUTTON], [STYLE_SUBMIT_BUTTON])
+    + html_link_buttons([call_function(f"{FUNCTION_BILL_UPGRADE}&id={bill_id}")], [LABEL_UPGRADE_BILL_BUTTON], [STYLE_CANCEL_BUTTON]))
+
+def update_bill_note_page(request, bill_id: str, **form) -> str:
+  data = get_bill(bill_id)
+  if not data: return NO_DATA_AVAILABLE
+  if not len(form):
+    return bill_updating_page(
+      title=item_content_title(BILL_UPDATING_TITLE, data[NAME]),
+      action=f"{FUNCTION_BILL_NOTE_UPDATE}&id={bill_id}",
+      content=dictfilter(data, UPDATE_INPUTS["Bills"])) ## notes updated only
+  update = safe_avro_file_update("Bills", id=bill_id, **form)
+  if not update: return FAILED_SAVE_DATA
+  _log_update(request, form, "Bills", id=bill_id)
+  return CALLBACK
+
+def update_bill_page(request, bill_id: str, **form) -> str:
+  data = get_bill(bill_id)
+  if not data: return NO_DATA_AVAILABLE
+  if bill_not_updatable(data): return BAD_BILL_ID
+  if not len(form):
+    return bill_updating_page(
+      title=item_content_title(BILL_UPDATING_TITLE, data[NAME]),
+      action=f"{FUNCTION_BILL_UPDATE}&id={bill_id}",
+      content=dictfilter(data, UPDATE_INPUTS[Bills]))
+  refresh_form_data_tax(form)
+  update = safe_avro_file_update("Bills", id=bill_id, **form)
+  if not update: return FAILED_SAVE_DATA
+  _log_update(request, form, "Bills", id=bill_id)
+  return CALLBACK
+
+def upgrade_bill_page(request, bill_id: str, status: str=None) -> str:
+  if not status:
+    data = get_bill(bill_id)
+    if not data: return NO_DATA_AVAILABLE
+    return bill_upgrading_page(
+      title=item_content_title(BILL_UPDATING_TITLE, data[NAME]),
+      current_status=data[STATUS])
+  upgrade = update_close_bill_page(request, bill_id, complete_status=status)
+  return upgrade if upgrade not in [DONE_SAVE_DATA] else CALLBACK
+
+def update_close_bill_page(request, bill_id: str, complete_status: str=None) -> str:
+  data = get_bill(bill_id)
+  if not data: return NO_DATA_AVAILABLE
+  if bill_closed(data): return BILL_NOT_EXIST_OR_CLOSED
+  if complete_status not in BILL_STATUS_LIST:
+    status = BILL_CANCELLED
+  else:
+    status = complete_status
+  if status in UPDATABLE_BILLS: return BILL_NO_REVERSE_TO_DRAFT
+  amount = calculate_bill_amount(bill_id=bill_id)
+  data[AMOUNT] = amount
+  refresh_form_data_tax(data)
+  tax = data[TAX]
+  update = safe_avro_file_update("Bills", id=bill_id, status=status, amount=amount, tax=tax)
+  if not update: return FAILED_SAVE_DATA
+  insert = safe_avro_file_insert("BillsStatus", multi=False, id=bill_id, status=status)
+  if not insert: return FAILED_COMMIT_TRANSACTION
+  return DONE_SAVE_DATA ## dont edit this return
+
+## short form of <orderum.select_product_page>
+def select_product_page(request, product_id: str) -> str:
+  return product_selecting_page(select_product(product_id) or NO_DATA_AVAILABLE)
+
+def insert_billitem_page(request, bill_id: str, **form) -> str:
+  if bill_not_updatable(bill_id): return BAD_BILL_ID
+  if not form.get(NAME):
+    bill_name = get_bill_name(bill_id)
+    return billitem_creating_page(
+      title=sub_item_content_title(BILLITEMS_CREATING_TITLE, bill_name, f"{FUNCTION_BILL_SELECT}&id={bill_id}"),
+      action=f"{FUNCTION_BILLITEM_INSERT}&bill_id={bill_id}")
+  elif bill_item_duplicated(form.get(NAME), bill_id):
+    return BILL_ITEM_DUPLICATED
+  else:
+    form[BILL_ID] = bill_id
+    refresh_form_data_subtotal(form)
+    insert = safe_avro_file_insert("Billitems", multi=True, **form)
+    if not insert: return FAILED_SAVE_DATA
+    _log_insert(request, form, "Billitems")
+    return CALLBACK
+
+def select_billitems_page(request, bill_id: str) -> str:
+  ## <request> is reserved
+  if valid_uuid(bill_id):
+    bill_name = get_bill_name(bill_id)
+    if not bill_name: return BILL_NOT_EXIST
+    return billitems_listing_page(
+      title=sub_item_content_title(BILLITEMS_LISTING_TITLE, bill_name, f"{FUNCTION_BILL_SELECT}&id={bill_id}"),
+      action=f"{FUNCTION_BILLITEM_INSERT}&bill_id={bill_id}",
+      content=list_billitems(bill_id))
+  return MISSING_INPUT_DATA
+
+def select_billitem_page(request, billitem_id: str) -> str:
+  ## <request> is reserved
+  return billitem_selecting_page(select_billitem(billitem_id) or NO_DATA_AVAILABLE)
+
+def update_billitem_page(request, billitem_id: str, **form) -> str:
+  data = get_billitem(billitem_id)
+  if not data: return NO_DATA_AVAILABLE
+  if bill_not_updatable(data[BILL_ID]): return BAD_BILL_ID
+  if not len(form):
+    bill_name = get_bill_name(data[BILL_ID])
+    return billitem_updating_page(
+      title=sub_item_content_title(BILLITEM_UPDATING_TITLE, bill_name, f"{FUNCTION_BILL_SELECT}&id={data[BILL_ID]}"),
+      action=f"{FUNCTION_BILLITEM_UPDATE}&id={billitem_id}",
+      content=dictfilter(data, UPDATE_INPUTS[Billitems]))
+  refresh_form_data_subtotal(form)
+  update = safe_avro_file_update("Billitems", id=billitem_id, **form)
+  if not update: return FAILED_SAVE_DATA
+  _log_update(request, form, "Billitems", id=billitem_id)
+  return CALLBACK
+
+def review_bills_page(request) -> str:
+  ## <request> is reserved
+  return bills_reviewing_page(BILLS_LISTING_TITLE)
+
+def search_bills_page(request, search: str=None, reset=False, seek: str="", author: str="") -> str:
+  if not search:
+    return bills_searching_page()
+  return bills_fetching_page(request, search, reset=reset, seek=seek, author=author)
+
+def search_bills_author_page(request, search: str=None, reset=False, seek: str="") -> str:
+  if not search:
+    return bills_author_searching_page()
+  return bills_author_fetching_page(request, search, reset=reset, seek=seek)
+
+def insert_payout_page(request, **form) -> str:
+  if not form.get(NAME) or numfloat(form.get(AMOUNT)) <= 0:
+    return payout_creating_page()
+  elif not check_record_exist(form.get(BILL_ID), model="Bills", field=ID):
+    return WRONG_BILL_ID
+  elif check_record_exist(form[NAME], model="Payouts"):
+    return PAYOUT_ALREADY_EXISTS
+  else:
+    form[AUTHOR_ID] = request.session.get(SESSION_USER)
+    insert = safe_avro_file_insert("Payouts", multi=True, **form)
+    if not insert: return FAILED_SAVE_DATA
+    _log_insert(request, form, "Payouts")
+    return CALLBACK
+
+def compact_select_bills_page() -> str:
+  return _selecting_page_(BILLS_LISTING_TITLE,
+    list_pick_bills(where=BILL_IS_USABLE, sort=NAME, limit=LIST_MAX_ROWS)
+    + select_bill_button())
+
+def compact_fetch_bills_page(search: str) -> str:
+  return _selecting_page_(BILLS_SEARCHING_TITLE,
+    vector_select_search(search, SEARCH_INPUTS, SEARCH_RESULTS, model="Bills")
+    + select_bill_button())
+
+def popup_bills_page(request, search: str) -> str:
+  ## <request> is reserved
+  if search: return compact_fetch_bills_page(search)
+  return compact_select_bills_page()
+
+def select_payouts_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = PAYOUT_NOT_CLOSED if status not in PAYOUT_STATUS_LIST else f"status IN ('{status}')"
+  where, sort, asc, limit = adjust_payout_listing_options(where, author, sort, asc, limit, request=request)
+  return payouts_listing_page(
+    title=PAYOUTS_LISTING_TITLE,
+    action=f"{FUNCTION_PAYOUTS_SELECT}&status={status}&author={request.session.get(SESSION_USER)}",
+    content=list_payouts(where=where, sort=sort, asc=asc, limit=limit))
+
+def select_payout_page(request, payout_id: str) -> str:
+  ## <request> is reserved
+  return payout_selecting_page(
+    (select_payout(payout_id) or NO_DATA_AVAILABLE)
+    + html_link_buttons([call_function(f"{FUNCTION_PAYOUT_UPGRADE}&id={payout_id}")], [LABEL_UPGRADE_PAYOUT_BUTTON], [STYLE_CANCEL_BUTTON]))
+
+def update_payout_page(request, payout_id: str, **form) -> str:
+  data = get_payout(payout_id)
+  if not data: return NO_DATA_AVAILABLE
+  if payout_not_updatable(data): return BAD_PAYOUT_ID
+  if not len(form):
+    return payout_updating_page(
+      title=item_content_title(PAYOUT_UPDATING_TITLE, data[NAME]),
+      action=f"{FUNCTION_PAYOUT_UPDATE}&id={payout_id}",
+      content=dictfilter(data, UPDATE_INPUTS[Payouts]))
+  update = safe_avro_file_update("Payouts", id=payout_id, **form)
+  if not update: return FAILED_SAVE_DATA
+  _log_update(request, form, "Payouts", id=payout_id)
+  return CALLBACK
+
+def upgrade_payout_page(request, payout_id: str, status: str=None) -> str:
+  if not status:
+    data = get_payout(payout_id)
+    if not data: return NO_DATA_AVAILABLE
+    return payout_upgrading_page(
+      title=item_content_title(PAYOUT_UPDATING_TITLE, data[NAME]),
+      current_status=data[STATUS])
+  upgrade = update_close_payout_page(request, payout_id, complete_status=status)
+  return upgrade if upgrade not in [DONE_SAVE_DATA] else CALLBACK
+
+def update_close_payout_page(request, payout_id: str, complete_status: str=None) -> str:
+  data = get_payout(payout_id)
+  if not data: return NO_DATA_AVAILABLE
+  if payout_closed(data): return PAYOUT_NOT_EXIST_OR_CLOSED
+  if complete_status not in PAYOUT_STATUS_LIST:
+    status = PAYOUT_CANCELLED
+  else:
+    status = complete_status
+  update = safe_avro_file_update("Payouts", id=payout_id, status=status)
+  if not update: return FAILED_SAVE_DATA
+  insert = safe_avro_file_insert("PayoutsStatus", multi=False, id=payout_id, status=status)
+  if not insert: return FAILED_COMMIT_TRANSACTION
+  return DONE_SAVE_DATA ## dont edit this return
+
+def popup_type_page(request) -> str:
+  ## <request> is reserved
+  return compact_select_type_page(TYPE_PICKING_TITLE, LABEL_TYPE_PICKING_BUTTON)
+
+def compact_select_type_page(title, pick_button, picker=TYPE, pick_data=PAYOUT_TYPE_LIST, opener_getter="") -> str:
+  data = escape_punctuation_for_title_list(pick_data)
+  ## module <tagrepo.datatemp> must be upgraded to use <schema15> libs
+  return _picking_page_(title, data, pick_button, picker=picker, getter=opener_getter)
+
+def select_draft_payouts_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = PAYOUT_IS_UPDATABLE
+  where, sort, asc, limit = adjust_payout_listing_options(where, author, sort, asc, limit, request=request)
+  return draft_payouts_listing_page(
+    title=DRAFT_PAYOUTS_LISTING_TITLE,
+    action=f"{FUNCTION_DRAFT_PAYOUTS_SELECT}&author={request.session.get(SESSION_USER)}",
+    content=list_payouts(where=where, sort=sort, asc=asc, limit=limit))
+
+def select_no_draft_payouts_page(request, status: str="", sort: str="", asc: str="", limit: str="", author: str="") -> str:
+  where = PAYOUT_IS_LISTABLE
+  where, sort, asc, limit = adjust_payout_listing_options(where, author, sort, asc, limit, request=request)
+  return no_draft_payouts_listing_page(
+    title=NO_DRAFT_PAYOUTS_LISTING_TITLE,
+    action=f"{FUNCTION_NO_DRAFT_PAYOUTS_SELECT}&author={request.session.get(SESSION_USER)}",
+    content=list_payouts(where=where, sort=sort, asc=asc, limit=limit))
+
+def review_payouts_page(request) -> str:
+  ## <request> is reserved
+  return payouts_reviewing_page(PAYOUTS_LISTING_TITLE)
+
+def _date_range_fieldset(labels: list=[LABEL_TAX_START, LABEL_TAX_END], legend: str=LABEL_TAX_RANGE_INPUT_PARAMS) -> str:
+  return html_input_date_range_fieldset(DATED, DATED, labels=labels, legend=legend)
+
+def collect_tax_bills_page(request, dated: str=None, dated_end: str=None) -> str:
+  ## <request> is reserved
+  if not dated: return tax_bills_collecting_open_page(_date_range_fieldset())
+  return tax_bills_collecting_page(list_tax_bills(dated=dated, dated_end=dated_end))

billium-1.0.0/src/billium/template.py

@@ -0,0 +1,140 @@
+from tagrepo.datatemp import _creating_page, _selecting_page, _listing_page, _updating_page, _searching_page, _upgrading_page, _reviewing_page, _fetching_page, _picking_page
+
+from invoiceum.template import *
+
+from .data import *
+from .title import *
+
+## private functions
+
+def _upgrading_page_(title, current_status, status_id="BILL_STATUS_LIST") -> str:
+  return _upgrading_page(title, current_status, status_id, app_desc=APP_DESC)
+
+def _reviewing_page_(title, status_id="BILL_STATUS_LIST") -> str:
+  return _reviewing_page(title, status_id=status_id, app_desc=APP_DESC)
+
+def _fetching_page_(request, search: str, reset: bool=False, title: str=BILLS_SEARCHING_TITLE, model: str="Bills", callfunction: str=FUNCTION_BILL_SELECT, seek: str="", app_desc: str=APP_DESC, search_inputs: dict=SEARCH_INPUTS, search_results: int=SEARCH_RESULTS, search_option=get_search_author_option) -> str:
+  return _fetching_page(request, search, reset=reset, title=title, model=model, callfunction=callfunction, seek=seek, app_desc=app_desc, search_inputs=search_inputs, search_results=search_results, search_option=search_option)
+
+def _selecting_page_(title, content) -> str:
+  return _selecting_page(title, content, app_desc=APP_DESC)
+
+def _listing_page_(title, action, content, submit_button) -> str:
+  return _listing_page(title, action, content, submit_button, app_desc=APP_DESC)
+
+def _updating_page_(title, action, content: dict) -> str:
+  return _updating_page(title, action, content, app_desc=APP_DESC)
+
+def _searching_page_(title, search_id="AUTHOR_SEARCH_OPTIONS") -> str:
+  return _searching_page(title, search_id, app_desc=APP_DESC)
+
+def _picking_page_(title: str, content: list[dict], pick_button: str, picker: str, getter=NAME) -> str:
+  return _picking_page(title=title, content=content, pick_button=pick_button, picker=picker, getter=getter, app_desc=APP_DESC)
+
+## public functions
+
+def bill_creating_page() -> str:
+  return _creating_page(
+    title=BILLS_CREATING_TITLE,
+    action=FUNCTION_BILL_INSERT,
+    model="Bills",
+    input_label=LABEL_BILL_INPUT_PARAMS,
+    input_fields=BILL_INSERT_FIELDS,
+    app_desc=APP_DESC,
+    onsubmit=html_form_onsubmit(ARE_YOU_SURE),
+    customer_id=html_popup_input_wide_text(CUSTOMER_ID, CUSTOMER_ID, "customer_id", label=LABEL_BILL_CUSTOMER_ID, popup_page=FUNCTION_CUSTOMERS_POPUP),
+    dated=html_input_date(DATED, DATED, LABEL_BILL_DATED),
+    due=html_input_date(DUE, DUE, LABEL_BILL_DUE),
+    note=html_input_textarea(NOTE, NOTE))
+
+def bills_listing_page(title: str, action: str, content: str, label: str=LABEL_SELECT_OWN_BILL_BUTTON) -> str:
+  return _listing_page_(title, action, content, submit_button=label)
+
+draft_bills_listing_page = bills_listing_page
+no_draft_bills_listing_page = bills_listing_page
+
+def bill_selecting_page(content: str) -> str:
+  return _selecting_page_(title=BILL_INFO_TITLE, content=content)
+
+bill_updating_page = _updating_page_
+
+def bill_upgrading_page(title: str, current_status: str) -> str:
+  return _upgrading_page_(title=title, current_status=current_status, status_id="BILL_STATUS_LIST")
+
+def billitem_creating_page(title: str, action: str) -> str:
+  return _creating_page(
+    title=title,
+    action=action,
+    model="Billitems",
+    input_label=LABEL_BILLITEM_INPUT_PARAMS,
+    input_fields=BILLITEM_INSERT_FIELDS,
+    app_desc=APP_DESC,
+    product_id=html_popup_input_wide_text(PRODUCT_ID, PRODUCT_ID, "product_id", label=LABEL_BILLITEM_PRODUCT_ID, popup_page=FUNCTION_PRODUCTS_POPUP),
+    note=html_input_textarea(NOTE, NOTE))
+
+def billitems_listing_page(title: str, action: str, content: str, label: str=LABEL_CREATE_BILLITEM_BUTTON) -> str:
+  return _listing_page_(title, action, content, submit_button=label)
+
+def billitem_selecting_page(content: str) -> str:
+  return _selecting_page_(title=BILLITEM_INFO_TITLE, content=content)
+
+billitem_updating_page = _updating_page_
+
+def bills_reviewing_page(title: str) -> str:
+  return _reviewing_page_(title)
+
+## vector search
+
+def bills_searching_page() -> str:
+  return _searching_page_(title=BILLS_SEARCHING_TITLE, search_id="BILL_SEARCH_OPTIONS")
+
+def bills_fetching_page(request, search: str, reset: bool=False, seek: str="", author: str="") -> str:
+  return _fetching_page_(request, search, reset=reset, seek=seek, search_option=get_search_bill_option(request, seek, author=author))
+
+def bills_author_searching_page() -> str:
+  return _searching_page_(title=BILLS_SEARCHING_TITLE)
+
+def bills_author_fetching_page(request, search: str, reset: bool=False, seek: str="") -> str:
+  return _fetching_page_(request, search, reset=reset, seek=seek, title=BILLS_SEARCHING_TITLE, model="Bills", callfunction=FUNCTION_BILL_SELECT)
+
+## bill payouts
+
+def payout_creating_page() -> str:
+  return _creating_page(
+    title=PAYOUTS_CREATING_TITLE,
+    action=FUNCTION_PAYOUT_INSERT,
+    model="Payouts",
+    input_label=LABEL_PAYOUT_INPUT_PARAMS,
+    input_fields=PAYOUT_INSERT_FIELDS,
+    app_desc=APP_DESC,
+    onsubmit=html_form_onsubmit(ARE_YOU_SURE),
+    bill_id=html_popup_input_wide_text(BILL_ID, BILL_ID, "bill_id", label=LABEL_PAYOUT_BILL_ID, popup_page=FUNCTION_BILLS_POPUP),
+    type=html_select_options(TYPE, PAYOUT_TYPES, list_captioning("PAYOUT_TYPES")),
+    dated=html_input_date(DATED, DATED, LABEL_PAYOUT_DATED),
+    note=html_input_textarea(NOTE, NOTE))
+
+def select_bill_button() -> str:
+  return html_pass_buttons([BILL_ID], [ID], [LABEL_SELECT_BILL_BUTTON], [STYLE_SUBMIT_BUTTON])
+
+def payouts_listing_page(title: str, action: str, content: str, label: str=LABEL_SELECT_OWN_PAYOUT_BUTTON) -> str:
+  return _listing_page_(title, action, content, submit_button=label)
+
+def payout_selecting_page(content: str) -> str:
+  return _selecting_page_(title=PAYOUT_INFO_TITLE, content=content)
+
+payout_updating_page = _updating_page_
+
+def payout_upgrading_page(title: str, current_status: str) -> str:
+  return _upgrading_page_(title=title, current_status=current_status, status_id="PAYOUT_STATUS_LIST")
+
+draft_payouts_listing_page = payouts_listing_page
+no_draft_payouts_listing_page = payouts_listing_page
+
+def payouts_reviewing_page(title: str) -> str:
+  return _reviewing_page_(title, status_id="PAYOUT_STATUS_LIST")
+
+def tax_bills_collecting_open_page(content: str) -> str:
+  return _listing_page_(BILLS_TAX_LISTING_TITLE, FUNCTION_TAX_COLLECT, content, LABEL_SUBMIT_BUTTON)
+
+def tax_bills_collecting_page(content: str) -> str:
+  return _selecting_page_(title=BILLS_TAX_TITLE, content=content)

billium-1.0.0/src/billium/title.py

@@ -0,0 +1,71 @@
+from invoiceum.title import *
+
+APP_DESC = 'Literp Billing Management'
+
+set_environ('FORM_TITLE', 'Billing Management')
+
+set_environ('LABEL_BILL_INSERT', 'Add Bill')
+set_environ('LABEL_BILLS_SELECT', 'List Bills')
+set_environ('LABEL_DRAFT_BILLS_SELECT', 'Fill Bills')
+set_environ('LABEL_NO_DRAFT_BILLS_SELECT', 'Browse Bills')
+set_environ('LABEL_BILLS_REVIEW', 'Review Bills')
+set_environ('LABEL_PAYOUT_INSERT', 'Add Payout')
+set_environ('LABEL_PAYOUTS_SELECT', 'List Payouts')
+set_environ('LABEL_DRAFT_PAYOUTS_SELECT', 'Approve Payouts')
+set_environ('LABEL_NO_DRAFT_PAYOUTS_SELECT', 'Browse Payouts')
+set_environ('LABEL_PAYOUTS_REVIEW', 'Review Payouts')
+set_environ('LABEL_TAX_COLLECT', 'Taxes Deductible') ## updated <invoiceum>
+set_environ('LABEL_BILLS_SEARCH', 'Bills')
+
+set_environ('LABEL_UPGRADE_BILL_BUTTON', 'Update Bill Status')
+set_environ('LABEL_SELECT_OWN_BILL_BUTTON', 'List My Bills')
+set_environ('LABEL_CREATE_BILLITEM_BUTTON', 'Add Bill Item')
+set_environ('LABEL_SELECT_BILLITEM_BUTTON', 'List Bill Items')
+set_environ('LABEL_SELECT_BILL_BUTTON', 'Pick Selected')
+
+set_environ('LABEL_BILL_INPUT_PARAMS', 'Bill metadata')
+set_environ('LABEL_BILL_CUSTOMER_ID', 'Customer ID')
+set_environ('LABEL_BILL_DATED', 'Issue Date')
+set_environ('LABEL_BILL_DUE', 'Due Date')
+set_environ('LABEL_BILLITEM_PRODUCT_ID', 'Product ID')
+set_environ('LABEL_BILLITEM_INPUT_PARAMS', 'Bill item info')
+
+set_environ('BILLS_CREATING_TITLE', 'Bills Creating')
+set_environ('BILLS_LISTING_TITLE', 'Bills Listing')
+set_environ('DRAFT_BILLS_LISTING_TITLE', 'Draft Bills Listing')
+set_environ('NO_DRAFT_BILLS_LISTING_TITLE', 'Live Bills Listing')
+
+set_environ('BILLS_SEARCHING_TITLE', 'Bills Searching')
+set_environ('BILL_INFO_TITLE', 'Bill Detailed Information')
+set_environ('BILL_UPDATING_TITLE', 'Bill Info Update')
+
+set_environ('BILLITEMS_CREATING_TITLE', 'Bill Items Creating')
+set_environ('BILLITEMS_LISTING_TITLE', 'Bill Items Listing')
+set_environ('BILLITEM_INFO_TITLE', 'Bill Item Information')
+set_environ('BILLITEM_UPDATING_TITLE', 'Bill Item Update')
+
+set_environ('LABEL_PAYOUT_INPUT_PARAMS', 'Payout metadata')
+set_environ('LABEL_PAYOUT_BILL_ID', 'Bill ID')
+set_environ('LABEL_PAYOUT_DATED', 'Payout Date')
+
+set_environ('LABEL_UPGRADE_PAYOUT_BUTTON', 'Update Payout Status')
+set_environ('LABEL_SELECT_OWN_PAYOUT_BUTTON', 'List My Payouts')
+
+set_environ('PAYOUTS_CREATING_TITLE', 'Payouts Creating')
+set_environ('PAYOUTS_LISTING_TITLE', 'Payouts Listing')
+set_environ('DRAFT_PAYOUTS_LISTING_TITLE', 'Draft Payouts Listing')
+set_environ('NO_DRAFT_PAYOUTS_LISTING_TITLE', 'Live Payouts Listing')
+
+set_environ('PAYOUT_INFO_TITLE', 'Payout Detailed Information')
+set_environ('PAYOUT_UPDATING_TITLE', 'Payout Info Update')
+
+## TYPE_PICKING_TITLE
+## LABEL_TYPE_PICKING_BUTTON
+
+set_environ('LABEL_TAX_RANGE_INPUT_PARAMS', 'Taxable bill date range') ## updated <invoiceum>
+
+## LABEL_TAX_START
+## LABEL_TAX_END
+
+set_environ('BILLS_TAX_LISTING_TITLE', 'Taxes Deductible Listing')
+set_environ('BILLS_TAX_TITLE', 'Taxes Deductible')

billium-1.0.0/src/billium.egg-info/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: billium
+Version: 1.0.0
+Summary: Literp Billing Web Tool
+Home-page: https://github.com/asinerum/billium
+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: tagrepo>=1.0.16
+Requires-Dist: invoiceum>=1.0.0
+Dynamic: license-file
+
+# Literp Billing Tool
+
+## Installation
+```bash
+pip install billium
+```
+
+## Sample Usage [Nov 1, 2026]
+```bash
+## nano billium.sh
+export LLM_TRANSFORMER_MODEL="./all-MiniLM-L6-v2"
+export SETUPKEY_ENCRYPT_SECRET="very-strong-password"
+export JWT_SECRET="very-strong-password"
+export TOKEN_EXPIRE_MINUTES=30
+export ADMIN_AUTHENTICATOR_EMAIL_LIST=someone@company.com
+export SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_SUPERVISOR_AUTHENTICATOR_EMAIL_LIST=""
+export FINANCE_STAFF_AUTHENTICATOR_EMAIL_LIST=""
+export FILE_AVRO_DATA="./users/setupkeys.avro"
+export FILE_AVRO_FINANCE_SUPERVISORS="./users/rolefbksupervisors.avro"
+export FILE_AVRO_FINANCE_STAFF="./users/rolefbkstaff.avro"
+export FILE_AVRO_SUPERVISORS="./users/rolecrmsupervisors.avro"
+export FILE_AVRO_STAFF="./users/rolecrmstaff.avro"
+export FILE_DUCKDB_VECTOR="./temp.db"
+uvia -a vapp -m billium [-p <PORT>] [-H <HOST>]
+## The <PORT> is 21921 by default, but can be edited
+## The <HOST> should be 127.0.0.1 for security reason
+## chmod +x billium.sh
+## ./billium.sh
+```
+
+Detailed tips, tricks, and examples, can be found at project's repository
+https://github.com/asinerum/billium
+
+(C) 2026 Asinerum Conlang Project

billium-1.0.0/src/billium.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+src/billium/__init__.py
+src/billium/bill.py
+src/billium/data.py
+src/billium/environ.py
+src/billium/param.py
+src/billium/schema.py
+src/billium/syslogin.py
+src/billium/task.py
+src/billium/template.py
+src/billium/title.py
+src/billium.egg-info/PKG-INFO
+src/billium.egg-info/SOURCES.txt
+src/billium.egg-info/dependency_links.txt
+src/billium.egg-info/requires.txt
+src/billium.egg-info/top_level.txt

billium-1.0.0/src/billium.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

billium-1.0.0/src/billium.egg-info/requires.txt

@@ -0,0 +1,2 @@
+tagrepo>=1.0.16
+invoiceum>=1.0.0

billium-1.0.0/src/billium.egg-info/top_level.txt

@@ -0,0 +1 @@
+billium