feat：增加 area 地区

apps/web-antd/src/api/system/area/index.ts

@@ -0,0 +1,24 @@
+import { requestClient } from '#/api/request';
+
+export namespace SystemAreaApi {
+  /** 地区信息 */
+  export interface SystemArea {
+    id?: number;
+    name: string;
+    code: string;
+    parentId?: number;
+    sort?: number;
+    status?: number;
+    createTime?: Date;
+  }
+}
+
+/** 获得地区树 */
+export function getAreaTree() {
+  return requestClient.get<SystemAreaApi.SystemArea[]>('/system/area/tree');
+}
+
+/** 获得 IP 对应的地区名 */
+export function getAreaByIp(ip: string) {
+  return requestClient.get<string>(`/system/area/get-by-ip?ip=${ip}`);
+}

apps/web-antd/src/views/system/area/data.ts

@@ -0,0 +1,50 @@
+import type { VxeTableGridOptions } from '@vben/plugins/vxe-table';
+import type { VbenFormSchema } from '#/adapter/form';
+import type { OnActionClickFn } from '#/adapter/vxe-table';
+import type { SystemAreaApi } from '#/api/system/area';
+
+import { z } from '#/adapter/form';
+import { useAccess } from '@vben/access';
+
+/** 查询 IP 的表单 */
+export function useFormSchema(): VbenFormSchema[] {
+  return [
+    {
+      fieldName: 'ip',
+      label: 'IP 地址',
+      component: 'Input',
+      componentProps: {
+        placeholder: '请输入 IP 地址',
+      },
+      rules: 'required',
+    },
+    {
+      fieldName: 'result',
+      label: '地址',
+      component: 'Input',
+      componentProps: {
+        placeholder: '展示查询 IP 结果',
+        readonly: true,
+      }
+    },
+  ];
+}
+
+/** 列表的字段 */
+export function useGridColumns(): VxeTableGridOptions<SystemAreaApi.SystemArea>['columns'] {
+  return [
+    {
+      field: 'id',
+      title: '地区编码',
+      minWidth: 120,
+      align: 'left',
+      fixed: 'left',
+      treeNode: true,
+    },
+    {
+      field: 'name',
+      title: '地区名称',
+      minWidth: 200,
+    },
+  ];
+}

apps/web-antd/src/views/system/area/index.vue

@@ -0,0 +1,73 @@
+<script lang="ts" setup>
+import type { VxeTableGridOptions } from '#/adapter/vxe-table';
+
+import { Page, useVbenModal } from '@vben/common-ui';
+import { Button } from 'ant-design-vue';
+import { Search } from '@vben/icons';
+import Form from './modules/form.vue';
+import { DocAlert } from '#/components/doc-alert';
+
+import { useVbenVxeGrid } from '#/adapter/vxe-table';
+import { getAreaTree } from '#/api/system/area';
+
+import { useGridColumns } from './data';
+
+const [FormModal, formModalApi] = useVbenModal({
+  connectedComponent: Form,
+  destroyOnClose: true,
+});
+
+/** 刷新表格 */
+function onRefresh() {
+  gridApi.query();
+}
+
+/** 查询 IP */
+function onQueryIp() {
+  formModalApi.setData(null).open();
+}
+
+const [Grid, gridApi] = useVbenVxeGrid({
+  gridOptions: {
+    columns: useGridColumns(),
+    height: 'auto',
+    keepSource: true,
+    pagerConfig: {
+      enabled: false,
+    },
+    proxyConfig: {
+      ajax: {
+        query: async () => {
+          return await getAreaTree();
+        },
+      },
+    },
+    rowConfig: {
+      keyField: 'id',
+    },
+    toolbarConfig: {
+      refresh: { code: 'query' },
+    },
+    treeConfig: {
+      rowField: 'id',
+      reserve: true,
+    },
+  } as VxeTableGridOptions,
+});
+</script>
+
+<template>
+  <Page auto-content-height>
+    <DocAlert title="地区 & IP" url="https://doc.iocoder.cn/area-and-ip/" />
+
+    <FormModal @success="onRefresh" />
+    <Grid table-title="地区列表">
+      <template #toolbar-tools>
+        <Button type="primary" @click="onQueryIp">
+          <Search class="size-5" />
+          IP 查询
+        </Button>
+      </template>
+    </Grid>
+  </Page>
+</template>

apps/web-antd/src/views/system/area/modules/form.vue

@@ -0,0 +1,47 @@
+<script lang="ts" setup>
+import { useVbenModal } from '@vben/common-ui';
+import { message } from 'ant-design-vue';
+
+import { $t } from '#/locales';
+import { useVbenForm } from '#/adapter/form';
+import { getAreaByIp } from '#/api/system/area';
+
+import { useFormSchema } from '../data';
+
+const emit = defineEmits(['success']);
+
+const [Form, { setFieldValue, setValues, validate, getValues }] = useVbenForm({
+  layout: 'horizontal',
+  schema: useFormSchema(),
+  showDefaultActions: false,
+});
+
+const [Modal, modalApi] = useVbenModal({
+  async onConfirm() {
+    const { valid } = await validate();
+    if (!valid) {
+      return;
+    }
+    modalApi.lock();
+    // 提交表单
+    const data = await getValues();
+    try {
+      const result = await getAreaByIp(data.ip);
+      // 设置结果
+      await setFieldValue('result', result);
+      message.success({
+        content: $t('ui.actionMessage.operationSuccess'),
+        key: 'action_process_msg',
+      });
+    } finally {
+      modalApi.lock(false);
+    }
+  }
+});
+</script>
+
+<template>
+  <Modal title="IP 查询">
+    <Form class="mx-4" />
+  </Modal>
+</template>