Quiar – Freelancer

BuiltRendered from 46i-quiar-freelancer.md in the public repository. Edits belong there.

Quiar – Freelancer books jobs, keeps the clients they are for, tracks door-to-door canvassing, and shows the schedule, for an instance that sells services.


Package	`quiar`, version 2.6.1
Kind	App. Hub tool `quiar`
For	An instance that books work for clients. Nothing in it is specific to one trade: a job's kind is a node the instance defines in its own local domain
Own sandbox	Yes. Its anchor is copied from the instance's `registrar` anchor, so its numbering is the registrar's
Requires	The registrar's `legal_entity` document, as the address space the customer and site pickers resolve names in
Ports	None
Preview	Demo

What it turns on

Installing exposes six tools: quiar (the hub), quiar_overview, job_manager, project_manager, contacts_manager and calendar. calendar and contacts_manager are scoped to the app's sandbox. The hub draws five tabs:

Tab	Content
Domain (default)	`lcl_editor` on the app sandbox's local domain. Projects are nodes here, and a node can hold the document that describes the project
Jobs	The `job_log` (`job_manager`). When a job document is open, its view (`job_document_view`) is drawn above the log
Clients	A client form that can also start a job, above the contacts table (`contacts_manager`)
Canvassing	`canvass_manager`: enter a city and street, get the registrar's addresses on it, each marked with the last knock this instance recorded
Calendar	`calendar`, pinned to the app sandbox. The standalone `calendar` tool shows every sandbox, with per-sandbox toggles

quiar_overview and project_manager are installed but not drawn as tabs; both are reachable from the menubar search. canvass_manager is drawn as a tab but is a registered tool that no package lists.

What it reads and writes

Installing provisions these documents:

Document	Archetype
`job_log`	`job_event`
`contacts`	`natural_entity_profile`
`lcl_domain`	`local_domain_log`
`canvass_log`	`canvass_visit`
`projects`	`project_profile`

Declared writes:

Tool	Writes
`job_manager`	`save_job` (a `job_event` row), `save_job_document` (a `job` document with several services), `create_site` (mints a new address record; authorized separately from booking)
`contacts_manager`	`save_contact`, `request_contact_verification` (the host mails a confirmation link and marks the row `verification_sent`)
`project_manager`	`save_project`
`canvass_manager`	`save_canvass` (a `canvass_visit` row); a met prospect is saved with `save_contact`

contacts_manager writes the fields msn_id, ruiqi_id, email, sosvid, nominal, utc and website; it is offered only on a sandbox whose anchor can express all of them.

Status

Built and published. A demo exists. Quiar declares no ports: no tab calls one.

Source

micyte/tools/quiar.py: the hub and its tab table
micyte/tools/job_manager.py, micyte/tools/contacts_manager.py, micyte/tools/project_manager.py, micyte/tools/canvass_manager.py, micyte/tools/calendar_viewer.py
micyte/tools/_packages.py: _quiar_package