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