校区服务

app/JsonRpc/Contract/CampusServiceInterface.php

@@ -0,0 +1,40 @@
+<?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;
+}