# 包租代管核對系統執行計畫

## Goal
建立第一版可本機執行的「包租代管核對系統」原型，包含需求文件、資料模型、月結核對流程，以及可操作的前端管理介面。

## Phases

| Phase | Status | Scope |
| --- | --- | --- |
| 1. Planning | complete | 建立計畫、研究摘要、進度檔 |
| 2. Product Docs | complete | PRD、資料表設計、月結流程 |
| 3. Static Prototype | complete | HTML/CSS/JS 後台原型 |
| 4. Reconciliation Logic | complete | 應收/實收/應付/異常核對、CSV 匯入、匯出 |
| 5. Verification | complete | 本機啟動、瀏覽器驗證、修正明顯問題 |
| 6. Secure Login Demo | complete | 登入閘門、雜湊驗證、失敗鎖定、session/閒置逾時、登出 |

## Decisions

- 先做靜態原型，不引入框架，降低初版成本。
- 資料先用前端 sample data 與 localStorage，後續可平移到 PostgreSQL/API。
- 第一版聚焦會計與核對流程，不做公開租屋平台或行銷頁。
- 文件輸出到 docs/prd.md、docs/schema.md、docs/monthly-close-flow.md。
- 原型採純 HTML/CSS/JS，使用 localStorage 保存示範狀態。
- Playwright 驗證腳本放在 tests/verify-ui.js。
- 靜態登入僅保護 demo；正式外網需後端驗證與 HTTPS。

## Errors Encountered

| Error | Resolution |
| --- | --- |
| workspace 不是 git repo | 照空白專案建立原型 |
| Playwright 未安裝 | 新增本地 dev dependency 並加上 npm test |
| 初版媒合規則過寬 | 收緊成帳號/金額/備註交叉判斷 |
| Node 測試 server 被 sandbox 擋住 | 測試改成直接開 file:// 原型 |
| Playwright 啟動 Chromium 被 sandbox 擋住 | 使用已核准的 npm test 提升權限驗證 |