From 9b9ff7f13ab65a11a81f8f085b2a5c21c9a15b8e Mon Sep 17 00:00:00 2001
From: zhenhui <1276357500@qq.com>
Date: Thu, 19 Mar 2026 09:32:57 +0800
Subject: [PATCH] =?UTF-8?q?[=E7=A7=AF=E5=88=86=E5=95=86=E5=9F=8E]=E6=94=B6?=
 =?UTF-8?q?=E8=8E=B7=E5=9C=B0=E5=9D=80=E7=AE=A1=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/admin/controller/mall/Address.php         |  72 ++++++++++
 app/common/model/MallAddress.php              |  49 +++++++
 app/common/validate/MallAddress.php           |  31 +++++
 web/src/lang/backend/en/mall/address.ts       |  15 ++
 web/src/lang/backend/zh-cn/mall/address.ts    |  15 ++
 web/src/views/backend/mall/address/index.vue  | 128 ++++++++++++++++++
 .../views/backend/mall/address/popupForm.vue  | 114 ++++++++++++++++
 7 files changed, 424 insertions(+)
 create mode 100644 app/admin/controller/mall/Address.php
 create mode 100644 app/common/model/MallAddress.php
 create mode 100644 app/common/validate/MallAddress.php
 create mode 100644 web/src/lang/backend/en/mall/address.ts
 create mode 100644 web/src/lang/backend/zh-cn/mall/address.ts
 create mode 100644 web/src/views/backend/mall/address/index.vue
 create mode 100644 web/src/views/backend/mall/address/popupForm.vue

diff --git a/app/admin/controller/mall/Address.php b/app/admin/controller/mall/Address.php
new file mode 100644
index 0000000..1222ad1
--- /dev/null
+++ b/app/admin/controller/mall/Address.php
@@ -0,0 +1,72 @@
+<?php
+
+namespace app\admin\controller\mall;
+
+use Throwable;
+use app\common\controller\Backend;
+
+/**
+ * 收获地址管理
+ */
+class Address extends Backend
+{
+    /**
+     * MallAddress模型对象
+     * @var object|null
+     * @phpstan-var \app\common\model\MallAddress|null
+     */
+    protected ?object $model = null;
+
+    protected array|string $preExcludeFields = ['id', 'create_time', 'update_time'];
+
+    protected array $withJoinTable = ['mallUser'];
+
+    protected string|array $quickSearchField = ['id'];
+
+    public function initialize(): void
+    {
+        parent::initialize();
+        $this->model = new \app\common\model\MallAddress();
+    }
+
+    /**
+     * 查看
+     * @throws Throwable
+     */
+    public function index(\Webman\Http\Request $request): \support\Response
+    {
+        $response = $this->initializeBackend($request);
+        if ($response !== null) {
+            return $response;
+        }
+
+        if ($request->get('select') || $request->post('select')) {
+            $this->_select();
+            return $this->success();
+        }
+
+        /**
+         * 1. withJoin 不可使用 alias 方法设置表别名，别名将自动使用关联模型名称（小写下划线命名规则）
+         * 2. 以下的别名设置了主表别名，同时便于拼接查询参数等
+         * 3. paginate 数据集可使用链式操作 each(function($item, $key) {}) 遍历处理
+         */
+        list($where, $alias, $limit, $order) = $this->queryBuilder();
+        $res = $this->model
+            ->withJoin($this->withJoinTable, $this->withJoinType)
+            ->visible(['mallUser' => ['username']])
+            ->alias($alias)
+            ->where($where)
+            ->order($order)
+            ->paginate($limit);
+
+        return $this->success('', [
+            'list'   => $res->items(),
+            'total'  => $res->total(),
+            'remark' => get_route_remark(),
+        ]);
+    }
+
+    /**
+     * 若需重写查看、编辑、删除等方法，请复制 @see \app\admin\library\traits\Backend 中对应的方法至此进行重写
+     */
+}
\ No newline at end of file
diff --git a/app/common/model/MallAddress.php b/app/common/model/MallAddress.php
new file mode 100644
index 0000000..97fdd45
--- /dev/null
+++ b/app/common/model/MallAddress.php
@@ -0,0 +1,49 @@
+<?php
+
+namespace app\common\model;
+
+use support\think\Model;
+
+/**
+ * MallAddress
+ */
+class MallAddress extends Model
+{
+    // 表名
+    protected $name = 'mall_address';
+
+    // 自动写入时间戳字段
+    protected $autoWriteTimestamp = true;
+
+    // 追加属性
+    protected $append = [
+        'region_text',
+    ];
+
+
+    public function getregionAttr($value): array
+    {
+        if ($value === '' || $value === null) return [];
+        if (!is_array($value)) {
+            return explode(',', $value);
+        }
+        return $value;
+    }
+
+    public function setregionAttr($value): string
+    {
+        return is_array($value) ? implode(',', $value) : $value;
+    }
+
+    public function getregionTextAttr($value, $row): string
+    {
+        if ($row['region'] === '' || $row['region'] === null) return '';
+        $cityNames = \support\think\Db::name('area')->whereIn('id', $row['region'])->column('name');
+        return $cityNames ? implode(',', $cityNames) : '';
+    }
+
+    public function mallUser(): \think\model\relation\BelongsTo
+    {
+        return $this->belongsTo(\app\common\model\MallUser::class, 'mall_user_id', 'id');
+    }
+}
\ No newline at end of file
diff --git a/app/common/validate/MallAddress.php b/app/common/validate/MallAddress.php
new file mode 100644
index 0000000..a41c1ef
--- /dev/null
+++ b/app/common/validate/MallAddress.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace app\common\validate;
+
+use think\Validate;
+
+class MallAddress extends Validate
+{
+    protected $failException = true;
+
+    /**
+     * 验证规则
+     */
+    protected $rule = [
+    ];
+
+    /**
+     * 提示消息
+     */
+    protected $message = [
+    ];
+
+    /**
+     * 验证场景
+     */
+    protected $scene = [
+        'add'  => [],
+        'edit' => [],
+    ];
+
+}
diff --git a/web/src/lang/backend/en/mall/address.ts b/web/src/lang/backend/en/mall/address.ts
new file mode 100644
index 0000000..41ecce3
--- /dev/null
+++ b/web/src/lang/backend/en/mall/address.ts
@@ -0,0 +1,15 @@
+export default {
+    id: 'id',
+    mall_user_id: 'mall_user_id',
+    malluser__username: 'username',
+    phone: 'phone',
+    region: 'region',
+    detail_address: 'detail_address',
+    address: 'address',
+    default_setting: 'default_setting',
+    'default_setting 0': 'default_setting 0',
+    'default_setting 1': 'default_setting 1',
+    create_time: 'create_time',
+    update_time: 'update_time',
+    'quick Search Fields': 'id',
+}
diff --git a/web/src/lang/backend/zh-cn/mall/address.ts b/web/src/lang/backend/zh-cn/mall/address.ts
new file mode 100644
index 0000000..2ffbbfb
--- /dev/null
+++ b/web/src/lang/backend/zh-cn/mall/address.ts
@@ -0,0 +1,15 @@
+export default {
+    id: 'ID',
+    mall_user_id: '用户',
+    malluser__username: '用户名',
+    phone: '电话',
+    region: '地区',
+    detail_address: '详细地址',
+    address: '地址',
+    default_setting: '默认地址',
+    'default_setting 0': '关',
+    'default_setting 1': '开',
+    create_time: '创建时间',
+    update_time: '修改时间',
+    'quick Search Fields': 'ID',
+}
diff --git a/web/src/views/backend/mall/address/index.vue b/web/src/views/backend/mall/address/index.vue
new file mode 100644
index 0000000..2829d43
--- /dev/null
+++ b/web/src/views/backend/mall/address/index.vue
@@ -0,0 +1,128 @@
+<template>
+    <div class="default-main ba-table-box">
+        <el-alert class="ba-table-alert" v-if="baTable.table.remark" :title="baTable.table.remark" type="info" show-icon />
+
+        <!-- 表格顶部菜单 -->
+        <!-- 自定义按钮请使用插槽，甚至公共搜索也可以使用具名插槽渲染，参见文档 -->
+        <TableHeader
+            :buttons="['refresh', 'add', 'edit', 'delete', 'comSearch', 'quickSearch', 'columnDisplay']"
+            :quick-search-placeholder="t('Quick search placeholder', { fields: t('mall.address.quick Search Fields') })"
+        ></TableHeader>
+
+        <!-- 表格 -->
+        <!-- 表格列有多种自定义渲染方式，比如自定义组件、具名插槽等，参见文档 -->
+        <!-- 要使用 el-table 组件原有的属性，直接加在 Table 标签上即可 -->
+        <Table ref="tableRef"></Table>
+
+        <!-- 表单 -->
+        <PopupForm />
+    </div>
+</template>
+
+<script setup lang="ts">
+import { onMounted, provide, useTemplateRef } from 'vue'
+import { useI18n } from 'vue-i18n'
+import PopupForm from './popupForm.vue'
+import { baTableApi } from '/@/api/common'
+import { defaultOptButtons } from '/@/components/table'
+import TableHeader from '/@/components/table/header/index.vue'
+import Table from '/@/components/table/index.vue'
+import baTableClass from '/@/utils/baTable'
+
+defineOptions({
+    name: 'mall/address',
+})
+
+const { t } = useI18n()
+const tableRef = useTemplateRef('tableRef')
+const optButtons: OptButton[] = defaultOptButtons(['edit', 'delete'])
+
+/**
+ * baTable 内包含了表格的所有数据且数据具备响应性，然后通过 provide 注入给了后代组件
+ */
+const baTable = new baTableClass(
+    new baTableApi('/admin/mall.Address/'),
+    {
+        pk: 'id',
+        column: [
+            { type: 'selection', align: 'center', operator: false },
+            { label: t('mall.address.id'), prop: 'id', align: 'center', width: 70, operator: 'RANGE', sortable: 'custom' },
+            {
+                label: t('mall.address.malluser__username'),
+                prop: 'mallUser.username',
+                align: 'center',
+                operatorPlaceholder: t('Fuzzy query'),
+                render: 'tags',
+                operator: 'LIKE',
+                comSearchRender: 'string',
+            },
+            {
+                label: t('mall.address.phone'),
+                prop: 'phone',
+                align: 'center',
+                operatorPlaceholder: t('Fuzzy query'),
+                sortable: false,
+                operator: 'LIKE',
+            },
+            { label: t('mall.address.region'), prop: 'region_text', align: 'center', operator: false },
+            {
+                label: t('mall.address.detail_address'),
+                prop: 'detail_address',
+                align: 'center',
+                operatorPlaceholder: t('Fuzzy query'),
+                sortable: false,
+                operator: 'LIKE',
+            },
+            {
+                label: t('mall.address.default_setting'),
+                prop: 'default_setting',
+                align: 'center',
+                operator: 'eq',
+                sortable: false,
+                render: 'switch',
+                replaceValue: { '0': t('mall.address.default_setting 0'), '1': t('mall.address.default_setting 1') },
+            },
+            {
+                label: t('mall.address.create_time'),
+                prop: 'create_time',
+                align: 'center',
+                render: 'datetime',
+                operator: 'RANGE',
+                comSearchRender: 'datetime',
+                sortable: 'custom',
+                width: 160,
+                timeFormat: 'yyyy-mm-dd hh:MM:ss',
+            },
+            {
+                label: t('mall.address.update_time'),
+                prop: 'update_time',
+                align: 'center',
+                render: 'datetime',
+                operator: 'RANGE',
+                comSearchRender: 'datetime',
+                sortable: 'custom',
+                width: 160,
+                timeFormat: 'yyyy-mm-dd hh:MM:ss',
+            },
+            { label: t('Operate'), align: 'center', width: 100, render: 'buttons', buttons: optButtons, operator: false },
+        ],
+        dblClickNotEditColumn: [undefined, 'default_setting'],
+    },
+    {
+        defaultItems: {},
+    }
+)
+
+provide('baTable', baTable)
+
+onMounted(() => {
+    baTable.table.ref = tableRef.value
+    baTable.mount()
+    baTable.getData()?.then(() => {
+        baTable.initSort()
+        baTable.dragSort()
+    })
+})
+</script>
+
+<style scoped lang="scss"></style>
diff --git a/web/src/views/backend/mall/address/popupForm.vue b/web/src/views/backend/mall/address/popupForm.vue
new file mode 100644
index 0000000..e83ca7c
--- /dev/null
+++ b/web/src/views/backend/mall/address/popupForm.vue
@@ -0,0 +1,114 @@
+<template>
+    <!-- 对话框表单 -->
+    <!-- 建议使用 Prettier 格式化代码 -->
+    <!-- el-form 内可以混用 el-form-item、FormItem、ba-input 等输入组件 -->
+    <el-dialog
+        class="ba-operate-dialog"
+        :close-on-click-modal="false"
+        :model-value="['Add', 'Edit'].includes(baTable.form.operate!)"
+        @close="baTable.toggleForm"
+    >
+        <template #header>
+            <div class="title" v-drag="['.ba-operate-dialog', '.el-dialog__header']" v-zoom="'.ba-operate-dialog'">
+                {{ baTable.form.operate ? t(baTable.form.operate) : '' }}
+            </div>
+        </template>
+        <el-scrollbar v-loading="baTable.form.loading" class="ba-table-form-scrollbar">
+            <div
+                class="ba-operate-form"
+                :class="'ba-' + baTable.form.operate + '-form'"
+                :style="config.layout.shrink ? '' : 'width: calc(100% - ' + baTable.form.labelWidth! / 2 + 'px)'"
+            >
+                <el-form
+                    v-if="!baTable.form.loading"
+                    ref="formRef"
+                    @submit.prevent=""
+                    @keyup.enter="baTable.onSubmit(formRef)"
+                    :model="baTable.form.items"
+                    :label-position="config.layout.shrink ? 'top' : 'right'"
+                    :label-width="baTable.form.labelWidth + 'px'"
+                    :rules="rules"
+                >
+                    <FormItem
+                        :label="t('mall.address.mall_user_id')"
+                        type="remoteSelect"
+                        v-model="baTable.form.items!.mall_user_id"
+                        prop="mall_user_id"
+                        :input-attr="{ pk: 'mall_user.id', field: 'username', remoteUrl: '/admin/mall.User/index' }"
+                        :placeholder="t('Please select field', { field: t('mall.address.mall_user_id') })"
+                    />
+                    <FormItem
+                        :label="t('mall.address.phone')"
+                        type="string"
+                        v-model="baTable.form.items!.phone"
+                        prop="phone"
+                        :placeholder="t('Please input field', { field: t('mall.address.phone') })"
+                    />
+                    <FormItem
+                        :label="t('mall.address.region')"
+                        type="city"
+                        v-model="baTable.form.items!.region"
+                        prop="region"
+                        :placeholder="t('Please select field', { field: t('mall.address.region') })"
+                    />
+                    <FormItem
+                        :label="t('mall.address.detail_address')"
+                        type="string"
+                        v-model="baTable.form.items!.detail_address"
+                        prop="detail_address"
+                        :placeholder="t('Please input field', { field: t('mall.address.detail_address') })"
+                    />
+                    <FormItem
+                        :label="t('mall.address.address')"
+                        type="textarea"
+                        v-model="baTable.form.items!.address"
+                        prop="address"
+                        :input-attr="{ rows: 3 }"
+                        @keyup.enter.stop=""
+                        @keyup.ctrl.enter="baTable.onSubmit(formRef)"
+                        :placeholder="t('Please input field', { field: t('mall.address.address') })"
+                    />
+                    <FormItem
+                        :label="t('mall.address.default_setting')"
+                        type="switch"
+                        v-model="baTable.form.items!.default_setting"
+                        prop="default_setting"
+                        :input-attr="{ content: { '0': t('mall.address.default_setting 0'), '1': t('mall.address.default_setting 1') } }"
+                    />
+                </el-form>
+            </div>
+        </el-scrollbar>
+        <template #footer>
+            <div :style="'width: calc(100% - ' + baTable.form.labelWidth! / 1.8 + 'px)'">
+                <el-button @click="baTable.toggleForm()">{{ t('Cancel') }}</el-button>
+                <el-button v-blur :loading="baTable.form.submitLoading" @click="baTable.onSubmit(formRef)" type="primary">
+                    {{ baTable.form.operateIds && baTable.form.operateIds.length > 1 ? t('Save and edit next item') : t('Save') }}
+                </el-button>
+            </div>
+        </template>
+    </el-dialog>
+</template>
+
+<script setup lang="ts">
+import type { FormItemRule } from 'element-plus'
+import { inject, reactive, useTemplateRef } from 'vue'
+import { useI18n } from 'vue-i18n'
+import FormItem from '/@/components/formItem/index.vue'
+import { useConfig } from '/@/stores/config'
+import type baTableClass from '/@/utils/baTable'
+import { buildValidatorData } from '/@/utils/validate'
+
+const config = useConfig()
+const formRef = useTemplateRef('formRef')
+const baTable = inject('baTable') as baTableClass
+
+const { t } = useI18n()
+
+const rules: Partial<Record<string, FormItemRule[]>> = reactive({
+    phone: [buildValidatorData({ name: 'required', title: t('mall.address.phone') })],
+    create_time: [buildValidatorData({ name: 'date', title: t('mall.address.create_time') })],
+    update_time: [buildValidatorData({ name: 'date', title: t('mall.address.update_time') })],
+})
+</script>
+
+<style scoped lang="scss"></style>