officer
6c70eb8eb3
Ninth plugin out, third resurrection: switched off since 2026-08-13 with the permission reduced to api: [], so the server booted clean and every panel request 404'd. invoiceshelf/schema was also commented out of the drizzle barrel. Named `invoices`, not `invoiceshelf`. The appName drives the API prefix, the frontend route, the table prefix and the install key all at once, and before extraction those had drifted: the API was /api/invoiceshelf while the screen was /invoices. The URL is what a person sees and should name what the plugin shows rather than the daemon behind it — the permission key and label were already `invoices`, so the API prefix was the odd one out. Cost: three call sites, and renaming invoiceshelf_accounts to invoices_accounts to satisfy the table-prefix rule. That rename was free ONLY because the table existed on no server, which was checked before deciding. With rows in it, keeping the vendor name would have been the better trade: db:push sees a rename as a drop plus a create and this project has no migration mechanism. The sidecar keeps its Invoiceshelf-named functions deliberately — they name the upstream API it actually speaks. 91 palette classes converted, 52 of them in STATUS_TONE, which was already the single source of status colour but held raw palette strings. SENT and VIEWED now share `info`: the closed six-tone set has no second shade of "in flight, not yet actioned". Recorded in PLUGIN.md as a real loss.
33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# Invoices
|
|
|
|
Your [InvoiceShelf](https://invoiceshelf.com) books, inside Officer — invoices, estimates, customers and
|
|
payments, with the credentials held server-side.
|
|
|
|
## What you get
|
|
|
|
- **Invoices** — list, filter by status, open one and see its lines
|
|
- **Estimates** — the same, before they become invoices
|
|
- **Customers** and their history
|
|
- **Payments** recorded against invoices
|
|
- **Multiple companies** — add several sets of books and switch between them
|
|
|
|
## Requirements
|
|
|
|
A running InvoiceShelf instance Officer can reach, and credentials for it.
|
|
|
|
## Setup
|
|
|
|
Install the plugin, open **/invoices**, and add an account: a label, the URL, and the credentials. They
|
|
are encrypted at rest and never sent to the browser. Mark one active.
|
|
|
|
The plugin does **not** install or supervise InvoiceShelf. Point it at one you already run.
|
|
|
|
## Permissions
|
|
|
|
One permission, `invoices`, grantable per role like any other app permission.
|
|
|
|
## Notes
|
|
|
|
- The plugin is named **`invoices`**, not `invoiceshelf` — named for what it shows rather than the
|
|
daemon behind it, which is what keeps the URL `/invoices`. See `PLUGIN.md`.
|