基础数据-校区服务

This commit is contained in:
Aether
2025-09-19 15:14:20 +08:00
parent 824510d57c
commit b69f14ded2
16 changed files with 757 additions and 300 deletions

View File

@@ -1,40 +0,0 @@
<?php
declare(strict_types=1);
namespace App\JsonRpc\Contract;
interface CampusServiceInterface
{
/**
* 获取单个校区详情.
* @param int $id 校区ID
*/
public function getCampus(int $id): array;
/**
* 批量获取校区信息.
* @param array $ids 校区ID列表
*/
public function batchGetCampus(array $ids): array;
/**
* 按省份获取校区列表.
* @param string $province 省份名称
*/
public function getCampusByProvince(string $province): array;
/**
* 按城市获取校区列表.
* @param string $province 省份
* @param string $city 城市
*/
public function getCampusByCity(string $province, string $city): array;
/**
* 获取校区完整层级路径.
* @param int $campusId 校区ID
* @return array 如:[省份, 城市, 校区]
*/
public function getCampusHierarchy(int $campusId): array;
}

View File

@@ -4,10 +4,10 @@ declare(strict_types=1);
namespace App\JsonRpc\Service;
use App\JsonRpc\Contract\CampusServiceInterface;
use Aether\Exception\BusinessException;
use App\Model\Campus;
use Hyperf\RpcServer\Annotation\RpcService;
use RuntimeException;
use MicroService\Contract\CampusServiceInterface;
#[RpcService(
name: 'DataCampus',
@@ -17,67 +17,47 @@ use RuntimeException;
)]
class CampusService implements CampusServiceInterface
{
public function getCampus(int $id): array
public function getCampusById(int $id): array
{
$campus = Campus::find($id);
if (! $campus) {
throw new RuntimeException("校区不存在: {$id}");
if (! $campus || $campus->status != 1) {
throw new BusinessException('校区不存在或已禁用', 10001);
}
return $campus->toArray();
}
public function batchGetCampus(array $ids): array
public function getCampusesByIds(array $ids): array
{
if (empty($ids)) {
return [];
}
$campuses = Campus::whereIn('id', $ids)->get()->toArray();
return array_column($campuses, null, 'id');
}
public function getCampusByProvince(string $province): array
{
return Campus::province($province)
->level(3)
return Campus::whereIn('id', $ids)
->enabled()
->get()
->toArray();
}
public function getCampusByCity(string $province, string $city): array
public function getCampusesByParentId(int $parentId): array
{
return Campus::province($province)
->city($city)
->level(3)
return Campus::where('parent_id', $parentId)
->enabled()
->get()
->toArray();
}
public function getCampusHierarchy(int $campusId): array
public function getProvinces(): array
{
$hierarchy = [];
$current = Campus::find($campusId);
return Campus::level(1)
->enabled()
->orderBy('name')
->get(['id', 'name', 'province'])
->toArray();
}
if (! $current) {
return $hierarchy;
}
// 从校区向上追溯层级
while ($current) {
array_unshift($hierarchy, [
'id' => $current->id,
'name' => $current->name,
'level' => $current->level,
'province' => $current->province,
'city' => $current->city,
]);
if ($current->parent_id === 0) {
break;
}
$current = Campus::find($current->parent_id);
}
return $hierarchy;
public function getCitiesByProvince(string $province): array
{
return Campus::level(2)
->province($province)
->enabled()
->orderBy('name')
->get(['id', 'name', 'city'])
->toArray();
}
}