\App\Http\Controllers\AdminDataRegionController

地区数据控制器

职责：地区树/统计/级联/路径/搜索等读接口与地区 CRUD、金字塔级联状态写接口的 HTTP 入口，校验入参、编排服务、组装统一响应，业务下沉 DataRegionService。

┌────────────────── 分区导航（按此顺序阅读）──────────────────┐ 分区 1 · 地区查询 index / stats / cascader / path / search 分区 2 · 地区写操作 store / update / updateStatus / destroy └────────────────────────────────────────────────────────────┘

Summary

Methods

Properties

Constants

__construct()
index()
stats()
cascader()
path()
search()
store()
update()
updateStatus()
destroy()

No public properties found

No constants found

No protected methods found

No protected properties found

N/A

No private methods found

$regionService

N/A

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

\App\Http\Controllers\Admin\DataRegionController
Uses

Properties

$regionService

$regionService : \App\Services\Admin\DataRegionService

Type

DataRegionService

Methods

__construct()

__construct(\App\Services\Admin\DataRegionService  $regionService) : mixed

Parameters

\App\Services\Admin\DataRegionService

$regionService

Returns

mixed —

index()

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

地区树

按需加载：缺省返回顶级地区列表，传 parent_id 返回该地区子级，每级节点带 children 递归子树。

Parameters

\Illuminate\Http\Request

$request

Returns

\Illuminate\Http\JsonResponse —

stats()

stats() : \Illuminate\Http\JsonResponse

地区统计

返回地区总数与各级数量，供管理页概览卡展示，结果走缓存。

Returns

\Illuminate\Http\JsonResponse —

cascader()

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

地区级联

级联选择器数据：value/label/children 结构，1-5 级可配， max_level 控制深度，parent_id 懒加载子级。

Parameters

\Illuminate\Http\Request

$request

Returns

\Illuminate\Http\JsonResponse —

path()

path(\App\Models\SysRegion  $region) : \Illuminate\Http\JsonResponse

地区路径

返回祖先链与自身：自顶向下逐级 id/name/level，编辑回显定位用。

Parameters

\App\Models\SysRegion

$region

Returns

\Illuminate\Http\JsonResponse —

search()

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

地区搜索

任意层级搜索定位：keyword 匹配名称、编码前缀与拼音去空格子串，每行附带祖先链 path，供前端定位层级。缺省返回 50 条，上限 100 条。

Parameters

\Illuminate\Http\Request

$request

Returns

\Illuminate\Http\JsonResponse —

store()

store(\App\Http\Requests\Admin\DataRegionRequest  $request) : \Illuminate\Http\JsonResponse

创建地区

层级按父级自动推导，最多五级：省、市、区、街道、村。

Parameters

\App\Http\Requests\Admin\DataRegionRequest

$request

Returns

\Illuminate\Http\JsonResponse —

update()

update(\App\Http\Requests\Admin\DataRegionRequest  $request, \App\Models\SysRegion  $region) : \Illuminate\Http\JsonResponse

更新地区

调整父级时级联重算全部后代的祖级路径与层级。

Parameters

\App\Http\Requests\Admin\DataRegionRequest	$request
\App\Models\SysRegion	$region

Returns

\Illuminate\Http\JsonResponse —

updateStatus()

updateStatus(\App\Models\SysRegion  $region, \App\Http\Requests\Admin\DataRegionStatusRequest  $request) : \Illuminate\Http\JsonResponse

金字塔级联启用/禁用

勾选某级即该地区及其全部子孙地区一起启用或停用，返回实际生效的地区条数。校验走 DataRegionStatusRequest，写库下沉 DataRegionService::updateStatus。

Parameters

\App\Models\SysRegion	$region
\App\Http\Requests\Admin\DataRegionStatusRequest	$request

Returns

\Illuminate\Http\JsonResponse —

destroy()

destroy(\App\Models\SysRegion  $region) : \Illuminate\Http\JsonResponse

删除地区

存在子地区时拒绝删除。

Parameters

\App\Models\SysRegion

$region

Returns

\Illuminate\Http\JsonResponse —