\App\Http\Controllers\AdminDataDictController

字典数据控制器

职责：字典类型管理与字典数据管理的 HTTP 入口，校验入参、编排服务、组装统一响应，业务下沉 DataDictService。

┌────────────────── 分区导航（按此顺序阅读）──────────────────┐ 分区 1 · 类型管理 types / createType / updateType / deleteType 分区 2 · 数据管理 data / options / createData / updateData / deleteData └────────────────────────────────────────────────────────────┘

Summary

Methods

Properties

Constants

__construct()
types()
createType()
updateType()
deleteType()
data()
options()
createData()
updateData()
deleteData()

No public properties found

No constants found

No protected methods found

No protected properties found

N/A

No private methods found

$dictService

N/A

File: Backend-Admin-PHP/app/Http/Controllers/Admin/DataDictController.php
Package: Application
Class hierarchy: \App\Http\Controllers\Controller

\App\Http\Controllers\Admin\DataDictController
Uses

Properties

$dictService

$dictService : \App\Services\Admin\DataDictService

Type

DataDictService

Methods

__construct()

__construct(\App\Services\Admin\DataDictService  $dictService) : mixed

Parameters

\App\Services\Admin\DataDictService

$dictService

Returns

mixed —

types()

types() : \Illuminate\Http\JsonResponse

类型列表

返回全部字典类型：编码、名称、平铺/树形形态与状态。

Returns

\Illuminate\Http\JsonResponse —

createType()

createType(\App\Http\Requests\Admin\DataDictRequest  $request) : \Illuminate\Http\JsonResponse

创建类型

新建字典类型：编码唯一，is_tree 决定该字典是平铺还是树形结构。

Parameters

\App\Http\Requests\Admin\DataDictRequest

$request

Returns

\Illuminate\Http\JsonResponse —

updateType()

updateType(\App\Http\Requests\Admin\DataDictRequest  $request, int  $id) : \Illuminate\Http\JsonResponse

更新类型

更新字典类型档案：名称、形态、编码与状态。编码变更时同步数据项冗余 type_code，防数据项不可见。

Parameters

\App\Http\Requests\Admin\DataDictRequest	$request
int	$id

Returns

\Illuminate\Http\JsonResponse —

deleteType()

deleteType(int  $id) : \Illuminate\Http\JsonResponse

删除类型

同时删除该类型下所有字典数据。

Parameters

int

$id

Returns

\Illuminate\Http\JsonResponse —

data()

data(\Illuminate\Http\Request  $request) : \Illuminate\Http\JsonResponse

字典列表

按 type_code 返回字典数据，缺省平铺列表，mode=tree 返回树形结构。 include_disabled=1 时包含停用项，供管理端维护；消费端默认只看启用项。

Parameters

\Illuminate\Http\Request

$request

Returns

\Illuminate\Http\JsonResponse —

options()

options(\Illuminate\Http\Request  $request) : \Illuminate\Http\JsonResponse

字典选项

消费端下拉数据源：返回启用项的 {label, value, css_class} 精简结构，按 sort 排序。

Parameters

\Illuminate\Http\Request

$request

Returns

\Illuminate\Http\JsonResponse —

createData()

createData(\App\Http\Requests\Admin\DataDictRequest  $request) : \Illuminate\Http\JsonResponse

创建数据项

在指定字典类型下新增数据项，父级校验、停用级联等约束由 Service 执行。

Parameters

\App\Http\Requests\Admin\DataDictRequest

$request

Returns

\Illuminate\Http\JsonResponse —

updateData()

updateData(\App\Http\Requests\Admin\DataDictRequest  $request, int  $id) : \Illuminate\Http\JsonResponse

更新数据项

更新显示值、存储值、父级与状态等字段；调整父级时级联重算子树。

Parameters

\App\Http\Requests\Admin\DataDictRequest	$request
int	$id

Returns

\Illuminate\Http\JsonResponse —

deleteData()

deleteData(int  $id) : \Illuminate\Http\JsonResponse

删除数据项

同时删除其所有子级。

Parameters

int

$id

Returns

\Illuminate\Http\JsonResponse —