@zeyos/client 0.2.0 → 0.4.0

package/okf/entities/stocktransactions.md

@@ -0,0 +1,72 @@
+---
+type: ZeyOS Entity
+title: Stock Transactions
+description: Inventory movements.
+resource: zeyos://api/stocktransactions
+tags: [commerce, generated]
+api_backed: true
+list_operation: listStockTransactions
+visibility_column: false
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | bigint | no | — | yes | — |
+| `creator` | integer | yes | — | — | — |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `item` | integer | no | — | yes | [items](/entities/items.md) |
+| `storage` | integer | yes | — | yes | [storages](/entities/storages.md) |
+| `transaction` | integer | yes | — | yes | [transactions](/entities/transactions.md) |
+| `transfer` | bigint | yes | — | yes | [stocktransactions](/entities/stocktransactions.md) |
+| `flag` | smallint | no | `0` | — | — |
+| `date` | bigint | no | `date_part('epoch', now())` | yes | — |
+| `chargenum` | text | no | `''` | yes | — |
+| `location` | text | no | `''` | — | — |
+| `reference` | text | no | `''` | yes | — |
+| `amount` | double precision | no | — | — | — |
+| `sellingprice` | double precision | no | `0` | — | — |
+| `purchaseprice` | double precision | no | `0` | — | — |
+| `serials` | text[] | yes | — | yes | — |
+| `subtransactions` | bigint[] | yes | — | — | — |
+
+# Foreign Keys
+
+- `item` → [items](/entities/items.md) (`items.ID`)
+- `storage` → [storages](/entities/storages.md) (`storages.ID`)
+- `transaction` → [transactions](/entities/transactions.md) (`transactions.ID`)
+- `transfer` → [stocktransactions](/entities/stocktransactions.md) (`stocktransactions.ID`)
+
+# Enums
+
+### `flag`
+
+`0` = BOOKED · `1` = RESERVED · `2` = CANCELLED
+
+# Indexes
+
+- `fk_stocktransactions_item` — btree on `item`
+- `fk_stocktransactions_storage` — gin, partial on `storage`
+- `fk_stocktransactions_transaction` — btree, partial on `transaction`
+- `i_stocktransactions_date` — btree on `date`
+- `i_stocktransactions_reservations` — btree, partial on `transaction`
+- `i_stocktransactions_serials` — gin, partial on `serials`
+- `s_stocktransactions_chargenum` — gin, partial on `chargenum`
+- `s_stocktransactions_reference` — gin, partial on `reference`
+- `s_stocktransactions_serials` — gin, partial on `f_safe_array_to_string(serials, ' ')`
+- `u_stocktransactions_transfer` — btree, unique, partial on `transfer`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listStockTransactions`
+- get: `getStockTransaction`
+- create: `createStockTransaction`
+- update: `updateStockTransaction`
+- delete: `deleteStockTransaction`
+- exists: `existsStockTransaction`
+<!-- okf:generated:end -->

package/okf/entities/storages.md

@@ -0,0 +1,56 @@
+---
+type: ZeyOS Entity
+title: Storages
+description: Inventory storage locations.
+resource: zeyos://api/storages
+tags: [commerce, generated]
+api_backed: true
+list_operation: listStorages
+visibility_column: true
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `fork` | integer | yes | — | yes | [forks](/entities/forks.md) |
+| `ownergroup` | integer | yes | — | yes | [groups](/entities/groups.md) |
+| `creator` | integer | yes | — | — | — |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `visibility` | smallint | no | `0` | — | — |
+| `name` | text | no | — | yes | — |
+| `description` | text | no | `''` | — | — |
+
+# Foreign Keys
+
+- `fork` → [forks](/entities/forks.md) (`forks.ID`)
+- `ownergroup` → [groups](/entities/groups.md) (`groups.ID`)
+
+# Enums
+
+### `visibility`
+
+`0` = REGULAR · `1` = ARCHIVED · `2` = DELETED
+
+# Indexes
+
+- `fk_storages_fork` — gin, partial on `fork`
+- `fk_storages_ownergroup` — gin on `ownergroup`
+- `i_storages_nofork` — gin, partial on `fork`
+- `i_storages_noowner` — gin, partial on `ownergroup`
+- `s_storages_name` — gin on `name`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listStorages`
+- get: `getStorage`
+- create: `createStorage`
+- update: `updateStorage`
+- delete: `deleteStorage`
+- exists: `existsStorage`
+<!-- okf:generated:end -->

package/okf/entities/suppliers.md

@@ -0,0 +1,51 @@
+---
+type: ZeyOS Entity
+title: Suppliers
+description: Supplier-to-item links.
+resource: zeyos://api/suppliers
+tags: [commerce, generated]
+api_backed: true
+list_operation: listSuppliers
+visibility_column: false
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | bigint | no | — | yes | — |
+| `creator` | integer | yes | — | — | — |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `item` | integer | no | — | yes | [items](/entities/items.md) |
+| `account` | integer | no | — | yes | [accounts](/entities/accounts.md) |
+| `itemnum` | text | no | `''` | yes | — |
+| `price` | double precision | yes | — | — | — |
+| `taxrate` | double precision | yes | — | — | — |
+| `minamount` | double precision | no | `0` | — | — |
+| `deliverytime` | smallint | yes | — | — | — |
+| `stock` | double precision | yes | — | — | — |
+
+# Foreign Keys
+
+- `item` → [items](/entities/items.md) (`items.ID`)
+- `account` → [accounts](/entities/accounts.md) (`accounts.ID`)
+
+# Indexes
+
+- `fk_suppliers_account` — gin on `account`
+- `s_suppliers_itemnum` — gin, partial on `itemnum`
+- `u_suppliers_item_account` — btree, unique on `item, account`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listSuppliers`
+- get: `getSupplier`
+- create: `createSupplier`
+- update: `updateSupplier`
+- delete: `deleteSupplier`
+- exists: `existsSupplier`
+<!-- okf:generated:end -->

package/okf/entities/tasks.md

@@ -0,0 +1,86 @@
+---
+type: ZeyOS Entity
+title: Tasks
+description: Actionable delivery work.
+resource: zeyos://api/tasks
+tags: [work, generated]
+api_backed: true
+list_operation: listTasks
+visibility_column: true
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `fork` | integer | yes | — | yes | [forks](/entities/forks.md) |
+| `owneruser` | integer | yes | — | yes | [users](/entities/users.md) |
+| `ownergroup` | integer | yes | — | yes | [groups](/entities/groups.md) |
+| `creator` | integer | yes | — | — | — |
+| `assigneduser` | integer | yes | — | yes | [users](/entities/users.md) |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `davserver` | integer | yes | — | yes | [davservers](/entities/davservers.md) |
+| `ticket` | integer | yes | — | yes | [tickets](/entities/tickets.md) |
+| `project` | integer | yes | — | yes | [projects](/entities/projects.md) |
+| `visibility` | smallint | no | `0` | — | — |
+| `name` | text | no | — | yes | — |
+| `tasknum` | text | no | `''` | yes | — |
+| `datefrom` | bigint | yes | — | — | — |
+| `duedate` | bigint | yes | — | — | — |
+| `status` | smallint | no | `0` | — | — |
+| `priority` | smallint | no | `2` | — | — |
+| `projectedeffort` | integer | no | `0` | — | — |
+| `description` | text | no | `''` | — | — |
+
+# Foreign Keys
+
+- `fork` → [forks](/entities/forks.md) (`forks.ID`)
+- `owneruser` → [users](/entities/users.md) (`users.ID`)
+- `ownergroup` → [groups](/entities/groups.md) (`groups.ID`)
+- `assigneduser` → [users](/entities/users.md) (`users.ID`)
+- `davserver` → [davservers](/entities/davservers.md) (`davservers.ID`)
+- `ticket` → [tickets](/entities/tickets.md) (`tickets.ID`)
+- `project` → [projects](/entities/projects.md) (`projects.ID`)
+
+# Enums
+
+### `visibility`
+
+`0` = REGULAR · `1` = ARCHIVED · `2` = DELETED
+
+### `status`
+
+`0` = NOTSTARTED · `1` = AWAITINGACCEPTANCE · `2` = ACCEPTED · `3` = REJECTED · `4` = ACTIVE · `5` = INACTIVE · `6` = FEEDBACKREQUIRED · `7` = TESTING · `8` = CANCELLED · `9` = COMPLETED · `10` = FAILED · `11` = BOOKED
+
+### `priority`
+
+`0` = LOWEST · `1` = LOW · `2` = MEDIUM · `3` = HIGH · `4` = HIGHEST
+
+# Indexes
+
+- `fk_tasks_assigneduser` — gin, partial on `assigneduser`
+- `fk_tasks_davserver` — gin, partial on `davserver`
+- `fk_tasks_fork` — gin, partial on `fork`
+- `fk_tasks_ownergroup` — gin, partial on `ownergroup`
+- `fk_tasks_owneruser` — gin, partial on `owneruser`
+- `fk_tasks_project` — gin, partial on `project`
+- `fk_tasks_ticket` — btree, partial on `ticket`
+- `i_tasks_nofork` — gin, partial on `fork`
+- `i_tasks_noowner` — gin, partial on `ownergroup`
+- `s_tasks_name` — gin on `name`
+- `s_tasks_tasknum` — gin, partial on `tasknum`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listTasks`
+- get: `getTask`
+- create: `createTask`
+- update: `updateTask`
+- delete: `deleteTask`
+- exists: `existsTask`
+<!-- okf:generated:end -->

package/okf/entities/tickets.md

@@ -0,0 +1,86 @@
+---
+type: ZeyOS Entity
+title: Tickets
+description: Support or service work items.
+resource: zeyos://api/tickets
+tags: [work, generated]
+api_backed: true
+list_operation: listTickets
+visibility_column: true
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `fork` | integer | yes | — | yes | [forks](/entities/forks.md) |
+| `ownergroup` | integer | yes | — | yes | [groups](/entities/groups.md) |
+| `creator` | integer | yes | — | — | — |
+| `assigneduser` | integer | yes | — | yes | [users](/entities/users.md) |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `account` | integer | yes | — | yes | [accounts](/entities/accounts.md) |
+| `project` | integer | yes | — | yes | [projects](/entities/projects.md) |
+| `visibility` | smallint | no | `0` | — | — |
+| `name` | text | no | — | yes | — |
+| `ticketnum` | text | no | `''` | yes | — |
+| `date` | bigint | no | `date_part('epoch', now())` | yes | — |
+| `duedate` | bigint | yes | — | — | — |
+| `status` | smallint | no | `0` | — | — |
+| `priority` | smallint | no | `2` | — | — |
+| `description` | text | no | `''` | — | — |
+| `billingitems` | json | yes | — | — | — |
+| `procurementitems` | json | yes | — | — | — |
+
+# Foreign Keys
+
+- `fork` → [forks](/entities/forks.md) (`forks.ID`)
+- `ownergroup` → [groups](/entities/groups.md) (`groups.ID`)
+- `assigneduser` → [users](/entities/users.md) (`users.ID`)
+- `account` → [accounts](/entities/accounts.md) (`accounts.ID`)
+- `project` → [projects](/entities/projects.md) (`projects.ID`)
+
+# Enums
+
+### `visibility`
+
+`0` = REGULAR · `1` = ARCHIVED · `2` = DELETED
+
+### `status`
+
+`0` = NOTSTARTED · `1` = AWAITINGACCEPTANCE · `2` = ACCEPTED · `3` = REJECTED · `4` = ACTIVE · `5` = INACTIVE · `6` = FEEDBACKREQUIRED · `7` = TESTING · `8` = CANCELLED · `9` = COMPLETED · `10` = FAILED · `11` = BOOKED
+
+### `priority`
+
+`0` = LOWEST · `1` = LOW · `2` = MEDIUM · `3` = HIGH · `4` = HIGHEST
+
+# Indexes
+
+- `fk_tickets_account` — btree, partial on `account`
+- `fk_tickets_assigneduser` — gin, partial on `assigneduser`
+- `fk_tickets_fork` — gin, partial on `fork`
+- `fk_tickets_ownergroup` — gin on `ownergroup`
+- `fk_tickets_project` — gin, partial on `project`
+- `i_tickets_date` — btree on `date`
+- `i_tickets_nofork` — gin, partial on `fork`
+- `i_tickets_noowner` — gin, partial on `ownergroup`
+- `s_tickets_name` — gin on `name`
+- `s_tickets_ticketnum` — gin, partial on `ticketnum`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listTickets`
+- get: `getTicket`
+- create: `createTicket`
+- update: `updateTicket`
+- delete: `deleteTicket`
+- exists: `existsTicket`
+<!-- okf:generated:end -->
+
+# Notes
+
+Closed = `status` IN [9 (COMPLETED), 11 (BOOKED)]. Filter time windows on the indexed `date` field, not `creationdate`/`lastmodified` (unindexed → HTTP 503). Has a `visibility` column. `priority`: 0=LOWEST…4=HIGHEST.

package/okf/entities/transactions.md

@@ -0,0 +1,118 @@
+---
+type: ZeyOS Entity
+title: Transactions
+description: Billing, procurement, or production business transactions.
+resource: zeyos://api/transactions
+tags: [billing, generated]
+api_backed: true
+list_operation: listTransactions
+visibility_column: false
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `fork` | integer | yes | — | yes | [forks](/entities/forks.md) |
+| `ownergroup` | integer | yes | — | yes | [groups](/entities/groups.md) |
+| `creator` | integer | yes | — | — | — |
+| `assigneduser` | integer | yes | — | yes | [users](/entities/users.md) |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `account` | integer | yes | — | yes | [accounts](/entities/accounts.md) |
+| `item` | integer | yes | — | yes | [items](/entities/items.md) |
+| `contract` | integer | yes | — | yes | [contracts](/entities/contracts.md) |
+| `transactionnum` | text | no | — | yes | — |
+| `type` | smallint | no | `0` | yes | — |
+| `date` | bigint | no | `date_part('epoch', now())` | yes | — |
+| `duedate` | bigint | yes | — | — | — |
+| `status` | smallint | no | `0` | — | — |
+| `calculation` | smallint | no | `0` | — | — |
+| `productionfactor` | integer | yes | — | — | — |
+| `currency` | character varying(3) | no | — | — | — |
+| `exchangerate` | double precision | no | `1` | — | — |
+| `taxid` | text | no | `''` | — | — |
+| `shippingrecipient` | text | no | `''` | — | — |
+| `shippingaddress` | text | no | `''` | — | — |
+| `shippingpostalcode` | text | no | `''` | — | — |
+| `shippingcity` | text | no | `''` | — | — |
+| `shippingregion` | text | no | `''` | — | — |
+| `shippingcountry` | character varying(2) | no | `''` | — | — |
+| `billingrecipient` | text | no | `''` | — | — |
+| `billingaddress` | text | no | `''` | — | — |
+| `billingpostalcode` | text | no | `''` | — | — |
+| `billingcity` | text | no | `''` | — | — |
+| `billingregion` | text | no | `''` | — | — |
+| `billingcountry` | character varying(2) | no | `''` | — | — |
+| `sellertaxid` | text | no | `''` | — | — |
+| `sellername` | text | no | `''` | — | — |
+| `selleraddress` | text | no | `''` | — | — |
+| `sellerpostalcode` | text | no | `''` | — | — |
+| `sellercity` | text | no | `''` | — | — |
+| `sellerregion` | text | no | `''` | — | — |
+| `sellercountry` | character varying(2) | no | `''` | — | — |
+| `discount` | double precision | no | `0` | — | — |
+| `netamount` | double precision | no | `0` | — | — |
+| `tax` | double precision | no | `0` | — | — |
+| `margin` | double precision | no | `0` | — | — |
+| `weight` | double precision | no | `0` | — | — |
+| `items` | json | yes | — | — | — |
+
+# Foreign Keys
+
+- `fork` → [forks](/entities/forks.md) (`forks.ID`)
+- `ownergroup` → [groups](/entities/groups.md) (`groups.ID`)
+- `assigneduser` → [users](/entities/users.md) (`users.ID`)
+- `account` → [accounts](/entities/accounts.md) (`accounts.ID`)
+- `item` → [items](/entities/items.md) (`items.ID`)
+- `contract` → [contracts](/entities/contracts.md) (`contracts.ID`)
+
+# Enums
+
+### `type`
+
+`0` = BILLING_QUOTE · `1` = BILLING_ORDER · `2` = BILLING_DELIVERY · `3` = BILLING_INVOICE · `4` = BILLING_CREDIT · `5` = PROCUREMENT_REQUEST · `6` = PROCUREMENT_ORDER · `7` = PROCUREMENT_DELIVERY · `8` = PROCUREMENT_INVOICE · `9` = PROCUREMENT_CREDIT · `10` = PRODUCTION_FABRICATION · `11` = PRODUCTION_DISASSEMBLY
+
+### `status`
+
+`0` = DRAFT · `1` = BOOKED · `2` = HOLD · `3` = CANCELLED · `4` = CLOSED · `5` = PARTLYORDERED · `6` = PARTLYORDERED_CANCELLED · `7` = PARTLYORDERED_CLOSED · `8` = ORDERED · `9` = PARTLYDELIVERED · `10` = PARTLYDELIVERED_CANCELLED · `11` = PARTLYDELIVERED_CLOSED · `12` = DELIVERED · `13` = PARTLYINVOICED · `14` = PARTLYINVOICED_CANCELLED · `15` = PARTLYINVOICED_CLOSED · `16` = INVOICED · `17` = PARTLYPAID · `18` = PARTLYPAID_CANCELLED · `19` = PARTLYPAID_CLOSED · `20` = PAID · `21` = OVERPAID · `22` = PROCESSED · `23` = PROCESSED_CANCELLED
+
+### `calculation`
+
+`0` = NET · `1` = GROSS · `2` = EXACT · `3` = LEGACY · `4` = EXTERNAL
+
+# Indexes
+
+- `fk_transactions_account` — btree, partial on `account`
+- `fk_transactions_assigneduser` — gin, partial on `assigneduser`
+- `fk_transactions_contract` — btree, partial on `contract`
+- `fk_transactions_fork` — gin, partial on `fork`
+- `fk_transactions_item` — btree, partial on `item`
+- `fk_transactions_ownergroup` — gin on `ownergroup`
+- `i_transactions_billing_date` — btree, partial on `date`
+- `i_transactions_collection_date` — btree, partial on `date`
+- `i_transactions_nofork` — gin, partial on `fork`
+- `i_transactions_noowner` — gin, partial on `ownergroup`
+- `i_transactions_procurement_date` — btree, partial on `date`
+- `i_transactions_production_date` — btree, partial on `date`
+- `i_transactions_transactionnum` — btree on `transactionnum`
+- `s_transactions_transactionnum` — gin on `transactionnum`
+- `u_transactions_transactionnum_type` — btree, unique, partial on `transactionnum, type`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listTransactions`
+- get: `getTransaction`
+- create: `createTransaction`
+- update: `updateTransaction`
+- delete: `deleteTransaction`
+- exists: `existsTransaction`
+<!-- okf:generated:end -->
+
+# Notes
+
+NO `visibility` column — adding `"visibility":0` to a filter 400s. Use `type` 3=billing invoice, 4=billing credit. Use `netamount` for invoiced revenue; sum client-side (no server-side SUM). Use `date` for period reporting.

package/okf/entities/users.md

@@ -0,0 +1,66 @@
+---
+type: ZeyOS Entity
+title: Users
+description: System users.
+resource: zeyos://api/users
+tags: [platform, generated]
+api_backed: true
+list_operation: listUsers
+visibility_column: false
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `creator` | integer | yes | — | — | — |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `contact` | integer | yes | — | yes | [contacts](/entities/contacts.md) |
+| `activity` | smallint | no | `0` | — | — |
+| `name` | text | no | — | yes | — |
+| `email` | text | no | — | yes | — |
+| `nopublic` | smallint | no | `0` | — | — |
+| `apionly` | smallint | no | `0` | — | — |
+| `expdate` | bigint | yes | — | — | — |
+| `password` | text | no | `''` | — | — |
+| `resetlogintoken` | bytea | yes | — | — | — |
+| `persistentlogintoken` | bytea | yes | — | yes | — |
+| `signature` | bytea | yes | — | — | — |
+| `description` | text | no | `''` | — | — |
+| `otpsecret` | bytea | yes | — | — | — |
+| `settings` | json | yes | — | — | — |
+
+# Foreign Keys
+
+- `contact` → [contacts](/entities/contacts.md) (`contacts.ID`)
+
+# Enums
+
+### `activity`
+
+`0` = ACTIVE · `1` = DEACTIVATED · `2` = DELETED
+
+# Indexes
+
+- `fk_users_contact` — btree, partial on `contact`
+- `s_users_email` — gin on `email`
+- `s_users_name` — gin on `name`
+- `u_users_email` — btree, unique on `lower(email)`
+- `u_users_name` — btree, unique on `lower(name)`
+- `u_users_persistentlogintoken` — btree, unique, partial on `persistentlogintoken`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listUsers`
+- get: `getUser`
+- exists: `existsUser`
+<!-- okf:generated:end -->
+
+# Notes
+
+Resolve assignees/ownership here; user names may not match contact names.

package/okf/entities/weblets.md

@@ -0,0 +1,66 @@
+---
+type: ZeyOS Entity
+title: Weblets
+description: UI modules with view/type metadata.
+resource: zeyos://api/weblets
+tags: [platform, generated]
+api_backed: true
+list_operation: listWeblets
+visibility_column: false
+---
+
+<!-- okf:generated:start — rewritten by scripts/generate-okf.mjs; do not edit by hand -->
+# Schema
+
+| Column | Type | Nullable | Default | Indexed | FK |
+|---|---|---|---|---|---|
+| `ID` | integer | no | — | yes | — |
+| `creator` | integer | yes | — | — | — |
+| `creationdate` | bigint | no | `date_part('epoch', now())` | — | — |
+| `lastmodified` | bigint | no | `date_part('epoch', now())` | — | — |
+| `application` | integer | yes | — | yes | [applications](/entities/applications.md) |
+| `activity` | smallint | no | `0` | — | — |
+| `name` | text | no | — | yes | — |
+| `identifier` | character varying(200) | no | — | yes | — |
+| `view` | text | no | `''` | — | — |
+| `type` | smallint | no | `0` | — | — |
+| `width` | smallint | no | `0` | — | — |
+| `height` | smallint | no | `0` | — | — |
+| `svgpath` | text | no | `''` | — | — |
+| `color` | character varying(6) | no | `''` | — | — |
+| `mimetype` | text | no | `'text/x-zymba'` | — | — |
+| `langaliases` | json | yes | — | — | — |
+| `binfile` | integer | yes | — | yes | [binfiles](/entities/binfiles.md) |
+| `url` | text | no | `''` | — | — |
+
+# Foreign Keys
+
+- `application` → [applications](/entities/applications.md) (`applications.ID`)
+- `binfile` → [binfiles](/entities/binfiles.md) (`binfiles.ID`)
+
+# Enums
+
+### `activity`
+
+`0` = ACTIVE · `1` = DEACTIVATED · `2` = DELETED
+
+### `type`
+
+`0` = INTEGRATED · `1` = STANDALONE · `2` = DETACHED · `3` = POPUP_FRAMED · `4` = POPUP_PLAIN · `5` = EMBEDDED_FRAMED · `6` = EMBEDDED_COLLAPSED · `7` = EMBEDDED_PLAIN
+
+# Indexes
+
+- `fk_weblets_application` — gin, partial on `application`
+- `fk_weblets_binfile` — btree, partial on `binfile`
+- `s_weblets_identifier` — gin on `identifier`
+- `s_weblets_name` — gin on `name`
+- `u_weblets_identifier` — btree, unique on `identifier`
+
+> Partial/GIN indexes back the `filters` (plural) query form for foreign-key fields. See [filters-vs-filter](/concepts/filters-vs-filter.md).
+
+# Operations
+
+- list: `listWeblets`
+- get: `getWeblet`
+- exists: `existsWeblet`
+<!-- okf:generated:end -->

package/okf/index.md

@@ -0,0 +1,11 @@
+---
+okf_version: 0.1
+source_snapshot: 19d7df6ae9aa
+---
+
+# ZeyOS Knowledge Bundle
+
+* [Entities](entities/) - 64 API-backed entity concepts (schema, foreign keys, enums, indexes, operations).
+* [Metrics](metrics/) - Business metric definitions.
+* [Playbooks](playbooks/) - Step-by-step query workflows.
+* [Concepts](concepts/) - Cross-cutting query rules and footguns.

package/okf/log.md

@@ -0,0 +1,4 @@
+# OKF Update Log
+
+## 2026-06-22
+* **Initialization**: OKF bundle initialized with 64 entity concepts.

package/okf/metrics/cash-received.md

@@ -0,0 +1,10 @@
+---
+type: Metric
+title: Cash Received
+description: "Cash collected (settlement basis) over a date window."
+tags: [billing, payments]
+---
+
+**Definition.** Sum of `amount` over [payments](/entities/payments.md) with `date` in the window. This is cash basis — distinct from [invoiced-net-revenue](/metrics/invoiced-net-revenue.md) (accrual/billed basis).
+
+Separate direct account payments from transaction-linked payments if the answer needs it. Sum client-side; there is no server-side SUM.

package/okf/metrics/index.md

@@ -0,0 +1,6 @@
+# Metrics
+
+* [Cash Received](cash-received.md) - Cash collected (settlement basis) over a date window.
+* [Invoiced Net Revenue](invoiced-net-revenue.md) - Net invoiced revenue from billing invoices over a date window.
+* [Open Customers](open-customers.md) - Count of active customer accounts.
+* [Overdue Receivables](overdue-receivables.md) - Receivables in collection, via dunning — not from transactions alone.

package/okf/metrics/invoiced-net-revenue.md

@@ -0,0 +1,16 @@
+---
+type: Metric
+title: Invoiced Net Revenue
+description: "Net invoiced revenue from billing invoices over a date window."
+tags: [billing, revenue]
+---
+
+**Definition.** Sum of `netamount` over [transactions](/entities/transactions.md) where `type = 3` (billing invoice) and `date` falls in the window. For *net after credits*, also sum `type = 4` (billing credit) and subtract.
+
+**Why `date`, not `lastmodified`.** `date` is the business-effective invoice date; `lastmodified` is change tracking. See [dates-unix-seconds](/concepts/dates-unix-seconds.md).
+
+**No server-side SUM.** `list` the matching rows (high `--limit`, up to 10000) with `netamount` and add them up client-side. See [counting-and-sums](/concepts/counting-and-sums.md).
+
+**Do not** add `"visibility":0` — `transactions` has no such column and it 400s. See [visibility-column](/concepts/visibility-column.md).
+
+Related playbook: [revenue-this-year](/playbooks/revenue-this-year.md).

package/okf/metrics/open-customers.md

@@ -0,0 +1,14 @@
+---
+type: Metric
+title: Open Customers
+description: "Count of active customer accounts."
+tags: [crm]
+---
+
+**Definition.** Count of [accounts](/entities/accounts.md) where `type = 1` (CUSTOMER), excluding archived (`visibility = 0`).
+
+```bash
+zeyos count accounts --filter '{"type":1,"visibility":0}'
+```
+
+Count server-side (`count`), never `list` + row length. See [counting-and-sums](/concepts/counting-and-sums.md). State the definition you used ("customer = type 1, excluding archived").