
綱要項目背景與目標用戶端應用開發完成后的管理需求后臺管理系統的定位運營監控與數據管理項目結構規劃前后端代碼目錄劃分與現有用戶端應用的關聯AI輔助功能梳理基于現有代碼庫的功能點分析約束條件設定數據庫表結構保護功能點清單的生成與迭代核心功能模塊解析數據統計概覽用戶管理與交易管理分類管理與賬戶類型管理只讀管理員獨立認證體系數據庫擴展設計新增管理員表admins表結構設計與字段說明密碼加密存儲策略數據庫執行方案手動執行SQL腳本的方式與AI協作執行方式的對比需求文檔的整理與版本管理項目背景與目標在完成用戶端應用開發后通常需要配套的后臺管理系統以支撐日常運營工作。后臺管理系統的核心使用者為運營專員或產品人員其職責包括查看注冊用戶信息、監控用戶交易流水支出與收入、管理分類數據等。本次實踐的目標是基于現有的用戶端應用代碼借助AI輔助工具Claude快速梳理出后臺管理系統的完整功能架構并完成數據庫擴展設計為后續前后端開發奠定基礎。項目結構規劃后臺管理系統與用戶端應用采用相同的代碼組織方式即前后端分離架構。在項目根目錄下創建獨立的文件夾內部包含frontend與backend兩個子目錄分別存放前端與后端代碼。項目目錄結構如下├── 006-backend-management-system/ │ ├── frontend/ │ │ └── 前端代碼基于現有用戶端架構擴展 │ └── backend/ │ └── 后端代碼復用現有API規范 ├── 003-user-app/ │ └── frontend/ │ └── 現有用戶端應用源碼 └── product-docs/ └── 產品需求文檔存放目錄該結構確保后臺管理系統與用戶端應用的代碼隔離同時便于復用已有的技術棧和API規范。AI輔助功能梳理在手動梳理功能點可能遺漏且耗時的情況下可借助AI工具對現有代碼庫進行自動化分析。通過向AI提供當前用戶端應用的代碼位置與功能目標可快速生成功能點清單。交互流程核心交互流程如下數據庫代碼庫AI助手開發者數據庫代碼庫AI助手開發者提供現有應用代碼路徑描述后臺管理系統目標設定約束條件禁止修改數據庫表結構分析現有API端點與數據模型讀取當前表結構只讀生成功能點清單Markdown文檔審閱并補充需求新增管理員表更新文檔并生成建表SQL執行SQL創建管理員表約束條件設定在AI梳理功能點時必須明確以下前置約束以防止AI擅自修改數據庫結構導致用戶端應用異常禁止修改現有數據庫表結構不得對已有表的字段、索引、約束進行任何變更。禁止修改現有API接口所有后臺管理系統的數據獲取需通過現有API端點完成。允許新增獨立數據表僅允許為后臺管理系統新增一張管理員表admins且該表獨立于用戶表。功能點清單生成AI在分析現有代碼庫后會輸出一份Markdown格式的功能點清單文檔自動保存到產品文檔目錄中。該文檔包含以下核心章節項目描述與目的前置約束說明現有API端點分析功能需求列表頁面結構規劃技術方案建議待辦事項與待確認事項核心功能模塊解析基于AI梳理的結果后臺管理系統的功能劃分為七大核心模塊模塊功能描述數據權限數據統計概覽展示總用戶數、交易總筆數、支出/收入匯總只讀七天趨勢近七天的用戶增長與交易量趨勢圖表只讀用戶管理查看注冊用戶列表、用戶詳情信息只讀交易管理查看用戶交易流水、支出與收入明細只讀分類管理查看支出分類與收入分類列表只讀賬戶類型管理查看用戶的賬戶類型配置只讀用戶排行按交易量、注冊時間等維度的用戶排行只讀所有功能模塊均遵循只讀原則即后臺管理系統僅用于數據查看與監控不提供新增、修改或刪除操作。數據的創建與修改均由用戶端應用完成。頁面結構規劃后臺管理系統的頁面結構采用多級菜單設計├── 儀表盤 │ └── 數據概覽 ├── 用戶管理 │ └── 用戶列表 ├── 交易管理 │ └── 交易流水 ├── 數據統計 │ ├── 趨勢分析 │ └── 用戶排行 ├── 分類管理 │ ├── 支出分類 │ └── 收入分類 └── 系統設置 └── 賬戶管理管理員獨立認證體系后臺管理系統與用戶端應用需采用獨立的認證體系即管理員賬戶不與普通用戶表共用。設計原則獨立存儲管理員賬戶存儲在獨立的admins表中。密碼單獨加密管理員密碼采用與用戶端不同的加密策略使用獨立的鹽值或加密算法。獨立登錄后臺管理系統使用獨立的登錄頁面與認證接口。管理員表結構設計在約束條件下允許新增一張admins表其核心字段如下字段名類型說明idINT主鍵自增usernameVARCHAR(64)管理員用戶名唯一索引password_hashVARCHAR(255)加密后的密碼哈希值roleVARCHAR(32)角色標識默認super_admincreated_atDATETIME創建時間updated_atDATETIME更新時間建表SQL腳本如下CREATETABLEadmins(idINTAUTO_INCREMENTPRIMARYKEYCOMMENT主鍵ID,usernameVARCHAR(64)NOTNULLUNIQUECOMMENT管理員用戶名,password_hashVARCHAR(255)NOTNULLCOMMENT密碼哈希值,roleVARCHAR(32)DEFAULTsuper_adminCOMMENT管理員角色,created_atDATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT創建時間,updated_atDATETIMEDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMPCOMMENT更新時間)ENGINEInnoDBDEFAULTCHARSETutf8mb4COMMENT后臺管理員表;數據庫執行方案管理員表的創建有兩種執行方式開發者可根據實際情況選擇。方式一手動執行SQL腳本通過數據庫客戶端工具直接執行上述建表腳本打開數據庫客戶端如MySQL Workbench、phpMyAdmin或命令行。進入查詢編輯器粘貼建表SQL腳本。執行腳本確認返回成功。執行成功后可在數據庫表列表中看到新增的admins表。方式二AI輔助執行可指示AI工具直接連接數據庫并執行建表操作。但需注意確保數據庫連接信息安全且AI工具具備數據庫寫入權限。在執行前由AI展示完整的SQL腳本供開發者審核。建議在開發或測試環境中先行驗證再應用于生產環境。需求文檔的整理與版本管理功能點清單文檔應在梳理完成后持續更新記錄需求變更與實施進度。建議的文檔管理規范如下文檔命名采用項目名_功能清單.md的格式。變更記錄在文檔末尾添加變更日志表格記錄每次修改的日期、內容和責任人。待確認事項對尚未決策的需求如導出功能、定時任務等在文檔中明確標記為待確認并在決策后及時更新。在本案例中經過評估后決定導出功能不需要因現有用戶端已具備Excel導出能力。定時任務不需要自動生成報表在大數據量場景下可能引發系統卡頓??偨Y本次后臺管理系統的功能架構梳理完整展示了在AI輔助下如何高效完成需求分析、數據庫設計與文檔管理。核心要點總結如下后臺管理系統定位為運營監控工具所有功能模塊遵循只讀原則數據變更由用戶端應用負責。AI工具Claude可基于現有代碼庫自動生成功能點清單顯著縮短需求梳理周期但需在交互中明確約束條件以防止誤改數據庫。管理員認證體系需獨立于普通用戶新增admins表是推薦的擴展方式密碼需單獨加密存儲。數據庫擴展遵循“最小改動”原則僅新增必要表不修改已有表結構與API接口。需求文檔應保持可維護性包含功能描述、技術方案、變更記錄和待確認事項便于團隊協作與后續開發。