62 lines
2.8 KiB
Plaintext
62 lines
2.8 KiB
Plaintext
---
|
||
description: FastAdmin 管理后台规范：CRUD 控制器、视图、语言包、前端表格 JS
|
||
globs: backend/application/admin/**,backend/public/assets/js/backend/**
|
||
alwaysApply: false
|
||
---
|
||
|
||
# FastAdmin 管理后台规范
|
||
|
||
## 新增模块
|
||
|
||
1. 先建表（`fa_` 前缀，`createtime`/`updatetime` 为 int，枚举字段 COMMENT 写成 `状态:0=关闭,1=招标中`）
|
||
2. 用命令生成骨架，再在生成结果上修改：`php think crud -t demands -u 1`，菜单 `php think menu -c demands`
|
||
3. 一个模块对应四处文件，命名保持一致：
|
||
- 控制器 `admin/controller/[子目录/]Demands.php`
|
||
- 视图 `admin/view/[子目录/]demands/{index,add,edit}.html`
|
||
- 语言包 `admin/lang/zh-cn/[子目录/]demands.php`（字段名、`Status 1` 等枚举文案）
|
||
- 表格 JS `public/assets/js/backend/[子目录/]demands.js`
|
||
|
||
## 控制器
|
||
|
||
- 继承 `app\common\controller\Backend`；在 `_initialize()` 中实例化 `$this->model`（使用 `app\common\model` 下的模型）并 `assign` 各 `xxxList`
|
||
- 默认 `index/add/edit/del/multi` 由 trait 提供，只有需要定制时才覆盖；覆盖时以 `admin/library/traits/Backend.php` 中原方法为蓝本
|
||
- 关联查询覆盖 `index()`：`$this->relationSearch = true`，`->with([...])`，并用 `visible()` 限定关联字段
|
||
- 保存时用 `$this->model->allowField(true)->save($params)`，入参先经 `preExcludeFields()`
|
||
- 自定义操作（审核、重新投标、取消等）：
|
||
|
||
```php
|
||
public function audit($ids)
|
||
{
|
||
$row = $this->model->get($ids);
|
||
if (!$row) {
|
||
$this->error(__('No Results were found'));
|
||
}
|
||
if ($this->request->isAjax()) {
|
||
try {
|
||
DemandService::auditPass($ids);
|
||
} catch (\Exception $e) {
|
||
$this->error($e->getMessage());
|
||
}
|
||
$this->success('审核成功');
|
||
}
|
||
$this->view->assign('row', $row->toArray());
|
||
return $this->view->fetch();
|
||
}
|
||
```
|
||
|
||
- 业务流程（资金、状态流转、通知）必须调用 `common/service`，与 API 共用同一套逻辑，不在后台控制器里重写
|
||
- `$this->success()` 放在 try 外，或在 catch 中对 `HttpResponseException` 原样抛出
|
||
- 新增自定义方法后需在权限菜单中添加对应节点，否则非超管无权限
|
||
|
||
## 表格 JS
|
||
|
||
- 使用 `define([... 'table', 'form'], ...)` + `Table.api.init({ extend: {...} })`，列文案一律 `__('Field')`
|
||
- 枚举列 `searchList` 与模型 `getXxxList()` 保持一致，配合 `Table.api.formatter.status/normal`
|
||
- 自定义按钮放在 `operate` 列的 `buttons` 中，弹窗用 `btn-dialog`，Ajax 用 `btn-ajax` 并带 `confirm`
|
||
- 表单页调用 `Controller.api.bindevent()` → `Form.api.bindevent($("form[role=form]"))`
|
||
|
||
## 视图
|
||
|
||
- 表单字段名使用 `row[field]`；图片/文件使用 FastAdmin 的 `faupload` 组件
|
||
- 不在模板内写业务判断，下拉选项使用控制器 assign 的 `xxxList`
|