askrobots / dbbasic-object-server
Public
Runs live, versioned Python application objects on one VM, with a suite of apps: projects, notes, tasks, files and more.
danq9
signup: the person chooses the password and name on the confirm page
83c7aa6
2 weeks, 5 days ago
History
rate_cards.json · 3.6 KB · 41 lines
| 1 | { |
| 2 | "name": "rate_cards", |
| 3 | "title": "Rate Cards", |
| 4 | "version": 1, |
| 5 | "description": "What an hour of human work costs, and for whom. A card scoped to a person AND a project beats one scoped to just the project, which beats one scoped to just the person, which beats the house default -- because the reason anyone writes a rate for 'Dana on the Acme rebuild' is that it must beat both of the others. The scope is READ from what a card carries rather than declared in a column of its own, so a card cannot resolve differently from how it reads. Cards VERSION FORWARD like billing_plans: a new rate is a new row with a later valid_from, never an edit, because an invoice must forever show the rate it was billed under and last quarter's unbilled hours belong to last quarter's rate (docs/logic-decisions.md #1). Resolution never looks forward -- the rate in force is the newest card that had already started when the work happened. increment_minutes lives here rather than in a global setting because rounding up to the next six minutes is a term of an engagement, not a preference of the server; it is the one number here that can only ever increase a bill, which is exactly why it belongs to something a client agreed to in writing.", |
| 6 | "fields": [ |
| 7 | {"name": "id"}, |
| 8 | {"name": "label", "type": "text", "required": true, "label": "Label", |
| 9 | "help": "How this rate reads to a human: 'Standard engineering', 'Acme principal rate'."}, |
| 10 | {"name": "person_id", "type": "text", "label": "Person", |
| 11 | "help": "Leave empty for a rate that applies to everyone in scope. Matched against a time entry's owner."}, |
| 12 | {"name": "project_id", "label": "Project", |
| 13 | "relation": {"collection": "projects", "display_field": "name"}, |
| 14 | "help": "Leave empty for a rate that applies on every project."}, |
| 15 | {"name": "hourly_rate_cents", "type": "integer", "required": true, |
| 16 | "label": "Hourly Rate", |
| 17 | "help": "Integer minor units of the denomination (docs/logic-decisions.md #10). 15000 is $150.00/hour."}, |
| 18 | {"name": "currency", "type": "text", "default": "USD", "label": "Currency"}, |
| 19 | {"name": "increment_minutes", "type": "integer", "default": "0", |
| 20 | "label": "Billing Increment", |
| 21 | "help": "Round each entry UP to this many minutes. 0 bills the time that actually happened; 6 and 15 are the common professional-services conventions. Because it can only ever increase a bill, state it on the card the client agreed to."}, |
| 22 | {"name": "valid_from", "type": "date", "required": true, "label": "Valid From", |
| 23 | "help": "The day this rate starts applying. Work done before it keeps the previous card's rate."}, |
| 24 | {"name": "is_active", "type": "boolean", "default": "true", "label": "Active", |
| 25 | "help": "Retiring a card stops it applying to NEW work; it never restates hours already approved at that rate."}, |
| 26 | {"name": "notes", "type": "textarea", "label": "Notes"}, |
| 27 | {"name": "owner_id", "type": "text", "label": "Owner"}, |
| 28 | {"name": "entity_id", "type": "text", "label": "Entity", |
| 29 | "relation": {"collection": "entities", "display_field": "name"}}, |
| 30 | {"name": "created_at", "type": "datetime", "read_only": true, "label": "Created"} |
| 31 | ], |
| 32 | "search": {"fields": ["label", "notes"]}, |
| 33 | "forms": {"default": {"fields": ["label", "person_id", "project_id", |
| 34 | "hourly_rate_cents", "currency", |
| 35 | "increment_minutes", "valid_from", |
| 36 | "is_active", "notes"]}}, |
| 37 | "views": {"list_mode": "table", |
| 38 | "list_fields": ["label", "person_id", "project_id", |
| 39 | "hourly_rate_cents", "valid_from", "is_active"], |
| 40 | "filter_fields": ["is_active", "project_id"]} |
| 41 | } |