新增后台「教师名册」页
纯只读页面，形态与学生名册一致（#19）。 - src/api/gxmu/teacher：分页查询与导出接口 - src/views/gxmu/teacherRoster：学院/教工号/姓名/状态筛选 + 列表 + CSV 导出 - 导出按钮按 gxmu:teacher:export 权限渲染，与查询权限分开 - 手机号按 spec §5.2 不进任何列表接口，页面与导出均无该列
This commit is contained in:
@@ -0,0 +1,28 @@
|
|||||||
|
import request from '@/utils/request';
|
||||||
|
import type { ApiResult, PageResult } from '@/api';
|
||||||
|
import type { TeacherRoster, TeacherRosterParam } from './model';
|
||||||
|
|
||||||
|
/** 教师名册分页查询 */
|
||||||
|
export async function pageTeacherRoster(params: TeacherRosterParam) {
|
||||||
|
const res = await request.get<ApiResult<PageResult<TeacherRoster>>>(
|
||||||
|
'/gxmu/teacher/page',
|
||||||
|
{ params }
|
||||||
|
);
|
||||||
|
if (res.data.code === 0 && res.data.data) {
|
||||||
|
return res.data.data;
|
||||||
|
}
|
||||||
|
return Promise.reject(new Error(res.data.message));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 导出教师名册（返回列表，由前端生成文件；响应中不含手机号） */
|
||||||
|
export async function exportTeacherRoster(params: TeacherRosterParam) {
|
||||||
|
const res = await request.post<ApiResult<TeacherRoster[]>>(
|
||||||
|
'/gxmu/teacher/export',
|
||||||
|
null,
|
||||||
|
{ params }
|
||||||
|
);
|
||||||
|
if (res.data.code === 0 && res.data.data) {
|
||||||
|
return res.data.data;
|
||||||
|
}
|
||||||
|
return Promise.reject(new Error(res.data.message));
|
||||||
|
}
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
/**
|
||||||
|
* 教师名册（开放平台同步）
|
||||||
|
*/
|
||||||
|
|
||||||
|
/** 教师名册记录 */
|
||||||
|
export interface TeacherRoster {
|
||||||
|
id: number;
|
||||||
|
/** 教工号（开放平台外部键） */
|
||||||
|
jgh: string;
|
||||||
|
/** 姓名 */
|
||||||
|
xm?: string;
|
||||||
|
/** 性别码 */
|
||||||
|
xbm?: string;
|
||||||
|
/** 性别 */
|
||||||
|
sex?: string;
|
||||||
|
/** 单位号（平台原始值） */
|
||||||
|
dwh?: string;
|
||||||
|
/** 解析出的学院ID */
|
||||||
|
collegeId?: number;
|
||||||
|
/** 学院名称 */
|
||||||
|
collegeName?: string;
|
||||||
|
/** 科室教研室编号 */
|
||||||
|
ksjybh?: string;
|
||||||
|
/** 状态：1启用 0停用 */
|
||||||
|
status?: number;
|
||||||
|
/** 最近同步时间 */
|
||||||
|
syncTime?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 教师名册查询参数
|
||||||
|
*
|
||||||
|
* 说明：教师手机号由后端落盘但不出任何列表接口（spec §5.2），故此处没有该字段，
|
||||||
|
* 页面也不展示。
|
||||||
|
*/
|
||||||
|
export interface TeacherRosterParam {
|
||||||
|
page?: number;
|
||||||
|
limit?: number;
|
||||||
|
collegeId?: number;
|
||||||
|
jgh?: string;
|
||||||
|
xm?: string;
|
||||||
|
status?: number;
|
||||||
|
}
|
||||||
@@ -0,0 +1,243 @@
|
|||||||
|
<template>
|
||||||
|
<div class="page">
|
||||||
|
<div class="ele-body">
|
||||||
|
<a-card :bordered="false" :body-style="{ padding: '16px' }">
|
||||||
|
<ele-pro-table
|
||||||
|
ref="tableRef"
|
||||||
|
row-key="id"
|
||||||
|
:columns="columns"
|
||||||
|
:datasource="datasource"
|
||||||
|
:scroll="{ x: 1200 }"
|
||||||
|
tool-class="ele-toolbar-form"
|
||||||
|
>
|
||||||
|
<template #toolbar>
|
||||||
|
<a-space style="flex-wrap: wrap">
|
||||||
|
<a-select
|
||||||
|
v-model:value="collegeId"
|
||||||
|
allow-clear
|
||||||
|
show-search
|
||||||
|
option-filter-prop="label"
|
||||||
|
style="width: 220px"
|
||||||
|
placeholder="学院"
|
||||||
|
:options="collegeOptions"
|
||||||
|
/>
|
||||||
|
<a-input
|
||||||
|
v-model:value="jgh"
|
||||||
|
allow-clear
|
||||||
|
style="width: 160px"
|
||||||
|
placeholder="教工号"
|
||||||
|
@pressEnter="reload"
|
||||||
|
/>
|
||||||
|
<a-input
|
||||||
|
v-model:value="xm"
|
||||||
|
allow-clear
|
||||||
|
style="width: 140px"
|
||||||
|
placeholder="姓名"
|
||||||
|
@pressEnter="reload"
|
||||||
|
/>
|
||||||
|
<a-select
|
||||||
|
v-model:value="status"
|
||||||
|
style="width: 130px"
|
||||||
|
placeholder="状态"
|
||||||
|
:options="statusOptions"
|
||||||
|
/>
|
||||||
|
<a-button type="primary" @click="reload">查询</a-button>
|
||||||
|
<a-button @click="resetSearch">重置</a-button>
|
||||||
|
<a-button
|
||||||
|
v-if="hasPermission('gxmu:teacher:export')"
|
||||||
|
:loading="exporting"
|
||||||
|
@click="doExport"
|
||||||
|
>
|
||||||
|
导出
|
||||||
|
</a-button>
|
||||||
|
</a-space>
|
||||||
|
</template>
|
||||||
|
<template #bodyCell="{ column, record }">
|
||||||
|
<template v-if="column.key === 'status'">
|
||||||
|
<a-tag :color="record.status === 1 ? 'green' : 'default'">
|
||||||
|
{{ record.status === 1 ? '启用' : '停用' }}
|
||||||
|
</a-tag>
|
||||||
|
</template>
|
||||||
|
</template>
|
||||||
|
</ele-pro-table>
|
||||||
|
</a-card>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script lang="ts" setup>
|
||||||
|
import { onMounted, ref } from 'vue';
|
||||||
|
import { message } from 'ant-design-vue';
|
||||||
|
import type { EleProTable } from 'ele-admin-pro';
|
||||||
|
import { toDateString } from 'ele-admin-pro';
|
||||||
|
import type {
|
||||||
|
DatasourceFunction,
|
||||||
|
ColumnItem
|
||||||
|
} from 'ele-admin-pro/es/ele-pro-table/types';
|
||||||
|
import { hasPermission } from '@/utils/permission';
|
||||||
|
import { listOrganizations } from '@/api/system/organization';
|
||||||
|
import { exportTeacherRoster, pageTeacherRoster } from '@/api/gxmu/teacher';
|
||||||
|
import type {
|
||||||
|
TeacherRoster,
|
||||||
|
TeacherRosterParam
|
||||||
|
} from '@/api/gxmu/teacher/model';
|
||||||
|
|
||||||
|
/** 学院挂载的父节点：广西医科大学 */
|
||||||
|
const COLLEGE_PARENT_ID = 24;
|
||||||
|
|
||||||
|
const tableRef = ref<InstanceType<typeof EleProTable> | null>(null);
|
||||||
|
const collegeId = ref<number | undefined>(undefined);
|
||||||
|
const jgh = ref<string>('');
|
||||||
|
const xm = ref<string>('');
|
||||||
|
const status = ref<number>(1);
|
||||||
|
const exporting = ref(false);
|
||||||
|
const collegeOptions = ref<{ label: string; value: number }[]>([]);
|
||||||
|
|
||||||
|
/** 停用＝上游已消失，默认不显示（ADR-0004） */
|
||||||
|
const statusOptions = [
|
||||||
|
{ label: '启用', value: 1 },
|
||||||
|
{ label: '停用', value: 0 }
|
||||||
|
];
|
||||||
|
|
||||||
|
const columns = ref<ColumnItem[]>([
|
||||||
|
{ title: '教工号', dataIndex: 'jgh', key: 'jgh', width: 140 },
|
||||||
|
{ title: '姓名', dataIndex: 'xm', key: 'xm', width: 110 },
|
||||||
|
{ title: '性别', dataIndex: 'sex', key: 'sex', width: 80 },
|
||||||
|
{
|
||||||
|
title: '学院',
|
||||||
|
dataIndex: 'collegeName',
|
||||||
|
key: 'collegeName',
|
||||||
|
width: 220,
|
||||||
|
customRender: ({ text }) => text || '-'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
title: '单位号',
|
||||||
|
dataIndex: 'dwh',
|
||||||
|
key: 'dwh',
|
||||||
|
width: 120,
|
||||||
|
customRender: ({ text }) => text || '-'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
title: '科室教研室编号',
|
||||||
|
dataIndex: 'ksjybh',
|
||||||
|
key: 'ksjybh',
|
||||||
|
width: 160,
|
||||||
|
customRender: ({ text }) => text || '-'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
title: '状态',
|
||||||
|
dataIndex: 'status',
|
||||||
|
key: 'status',
|
||||||
|
align: 'center',
|
||||||
|
width: 90
|
||||||
|
},
|
||||||
|
{
|
||||||
|
title: '同步时间',
|
||||||
|
dataIndex: 'syncTime',
|
||||||
|
key: 'syncTime',
|
||||||
|
width: 170,
|
||||||
|
customRender: ({ text }) => (text ? toDateString(text) : '-')
|
||||||
|
}
|
||||||
|
]);
|
||||||
|
|
||||||
|
const currentParam = (): TeacherRosterParam => ({
|
||||||
|
collegeId: collegeId.value,
|
||||||
|
jgh: jgh.value.trim() || undefined,
|
||||||
|
xm: xm.value.trim() || undefined,
|
||||||
|
status: status.value
|
||||||
|
});
|
||||||
|
|
||||||
|
const datasource: DatasourceFunction = ({ page, limit }) => {
|
||||||
|
return pageTeacherRoster({ ...currentParam(), page, limit }).catch((e) => {
|
||||||
|
message.error(e.message);
|
||||||
|
return { list: [] as TeacherRoster[], count: 0 };
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const reload = () => {
|
||||||
|
tableRef.value?.reload();
|
||||||
|
};
|
||||||
|
|
||||||
|
const loadColleges = () => {
|
||||||
|
// 学院取组织树中「广西医科大学」的直接子节点，与学生名册一致
|
||||||
|
listOrganizations({ parentId: COLLEGE_PARENT_ID })
|
||||||
|
.then((list) => {
|
||||||
|
collegeOptions.value = list.map((item) => ({
|
||||||
|
label: item.organizationFullName || item.organizationName || '',
|
||||||
|
value: item.organizationId || 0
|
||||||
|
}));
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
message.error(e.message);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const resetSearch = () => {
|
||||||
|
collegeId.value = undefined;
|
||||||
|
jgh.value = '';
|
||||||
|
xm.value = '';
|
||||||
|
status.value = 1;
|
||||||
|
reload();
|
||||||
|
};
|
||||||
|
|
||||||
|
const doExport = () => {
|
||||||
|
exporting.value = true;
|
||||||
|
exportTeacherRoster(currentParam())
|
||||||
|
.then((list) => {
|
||||||
|
if (!list.length) {
|
||||||
|
message.warning('没有可导出的数据');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
// 手机号不在导出范围内：后端不返回该字段（spec §5.2）
|
||||||
|
const header = [
|
||||||
|
'教工号',
|
||||||
|
'姓名',
|
||||||
|
'性别',
|
||||||
|
'学院',
|
||||||
|
'单位号',
|
||||||
|
'科室教研室编号',
|
||||||
|
'状态'
|
||||||
|
];
|
||||||
|
const lines = list.map((item) =>
|
||||||
|
[
|
||||||
|
item.jgh,
|
||||||
|
item.xm,
|
||||||
|
item.sex,
|
||||||
|
item.collegeName,
|
||||||
|
item.dwh || '',
|
||||||
|
item.ksjybh || '',
|
||||||
|
item.status === 1 ? '启用' : '停用'
|
||||||
|
]
|
||||||
|
.map((v) => `"${String(v ?? '').replace(/"/g, '""')}"`)
|
||||||
|
.join(',')
|
||||||
|
);
|
||||||
|
const csv = '\uFEFF' + [header.join(','), ...lines].join('\r\n');
|
||||||
|
const blob = new Blob([csv], { type: 'text/csv;charset=utf-8' });
|
||||||
|
const url = URL.createObjectURL(blob);
|
||||||
|
const a = document.createElement('a');
|
||||||
|
a.href = url;
|
||||||
|
a.download = `教师名册_${new Date().toISOString().slice(0, 10)}.csv`;
|
||||||
|
a.click();
|
||||||
|
URL.revokeObjectURL(url);
|
||||||
|
message.success(`已导出 ${list.length} 条`);
|
||||||
|
})
|
||||||
|
.catch((e) => {
|
||||||
|
message.error(e.message || '导出失败');
|
||||||
|
})
|
||||||
|
.finally(() => {
|
||||||
|
exporting.value = false;
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
onMounted(() => {
|
||||||
|
loadColleges();
|
||||||
|
});
|
||||||
|
|
||||||
|
defineExpose({ reload });
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<script lang="ts">
|
||||||
|
export default {
|
||||||
|
name: 'TeacherRoster'
|
||||||
|
};
|
||||||
|
</script>
|
||||||
Reference in New Issue
Block a user