菜单
Documents double-entry journal posting via postJournalSync, ACCT codes, and MVP recipes in simple-books. Use when adding business events, invoices, payments, mileage, reversals, or ledger entries.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Documents Docker image build, Helm chart, release-please versioning, GitHub Actions CI, and K8s deploy constraints for simple-books. Use when deploying, releasing, adding CI workflows, or configuring production infrastructure.
Documents smoke test runbook, when to add tests, and Playwright selector pitfalls for simple-books. Use when running E2E tests, debugging flakes, or writing UI tests.
Creates TanStack Start createServerFn RPC endpoints with requireAuthMiddleware and dynamic server imports in simple-books. Use when adding *.functions.ts files, server mutations, or fixing import-protection build errors.
Documents local and S3 attachment storage, upload API, and cleanup for simple-books. Use when working with file uploads, attachments, Garage/S3 config, or IRS retention.
Documents bootstrap sign-up, OIDC-only login when configured, and single-owner bootstrap in simple-books. Use when changing auth, login, OIDC env vars, or user access.
Adversarial security review for financial apps: novel and chained exploits, LLM-powered attacker tactics, auth/RPC/upload/ledger invariants, and bad secure-coding process. Use before merge on security-sensitive changes, when auditing auth, money, attachments, deployment, or when the user asks for threat modeling, penetration mindset, or codesec review.
| name | accounting-posting |
| description | Documents double-entry journal posting via postJournalSync, ACCT codes, and MVP recipes in simple-books. Use when adding business events, invoices, payments, mileage, reversals, or ledger entries. |
Every business event must produce a balanced journal entry (sum of debits = sum of credits).
Use postJournalSync(tx, { date, memo, source, sourceId, lines }) from
src/server/invoices.functions.ts (sync Drizzle/bun:sqlite transactions). The function:
journal_entries row and n journal_lines rows in one tx.Pulled from ACCT in src/server/posting.server.ts. Don't hardcode strings.
| Code | Constant | Purpose |
|---|---|---|
| 1000 | CASH | Cash on hand / bank |
| 1100 | AR | Accounts Receivable |
| 3000 | OWNERS_EQUITY | Owner's Equity (umbrella) |
| 3010 | OWNERS_CONTRIBUTION | Capital contributed by owner |
| 3020 | OWNERS_DRAW | Cash withdrawn by owner |
| 4000 | SERVICES_REVENUE | Revenue from billed services |
| 6100 | VEHICLE_EXPENSE | Mileage-based vehicle expense |
Issue invoice: DR 1100 A/R CR 4000 Services Revenue
Receive cash: DR 1000 Cash CR 1100 A/R
Auto-invoice pmt: (issue + receive, same tx; auto_created=true)
Mileage trip: DR 6100 Vehicle Expense CR 3010 Owner's Contribution
Void invoice: DR 4000 Services Revenue CR 1100 A/R (reversal)
Reverse a receipt: DR 1100 A/R CR 1000 Cash (reversal)
*.functions.ts createServerFn (see adding-a-server-fn).db.transaction((tx) => ...).postJournalSync(tx, { ... }) with the right ACCT.* codes.Never update journal_entries / journal_lines in place. In one db.transaction:
postJournalSync with source: 'reversal' and debits/credits swapped from the original entry (reverseInvoiceJournal, or mirror deleteReceipt / deleteMileage).invoices, cash_receipts, mileage_entries, …).postJournalSync with the original source and corrected amounts.Helpers in src/server/posting.ts: reverseInvoiceJournal, postInvoiceJournal, cascadeAutoInvoiceAmount (when a stand-alone payment’s auto-invoice must stay in sync), recalcInvoiceStatusSync.
parseDollarsToCents and fmtCents.parseQuantityToMicro and microToDecimal.Math.round(qtyMicro * unitPriceCents / 1e6) (use BigInt to avoid overflow).