# 數據庫設計規范 我們在設計插件數據庫時最好統一設計規范，因為更好的設計規范能更好的讓我們的用戶更快速的掌握我們開發者的設計思想。 1. 表名和字段名全小寫,只允許出現`a-z`和`_`這幾種字符,且不能有拼音,只能為英文單詞 2. 存儲引擎統一使用`innodb`引擎 3. 字符集統一使用`utf8mb4_general_ci` 4. 關聯字段統一使用`_id`結尾,如`user_id`,`task_id`(任務表名為task),`item_id`(物品表名為item), 當為`father_id`,`parent_id`,`pid`,`prev_id`等字段時表示和當前表主鍵進行關聯,當為`task_ids`,`user_ids`時表示一個集合,以半角逗號進行分隔(非JSON) 5. 時間統一使用`Unix時間戳`格式, 秒級, 整型, 長度10,且必須以`time`結尾, 如`createtime`,`updatetime`,`paytime`,`expiretime`等 6. 時長統一使用秒格式, 整型, 長度10,且必須以`seconds`結尾,如`onlineseconds`,`todayonlineseconds`等 7. 表主鍵必須為`id`,主索引 8. 表名和字段名統一使用英文名稱,不允許出現中英混搭的情況出現 9. 日志表統一為模塊名加上`_log`進行命名 10. 字段內容為`json`數據時,以`data`進行結尾,比如`itemdata`,`rewarddata` 11. 當字段為某操作數量時,以`nums`結尾,比如`buynums`,`salenums` 12. 當一表出現兩個或兩個以上會員ID時,`user_id`表示自己,`receiver_user_id`表示他人,多人時使用`receiver_user_ids`,以半角逗號進行分隔(非JSON) 13. 當出現可數名詞字段時,一定要加上字符`s`,如`comments`,`views`等 ## 數據表名規范 插件數據表名必須以`插件標識`開始，例如： ~~~ fa_mydemo_log fa_mydemo_item fa_mydemo_comment ~~~ 其中`mydemo`為你的插件標識，`fa_`為數據表前綴。 ## 特殊字段 建議開發者在設計數據庫時保留以下字段的設計名稱，這樣我們能更好的統一不同插件之間的命名規范。 | 字段 | 字段名稱 | 字段類型 | 字段說明 | | --- | --- | --- | --- | | category\_id | 分類ID | int | 關聯fa\_category表，后臺CRUD時會自動生成selectpage組件 | | user\_id | 會員ID | int | 關聯fa\_user表，后臺CRUD時會自動生成selectpage組件 | | weigh | 權重 | int | 后臺的排序字段，如果存在該字段將出現排序按鈕，可上下拖動進行排序 | | createtime | 創建時間 | int | 記錄添加時間字段,不需要手動維護 | | updatetime | 更新時間 | int | 記錄更新時間的字段,不需要手動維護 | | deletetime | 刪除時間 | int | 記錄刪除時間的字段,不需要手動維護,如果存在此字段將會生成回收站功能,字段默認值務必為null | | status | 狀態字段 | enum | 狀態標識,如果存在此字段將啟用TAB選項卡展示列表 |