商品模块需覆盖增删改查、分类归属、库存同步和图片上传；订单模块强调状态流转与事务安全；权限管理采用RBAC实现角色细分；前后端协作通过RESTful API与统一响应格式规范数据交互。
商品模块：从数据库到管理界面的完整链路
商品管理是后台系统的核心，需覆盖增删改查、分类归属、库存同步和图片上传。ThinkPHP 的模型层（Model）可直接映射数据表，比如 goods 表字段建议包含：id, name, price, stock, category_id, status, image_path, create_time。分类信息单独建 category 表，通过外键关联，便于后台用下拉或树形组件选择。
控制器中使用验证规则防止非法提交：
- 价格必须为数字且大于 0，库存为非负整数
- 商品名称长度限制在 2–100 字符，避免 XSS 风险
- 图片上传走
think\File类，限制类型（jpg/png）、大小（≤5MB），自动重命名并存入public/uploads/goods/
列表页启用分页和关键词搜索，用 whereLike('name', "%{$keyword}%") 实现模糊匹配；编辑时注意读取原记录再渲染表单，避免覆盖未修改字段。
订单模块：状态流转与事务安全的关键实现
订单不是简单插入一条记录，而是涉及用户、商品、地址、支付等多实体联动。典型字段包括：order_no, user_id, total_amount, status, pay_status, consignee, phone, address, remark, pay_time, finish_time。其中 status 建议用整型枚举（如 0=待付款、1=已付款、2=已发货、3=已完成、-1=已取消），方便条件判断和索引优化。
立即学习“PHP免费学习笔记（深入）”；
下单时必须开启数据库事务，确保“扣库存 + 写订单 + 写订单明细”三者原子性执行：
- 先查商品当前库存，判断是否充足；不足则直接返回失败
- 用
Db::transaction()包裹操作，内部对 goods 表执行dec('stock', $num)，同时向 order 和 order_item 表写入数据 - 任一环节异常，自动回滚；成功后清空用户购物车（Session 或 Redis 中对应 key）
后台订单列表支持按状态筛选、时间范围导出、批量发货（更新物流单号和状态），发货动作也应记录操作日志，便于追溯。
权限与操作安全：让管理员各司其职
电商后台常有超级管理员、运营人员、客服人员等角色，不能所有人随意删订单或改价格。ThinkPHP 可结合 RBAC（基于角色的访问控制）实现精细权限管理：
- 用中间件拦截请求，校验当前登录用户是否有访问该控制器方法的权限
- 商品管理权限可细分为：查看、新增、编辑、上下架、删除；订单管理可拆为：查看、发货、退款审核、导出
- 敏感操作（如删除商品、强制完成订单）增加二次确认弹窗，并记录 IP、操作人、时间到日志表
密码重置、登录失败锁定、Token 防重复提交等基础防护也应在登录和关键接口中启用，避免越权或暴力攻击。
前后端协作：API 设计与数据规范
若后台需对接小程序或 Vue 管理端，app/api/ 模块应提供标准 RESTful 接口。例如：
-
GET /api/v1/goods?category_id=5&page=1返回分页商品列表（含规格、轮播图等扩展字段） -
POST /api/v1/orders/ship接收物流单号，校验订单状态后更新并触发通知 - 统一响应格式：
{"code":0, "msg":"success", "data":{...}}，错误时 code ≠ 0 并附具体提示
接口需做登录态校验（如读取 Header 中的 Authorization Token），所有输入参数用 validate() 方法过滤，输出数据用 hidden 属性屏蔽敏感字段（如用户手机号全段）。
