amadan
Decision 16: the four refinements its design review found are choices too (16a-16d)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1 file changed,
+6
−0
implementation/carloku-paid-launch/DECISIONS-FOR-PAUL.md+6 −0
CI passed — run details
diff --git a/implementation/carloku-paid-launch/DECISIONS-FOR-PAUL.md b/implementation/carloku-paid-launch/DECISIONS-FOR-PAUL.md| index 15ff5dca6..9a1670544 100644 |
| --- a/implementation/carloku-paid-launch/DECISIONS-FOR-PAUL.md |
| +++ b/implementation/carloku-paid-launch/DECISIONS-FOR-PAUL.md |
| @@ -53,6 +53,12 @@ Context: the overage invoice for a month is one line per meter, and every line c |
| 16. **Which tax code an overage line carries when the plan changed during the month.** Proposed: split by span, so each meter has one line per tax code, with the usage of each UTC day attributed to the plan in force on that day and each line taxed by that plan's code (the amounts in total are unchanged; the box's daily usage then has to be carried for every month, not only for a partly covered one, which is a small change on the box side). The alternative: one line per meter taxed by the plan in force at the month's end, which needs no daily split and is a simpler invoice but taxes some days' usage under the other plan's code. If the accountant says one code per invoice is acceptable in that case, the alternative is the smaller build; otherwise the split. Until either is chosen the hold stays, and it is rare (a change to or from Business in a month with overage). |
| + Four refinements are choices too, found by the design's review (`docs/superpowers/specs/2026-10-03-per-line-tax-codes-design.md`, revision 2); the design builds so that any answer is one body of one function and chooses none of them: |
| + - **16a, the change day.** The box records usage by UTC day, so a day a plan changed on cannot be split exactly. Proposed: the day follows the plan in force at its start (00:00 UTC). |
| + - **16b, how a meter's unchanged amount is divided between the two codes.** Proposed: in proportion to the usage under each plan. Alternatives: by each span's own excess over its share of the allowance (a span that stayed under its allowance gets nothing), or by using up the pooled allowance in time order and attributing only what came after. Example, allowances 100 and 100, usage 50 then 250, overage 100: the proposal gives the first span a sixth of it, the alternatives nothing. None changes the amount. |
| + - **16c, no paid plan at the month's end.** If "the month-end plan" is chosen and the last paid span ended before the month did (a cancellation), the last paid span's code, or a hold. |
| + - **16d, months already held.** A month held today stays held until an operator resolves its review (`carlos billing resolve`); the next pass then prices it under the chosen rule. All at once on the day, or case by case. |
| + |
| ## What each answer unblocks |
| | Answers | Unblocks | |