Practice Books Kit — 治療私人診所的記帳＋薪資系統
目的
為私人診所經營者提供一個完整、可重複的財務系統，包含兩個部分：
- A 部分 — 月度記帳。 將該月的銀行與信用卡對帳單交給代理程式。代理程式會將每筆交易分類到一個固定的會計科目中，並填寫損益表工作簿的一個月份欄位，然後在報告前驗證月份是否核對相符。
- B 部分 — Practice Books 應用程式。 由代理程式為經營者建置並部署的一個小型管理員專用網頁應用程式：用於 1099 合約工和 W-2 員工的月度薪資（薪資執行、薪資單、年度總結），以及一個唯讀的財務儀表板，可視覺化來自 A 部分的損益表工作簿。
這兩個部分互相強化：應用程式的合約費用可以與損益表進行核對，而儀表板意味著經營者無需開啟工作簿即可隨時查看最新數字。
交給您的代理程式（給接收此套件的同事）
將整個資料夾交給您的 AI 代理程式，然後：
- 回答下方的設定面談問題 — 代理程式應在執行任何其他操作之前，一次性向您提問這些問題。
- 確認
references/categories.md中的會計科目表 — 保留名稱和順序，除非某個類別確實不適用於您的診所；代理程式應在首次填寫前與您確認。 - 交出一個月的對帳單，讓代理程式進行首次填寫。檢查其核對結果和判斷性問題清單；如有錯誤更正一次，代理程式會將您的裁決記錄為未來月份的常設規則。
設定面談（一次性收集、記錄下來、每月重複使用）
在首次填寫或建置應用程式之前，代理程式必須收集 — 且絕不能猜測 — 以下資訊：
- 診所： 法定名稱、經營者姓名、營運所在的州、實體類型。
- 帳戶（僅需最後 4 碼作為標籤）：
- 主要商業支票帳戶（付款人收入存入之處）。
- 薪資子帳戶，如果診所用來支付合約工。
- 稅務/儲蓄子帳戶（如有）；轉入此帳戶的款項屬於內部轉帳。
- 商業信用卡。
- 接收轉帳的經營者個人/財富帳戶（用於辨識經營者提款）。
- 對帳單： 經營者每月如何提供對帳單（偏好 CSV 匯出，如果銀行僅提供 PDF 則用 PDF），以及哪個日期欄位決定月份（交易日期，非入帳日期，除非經營者另有規定）。
- 薪資慣例： 預設為每月 1 日支付上個月的工作報酬。請確認或記錄診所的實際慣例。
- 人員與薪資條件（用於 B 部分）：每位合約工/員工、其類型（1099 或 W-2）、以及其確切的薪資條件 — 收款百分比、每次治療固定金額、時薪或月薪；任何單獨的自費/滑動式收費分潤；任何經常性扣除項目（例如 EHR 座位費）。切勿猜測薪資費率。 如果費率缺失，請將其留空並標記出來。
- 非對帳單收入： 明確詢問診所如何收取從未出現在銀行資料中的款項 — 例如透過 Zelle/Venmo/現金/支票支付的督導費或租金。這些款項必須每個月從電子郵件/付款通知中匯入，否則損益表會無形中低估收入。
A 部分 — 月度對帳單到損益表的工作流程
參考檔案：references/categories.md（會計科目表＋分類指南）和 references/pl-sheet-spec.md（工作簿版面配置、公式和填寫程序）。請嚴格遵循。
- 收集該月的所有對帳單。 主要支票帳戶、薪資子帳戶、每張商業信用卡，以及非對帳單資料匯入（步驟 2）。如果缺少某份對帳單，請明確指出，並僅根據所提供的對帳單進行填寫 — 在報告中說明這個缺口（例如「合約費用待薪資帳戶對帳單」），而不是默默地繞過它來填寫。
- 匯入非帳戶資料來源的收入。 搜尋經營者該月的電子郵件/付款通知（Zelle/Venmo「您收到款項」通知等），並將確認的商業收入憑證添加到分類帳中，並註明其來源。同一批資料中發現的個人收入則被排除並列出。
- 解析每份對帳單中的每筆交易，整理成一個分類帳：日期、來源帳戶、描述、金額（收入為正數，支出為負數）。
- 排除內部資金移動 — 這既非收入也非支出：
- 診所自有帳戶之間的轉帳（支票帳戶 ↔ 薪資子帳戶 ↔ 稅務子帳戶）。
- 轉出至經營者個人/財富帳戶的款項 — 這些是經營者提款，絕非費用。
- 信用卡付款（自動扣繳或手動）— 信用卡的消費才是費用；付款僅僅是帳戶間的資金移動。
- 使用
references/categories.md分類所有剩餘交易。 從薪資帳戶支付的合約工 ACH 款項屬於合約費用。如果某筆交易不符合任何規則，請將其放入報告的判斷性問題清單中 — 切勿默默丟棄，也切勿在未經經營者核准的情況下杜撰新類別。 - 按類別加總，成為該月欄位的數值（費用為負數）。
- 按照
references/pl-sheet-spec.md寫入月份欄位：僅限類別儲存格，然後是總計公式，在相信寫入結果（儲存格計數）之前先對其進行斷言。 - 回讀並核對。 從工作簿重新讀取已寫入的欄位，並與獨立計算的分類帳進行驗證：
- 分類收入的總和 = 對帳單總收入減去排除項目（內部轉入、根據經營者規則處理的信用卡退款）。
- 分類費用的總和 = 對帳單總支出減去排除項目。
- 分類帳中的每筆交易都恰好被計算一次：已分類、已排除（附理由）、或列為未分類。 如果核對失敗，請在報告前修正 — 不要報告一個未能核對相符的月份。
- 向經營者報告該月：收入、費用、淨利；年度至今總計；所做的判斷性決定（含金額）以及經營者記錄為常設規則的裁決；任何未分類項目；任何缺少的對帳單。報告應保持事實性和完整性 — 經營者會據此進行審計。
A 部分嚴格規則
- 僅使用實際數據。 使用對帳單上的實際交易金額。切勿估計、平均、年化或填入一個數字來讓月份「看起來完整」。不完整的月份應報告為不完整。
- 切勿覆蓋手動輸入的儲存格。 如果經營者已在您即將寫入的儲存格中輸入了值，且該值與您的值不同，請保留他們的值，在報告中標記此衝突，並公開進行核對 — 預先存在的條目通常來自您未取得的來源。
- 費用在試算表中為負數；總計公式依賴於此。
- 償還款項應與費用沖抵，切勿列為收入。 當有人償還診所代墊的特定費用時（典型情況：合約工償還其在團體 EHR 訂閱中的座位費），請在收到償還款的月份從該費用類別中減去該筆償還款。將其總額計為收入會同時高估收入和費用。
- 個人交易應被排除並列出在報告中，而非分類「以求保險」。
- 一致地應用經營者的裁決。 當經營者更正一次分類時，請將規則記錄下來（在您對該診所的記憶/筆記中），並在之後每個月應用，無需再次詢問。
B 部分 — Practice Books 應用程式
參考檔案：references/app-spec.md — 資料模型、薪資規則、執行生命週期、財務報表讀取合約、類別清單和部署閘門。請按照該規格建置。
工作內容：
- 確認設定面談資料（尤其是人員和薪資條件）。切勿在猜測的費率上建立任何財務功能。
- 先在本地建置。 編寫伺服器 + 用戶端程式碼，以及一個本地測試工具，該工具會模擬試算表層，並以用戶端發送的確切引數型態呼叫每個伺服器功能。至少涵蓋：薪資計算基礎（百分比 / 固定 / 自費分潤）、執行生命週期防護（執行必須通過「已核准」才能進入「已付款」）、「已付款」→「付款歷史記錄」的寫入、1099 $600 門檻、W-2 FICA 薪資上限，以及針對會計格式字串的財務報表解析器。
- 使用閘門進行部署。 推送程式碼，然後回讀已部署的專案內容，並要求與測試過的本地檔案進行逐字節比對 之後 再建立版本 — 內容過時的部署在有人開啟應用程式之前，看起來與良好部署一模一樣。將現有部署更新到新版本；切勿建立新的部署 URL（每個新 URL 都是需要有人更新的連結，而且舊 URL 會繼續提供舊版程式碼）。更新版本後，重新列出部署以確認版本確實已移動（部署清單可能比版本更新落後幾秒鐘）。
- 經營者授權是一次性手動步驟。 經營者開啟專案一次並核准權限範圍（試算表 + 寄送郵件）。在此之前，應用程式 URL 將顯示存取錯誤 — 這是預期行為，並非錯誤。
- 經營者的首次執行檢查清單： 解鎖、確認資料工作簿已自動建立、同步/新增人員、設定每個人的薪資基礎和費率，然後建立第一個（上個月的）薪資執行作為草稿並進行試執行，在核准任何項目之前檢查明細。
應用程式邊界（事先向經營者說明）
- 該應用程式僅負責計算和記錄。它不會進行電子報稅（1099/W-2/941）、不會移動資金或進行付款，也不會向任何機構提交任何內容。經營者照常從銀行支付人員薪資；應用程式僅記錄此事件。
- W-2 預扣稅額為估算值（根據可編輯的稅率表頁籤，採用年化百分比法），供經營者的會計師驗證 — 切勿將其呈現為可直接申報的數字。
- 應用程式工作簿中不得包含完整的 SSN/EIN 或銀行帳號。 僅儲存「已存檔稅表」/「已存檔 ACH」標記；完整的識別資訊應保留在診所現有的安全系統中。
- 該應用程式為管理員專用：一個經營者登入閘門（例如，一個在伺服器端根據名單驗證的 PIN 碼），並且每個伺服器功能都會重新檢查呼叫者的授權。提供者永遠看不到該應用程式；他們自己的付款檢視（如果有的話）是一個獨立的唯讀介面。
- 財務儀表板是唯讀的 — 應用程式永遠不會寫入損益表工作簿。月度填寫（A 部分）仍然是數字進入損益表的唯一方式。
代理程式的操作規則
- 遵循參考檔案，而非即興發揮；若參考檔案與即時指示衝突，以經營者當前的指示為準，並將變更記錄下來。
- 從成品進行驗證，而非依據您自己的說法：寫入後回讀試算表、部署後回讀已部署的程式碼、程式碼變更後執行測試工具。
- 當某個步驟失敗時，報告失敗的內容、事物的實際狀態，以及下一步要做什麼。切勿僅因已啟動某個填寫、部署或薪資執行，就將其報告為已完成。