feat(store): add two-level store categories for admin and partner open-store

Admin CRUD under stores menu; partner picks leaf category on create.
Default sync only inserts missing rows and never updates existing ones.

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/admin-web/src/App.tsx

@@ -20,6 +20,7 @@ import CityPartnersPage from './pages/CityPartnersPage';
 import CityWarehousesPage from './pages/CityWarehousesPage';
 import FulfillmentProvidersPage from './pages/FulfillmentProvidersPage';
 import StoreMediaPage from './pages/StoreMediaPage';
+import StoreCategoriesPage from './pages/StoreCategoriesPage';
 import PromoCodesPage from './pages/PromoCodesPage';
 import PromoCodeDetailLayout from './pages/promo/PromoCodeDetailLayout';
 import PromoCodeDetailPage from './pages/promo/PromoCodeDetailPage';
@@ -69,6 +70,7 @@ export default function App() {
         <Route path="/products" element={<ProductsPage />} />
         <Route path="/product-detail-templates" element={<ProductDetailTemplatesPage />} />
         <Route path="/stores" element={<StoresPage />} />
+        <Route path="/store-categories" element={<StoreCategoriesPage />} />
         <Route path="/store-accounts" element={<StoreAccountsPage />} />
         <Route path="/store-media" element={<StoreMediaPage />} />
         <Route path="/resources" element={<ResourcesPage />} />

apps/admin-web/src/layouts/AdminLayout.tsx

@@ -44,6 +44,7 @@ const MENU_ITEMS: MenuProps['items'] = [
     label: '门店',
     children: [
       { key: '/stores', label: '门店列表' },
+      { key: '/store-categories', label: '门店分类' },
       { key: '/store-accounts', label: '门店账户' },
       { key: '/store-media', label: '门店资源' },
     ],

apps/admin-web/src/lib/hq-log.ts

@@ -27,6 +27,10 @@ export const HQ_OPERATION_ACTION_OPTIONS = [
   { value: 'STORE_AUDIT', label: '门店审核' },
   { value: 'STORE_ACCOUNT_CREATE', label: '新增门店账户' },
   { value: 'STORE_ACCOUNT_UPDATE', label: '编辑门店账户' },
+  { value: 'STORE_CATEGORY_CREATE', label: '新增门店分类' },
+  { value: 'STORE_CATEGORY_UPDATE', label: '编辑门店分类' },
+  { value: 'STORE_CATEGORY_DELETE', label: '删除门店分类' },
+  { value: 'STORE_CATEGORY_ENSURE', label: '初始化默认门店分类' },
   { value: 'PRODUCT_CREATE', label: '新增商品' },
   { value: 'PRODUCT_UPDATE', label: '编辑商品' },
   { value: 'PRODUCT_DELETE', label: '删除商品' },

apps/admin-web/src/pages/StoreCategoriesPage.tsx

@@ -0,0 +1,233 @@
+import { useEffect, useMemo, useState } from 'react';
+import {
+  Button, Form, Input, InputNumber, Modal, Popconfirm, Select, Space, Table, Tag, Typography, message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { request } from '../lib/api';
+
+type CategoryNode = {
+  id: string;
+  code: string;
+  name: string;
+  sort: number;
+  parentId: string | null;
+  status: string;
+  children?: CategoryNode[];
+};
+
+type FlatRow = CategoryNode & { level: 1 | 2; parentName?: string };
+
+function flattenTree(tree: CategoryNode[]): FlatRow[] {
+  const rows: FlatRow[] = [];
+  for (const root of tree) {
+    rows.push({ ...root, level: 1, children: undefined });
+    for (const child of root.children ?? []) {
+      rows.push({
+        ...child,
+        level: 2,
+        parentName: root.name,
+        children: undefined,
+      });
+    }
+  }
+  return rows;
+}
+
+export default function StoreCategoriesPage() {
+  const [tree, setTree] = useState<CategoryNode[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editing, setEditing] = useState<FlatRow | null>(null);
+  const [form] = Form.useForm();
+
+  const rows = useMemo(() => flattenTree(tree), [tree]);
+  const rootOptions = useMemo(
+    () => tree.filter((n) => n.status === 'ACTIVE').map((n) => ({ value: n.id, label: n.name })),
+    [tree],
+  );
+
+  async function reload() {
+    setLoading(true);
+    try {
+      const data = await request<CategoryNode[]>('/admin/store-categories');
+      setTree(Array.isArray(data) ? data : []);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '加载失败');
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  useEffect(() => {
+    void reload();
+  }, []);
+
+  function openCreate(parentId?: string) {
+    setEditing(null);
+    form.setFieldsValue({
+      code: '',
+      name: '',
+      sort: 0,
+      parentId: parentId || undefined,
+      status: 'ACTIVE',
+    });
+    setModalOpen(true);
+  }
+
+  function openEdit(row: FlatRow) {
+    setEditing(row);
+    form.setFieldsValue({
+      code: row.code,
+      name: row.name,
+      sort: row.sort,
+      parentId: row.parentId || undefined,
+      status: row.status,
+    });
+    setModalOpen(true);
+  }
+
+  async function submit() {
+    const values = await form.validateFields();
+    const payload = {
+      code: String(values.code).trim().toUpperCase(),
+      name: String(values.name).trim(),
+      sort: Number(values.sort ?? 0),
+      parentId: values.parentId || null,
+      status: values.status || 'ACTIVE',
+    };
+    if (editing) {
+      await request(`/admin/store-categories/${editing.id}`, {
+        method: 'PUT',
+        body: JSON.stringify(payload),
+      });
+      message.success('已保存');
+    } else {
+      await request('/admin/store-categories', {
+        method: 'POST',
+        body: JSON.stringify(payload),
+      });
+      message.success('已创建');
+    }
+    setModalOpen(false);
+    void reload();
+  }
+
+  const columns: ColumnsType<FlatRow> = [
+    {
+      title: '层级',
+      dataIndex: 'level',
+      width: 80,
+      render: (level) => (level === 1 ? <Tag color="blue">一级</Tag> : <Tag>二级</Tag>),
+    },
+    {
+      title: '名称',
+      dataIndex: 'name',
+      render: (name, row) => (
+        <span style={{ paddingLeft: row.level === 2 ? 24 : 0 }}>
+          {row.level === 2 ? `${row.parentName || ''} / ` : ''}
+          {name}
+        </span>
+      ),
+    },
+    { title: '编码', dataIndex: 'code', width: 140 },
+    { title: '排序', dataIndex: 'sort', width: 80 },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 90,
+      render: (s) => (
+        <Tag color={s === 'ACTIVE' ? 'green' : 'default'}>{s === 'ACTIVE' ? '启用' : '停用'}</Tag>
+      ),
+    },
+    {
+      title: '操作',
+      width: 220,
+      render: (_, row) => (
+        <Space wrap>
+          <Button type="link" size="small" onClick={() => openEdit(row)}>编辑</Button>
+          {row.level === 1 ? (
+            <Button type="link" size="small" onClick={() => openCreate(row.id)}>加二级</Button>
+          ) : null}
+          <Popconfirm
+            title={row.level === 1 ? '删除一级分类？若有门店占用将改为停用' : '删除该分类？若有门店占用将改为停用'}
+            onConfirm={async () => {
+              await request(`/admin/store-categories/${row.id}`, { method: 'DELETE' });
+              message.success('已处理');
+              void reload();
+            }}
+          >
+            <Button type="link" size="small" danger>删除</Button>
+          </Popconfirm>
+        </Space>
+      ),
+    },
+  ];
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16, width: '100%', justifyContent: 'space-between' }}>
+        <Space direction="vertical" size={0}>
+          <Typography.Title level={4} style={{ margin: 0 }}>门店分类</Typography.Title>
+          <Typography.Text type="secondary">两级分类：一级（餐饮/住宿/娱乐）→ 二级业态，供合伙人开店选择</Typography.Text>
+        </Space>
+        <Space>
+          <Button
+            onClick={async () => {
+              await request('/admin/store-categories/ensure-defaults', { method: 'POST' });
+              message.success('已同步默认分类');
+              void reload();
+            }}
+          >
+            同步默认分类
+          </Button>
+          <Button type="primary" onClick={() => openCreate()}>新增一级</Button>
+        </Space>
+      </Space>
+
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={rows}
+        pagination={false}
+        className="admin-table-nowrap"
+      />
+
+      <Modal
+        title={editing ? '编辑分类' : '新增分类'}
+        open={modalOpen}
+        onCancel={() => setModalOpen(false)}
+        onOk={() => void submit()}
+        destroyOnClose
+      >
+        <Form form={form} layout="vertical">
+          <Form.Item name="code" label="编码" rules={[{ required: true, message: '请填写编码' }]}>
+            <Input placeholder="如 DINING / HOTPOT" disabled={!!editing} />
+          </Form.Item>
+          <Form.Item name="name" label="名称" rules={[{ required: true, message: '请填写名称' }]}>
+            <Input placeholder="分类名称" />
+          </Form.Item>
+          <Form.Item name="parentId" label="上级分类（空=一级）">
+            <Select
+              allowClear
+              placeholder="不选则为一级分类"
+              options={rootOptions.filter((o) => o.value !== editing?.id)}
+              disabled={editing?.level === 1 && (tree.find((t) => t.id === editing.id)?.children?.length ?? 0) > 0}
+            />
+          </Form.Item>
+          <Form.Item name="sort" label="排序" initialValue={0}>
+            <InputNumber style={{ width: '100%' }} />
+          </Form.Item>
+          <Form.Item name="status" label="状态" initialValue="ACTIVE">
+            <Select
+              options={[
+                { value: 'ACTIVE', label: '启用' },
+                { value: 'DISABLED', label: '停用' },
+              ]}
+            />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  );
+}

apps/admin-web/src/pages/StoresPage.tsx

@@ -19,8 +19,15 @@ import {
   message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
+import { FilePdfOutlined, LinkOutlined } from '@ant-design/icons';
 import { request, type Paginated } from '../lib/api';
-import { ADMIN_OPTIONS_PAGE_SIZE, STORE_AUDIT_STATUS_LABELS, STORE_STATUS_LABELS, fmtTime } from '../lib/constants';
+import {
+  ADMIN_OPTIONS_PAGE_SIZE,
+  RESOURCE_BIZ_TYPE_LABELS,
+  STORE_AUDIT_STATUS_LABELS,
+  STORE_STATUS_LABELS,
+  fmtTime,
+} from '../lib/constants';
 import {
   validateStoreCreateStep1,
   validateStoreCreateStep3,
@@ -37,6 +44,209 @@ const CREATE_STEPS = [
   { title: '结算资质' },
 ];
 
+type StoreMediaItem = {
+  id?: string;
+  bizType?: string;
+  mediaType?: string;
+  url?: string | null;
+};
+
+function isImageMedia(url: string, mediaType?: string) {
+  if (mediaType === 'IMAGE') return true;
+  if (mediaType === 'VIDEO' || mediaType === 'FILE') {
+    return /\.(png|jpe?g|gif|webp|bmp|heic)(\?|#|$)/i.test(url);
+  }
+  return /\.(png|jpe?g|gif|webp|bmp|heic)(\?|#|$)/i.test(url);
+}
+
+function isPdfUrl(url: string) {
+  return /\.pdf(\?|#|$)/i.test(url);
+}
+
+function collectMediaUrls(detail: Record<string, unknown>) {
+  const media = Array.isArray(detail.media) ? (detail.media as StoreMediaItem[]) : [];
+  const byType = (bizType: string) =>
+    media
+      .filter((item) => String(item.bizType || '').toUpperCase() === bizType)
+      .map((item) => ({
+        id: String(item.id || item.url || ''),
+        url: String(item.url || '').trim(),
+        mediaType: item.mediaType ? String(item.mediaType) : undefined,
+      }))
+      .filter((item) => item.url);
+
+  const covers = byType('COVER');
+  const coverUrl = detail.coverUrl ? String(detail.coverUrl).trim() : '';
+  if (coverUrl && !covers.some((item) => item.url === coverUrl)) {
+    covers.unshift({ id: 'cover', url: coverUrl, mediaType: 'IMAGE' });
+  }
+
+  return {
+    covers,
+    envs: byType('ENV'),
+    contracts: byType('CONTRACT'),
+  };
+}
+
+function StoreAuditMediaSection({ detail }: { detail: Record<string, unknown> }) {
+  const { covers, envs, contracts } = collectMediaUrls(detail);
+  const [pdfUrl, setPdfUrl] = useState<string | null>(null);
+  const gallery = [...covers, ...envs].filter((item) => isImageMedia(item.url, item.mediaType));
+
+  if (covers.length === 0 && envs.length === 0 && contracts.length === 0) {
+    return (
+      <Alert
+        type="warning"
+        showIcon
+        style={{ marginBottom: 16 }}
+        message="暂无门头照 / 环境照 / 签约合同，请谨慎审核"
+      />
+    );
+  }
+
+  return (
+    <div style={{ marginBottom: 16 }}>
+      <Typography.Title level={5} style={{ marginTop: 0, marginBottom: 12 }}>
+        审核材料
+      </Typography.Title>
+
+      {(covers.length > 0 || envs.length > 0) && (
+        <div style={{ marginBottom: 16 }}>
+          <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 8 }}>
+            门头照 / 环境照（点击可放大浏览）
+          </Typography.Text>
+          <Image.PreviewGroup>
+            <Space wrap size={12}>
+              {gallery.map((item) => (
+                <div key={item.id} style={{ textAlign: 'center' }}>
+                  <Image
+                    src={item.url}
+                    width={112}
+                    height={84}
+                    style={{ objectFit: 'cover', borderRadius: 6, border: '1px solid #f0f0f0' }}
+                  />
+                  <div style={{ fontSize: 12, color: '#8c8c8c', marginTop: 4 }}>
+                    {covers.some((c) => c.id === item.id) ? '门头照' : '环境照'}
+                  </div>
+                </div>
+              ))}
+            </Space>
+          </Image.PreviewGroup>
+        </div>
+      )}
+
+      {contracts.length > 0 && (
+        <div>
+          <Typography.Text type="secondary" style={{ display: 'block', marginBottom: 8 }}>
+            签约合同
+          </Typography.Text>
+          <Space direction="vertical" size={12} style={{ width: '100%' }}>
+            {contracts.map((item, index) => {
+              const imageLike = isImageMedia(item.url, item.mediaType);
+              const pdf = isPdfUrl(item.url);
+              return (
+                <div
+                  key={item.id || `${item.url}-${index}`}
+                  style={{
+                    display: 'flex',
+                    gap: 12,
+                    alignItems: 'center',
+                    padding: 12,
+                    border: '1px solid #f0f0f0',
+                    borderRadius: 8,
+                    background: '#fafafa',
+                  }}
+                >
+                  {imageLike ? (
+                    <Image.PreviewGroup>
+                      <Image
+                        src={item.url}
+                        width={96}
+                        height={72}
+                        style={{ objectFit: 'cover', borderRadius: 6 }}
+                      />
+                    </Image.PreviewGroup>
+                  ) : (
+                    <div
+                      style={{
+                        width: 96,
+                        height: 72,
+                        borderRadius: 6,
+                        background: '#fff',
+                        border: '1px dashed #d9d9d9',
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                        color: '#cf1322',
+                      }}
+                    >
+                      <FilePdfOutlined style={{ fontSize: 28 }} />
+                    </div>
+                  )}
+                  <Space direction="vertical" size={4} style={{ flex: 1, minWidth: 0 }}>
+                    <Typography.Text strong>
+                      {RESOURCE_BIZ_TYPE_LABELS.CONTRACT || '合同'}
+                      {contracts.length > 1 ? ` ${index + 1}` : ''}
+                    </Typography.Text>
+                    <Typography.Text type="secondary" ellipsis style={{ maxWidth: '100%' }}>
+                      {item.url}
+                    </Typography.Text>
+                    <Space wrap>
+                      {imageLike ? (
+                        <Typography.Text type="secondary">点击缩略图放大查看</Typography.Text>
+                      ) : null}
+                      {pdf ? (
+                        <Button type="link" size="small" style={{ padding: 0 }} onClick={() => setPdfUrl(item.url)}>
+                          页内预览 PDF
+                        </Button>
+                      ) : null}
+                      <Button
+                        type="link"
+                        size="small"
+                        icon={<LinkOutlined />}
+                        style={{ padding: 0 }}
+                        href={item.url}
+                        target="_blank"
+                        rel="noreferrer"
+                      >
+                        新窗口打开
+                      </Button>
+                    </Space>
+                  </Space>
+                </div>
+              );
+            })}
+          </Space>
+        </div>
+      )}
+
+      <Modal
+        title="合同预览"
+        open={!!pdfUrl}
+        onCancel={() => setPdfUrl(null)}
+        width={900}
+        footer={[
+          <Button key="open" href={pdfUrl || undefined} target="_blank" rel="noreferrer">
+            新窗口打开
+          </Button>,
+          <Button key="close" type="primary" onClick={() => setPdfUrl(null)}>
+            关闭
+          </Button>,
+        ]}
+        destroyOnClose
+      >
+        {pdfUrl ? (
+          <iframe
+            title="合同 PDF 预览"
+            src={pdfUrl}
+            style={{ width: '100%', height: '70vh', border: 'none', borderRadius: 8 }}
+          />
+        ) : null}
+      </Modal>
+    </div>
+  );
+}
+
 type StoreRow = {
   id: string;
   name: string;
@@ -307,7 +517,7 @@ export default function StoresPage() {
       </Form>
       <Table rowKey="id" className="admin-table-nowrap" loading={loading} columns={columns} dataSource={data?.items ?? []} scroll={{ x: 1200 }}
         pagination={{ current: page, pageSize, total: data?.total ?? 0, showSizeChanger: true, onChange: (p, ps) => { setPage(p); setPageSize(ps); } }} />
-      <Drawer title="门店详情" width={600} open={drawerOpen} onClose={() => setDrawerOpen(false)}
+      <Drawer title="门店详情" width={760} open={drawerOpen} onClose={() => setDrawerOpen(false)}
         extra={detail && (
           <Space wrap>
             {String(detail.auditStatus || '') === 'PENDING' || String(detail.auditStatus || '') === 'REJECTED' ? (
@@ -367,6 +577,7 @@ export default function StoresPage() {
         )}>
         {detail && (
           <>
+            <StoreAuditMediaSection detail={detail} />
             <Descriptions column={1} bordered size="small" style={{ marginBottom: 16 }}>
               <Descriptions.Item label="ID">{String(detail.id)}</Descriptions.Item>
               <Descriptions.Item label="审核状态">
@@ -390,11 +601,6 @@ export default function StoresPage() {
                   查看商户日志
                 </Button>
               </Descriptions.Item>
-              {detail.coverUrl ? (
-                <Descriptions.Item label="封面">
-                  <Image src={String(detail.coverUrl)} width={120} />
-                </Descriptions.Item>
-              ) : null}
               {Array.isArray(detail.audits) && (detail.audits as Array<Record<string, unknown>>).length > 0 ? (
                 <Descriptions.Item label="审核记录">
                   <Space direction="vertical" size={4} style={{ width: '100%' }}>

apps/h5-partner/src/lib/storeDraft.ts

@@ -8,6 +8,10 @@ export type StoreDraftForm = {
   phone: string;
   storeSmsCode: string;
   address: string;
+  openTime: string;
+  closeTime: string;
+  categoryParentId: string;
+  categoryId: string;
   intro: string;
   coverUrl: string;
   envPhotoUrls: string[];
@@ -37,6 +41,10 @@ export const defaultStoreForm = (): StoreDraftForm => ({
   phone: '',
   storeSmsCode: '',
   address: '',
+  openTime: '10:00',
+  closeTime: '22:00',
+  categoryParentId: '',
+  categoryId: '',
   intro: '',
   coverUrl: '',
   envPhotoUrls: ['', '', ''],
@@ -68,6 +76,10 @@ function normalizeForm(raw: Record<string, unknown>): StoreDraftForm {
     phone: String(raw.phone ?? base.phone),
     storeSmsCode: String(raw.storeSmsCode ?? base.storeSmsCode),
     address: String(raw.address ?? base.address),
+    openTime: String(raw.openTime ?? base.openTime),
+    closeTime: String(raw.closeTime ?? base.closeTime),
+    categoryParentId: String(raw.categoryParentId ?? base.categoryParentId),
+    categoryId: String(raw.categoryId ?? base.categoryId),
     intro: String(raw.intro ?? base.intro),
     coverUrl: String(raw.coverUrl ?? base.coverUrl),
     envPhotoUrls: normalizeStringArray(raw.envPhotoUrls, 3),
@@ -119,14 +131,38 @@ export function clearAllStoreDrafts(accountId?: string) {
 
 const PHONE_RE = /^1\d{10}$/;
 const BANK_RE = /^\d{16,19}$/;
+const TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
+
+function timeToMinutes(value: string): number {
+  const [h, m] = value.split(':').map(Number);
+  return h * 60 + m;
+}
 
 export function validateStoreStep1(
-  form: Pick<StoreDraftForm, 'regionCodes' | 'cityId' | 'name' | 'address' | 'intro'>,
+  form: Pick<
+    StoreDraftForm,
+    | 'regionCodes'
+    | 'cityId'
+    | 'name'
+    | 'address'
+    | 'openTime'
+    | 'closeTime'
+    | 'categoryId'
+    | 'intro'
+  >,
 ): string | null {
   if (!form.regionCodes || form.regionCodes.length < 3) return '请选择省 / 市 / 区县';
   if (!form.cityId) return '所选地区未匹配到开城城市，请联系总部配置开城区划';
   if (!form.name.trim()) return '请填写门店名称';
   if (!form.address.trim()) return '请填写详细地址';
+  if (!form.openTime.trim()) return '请填写营业开始时间';
+  if (!TIME_RE.test(form.openTime.trim())) return '营业开始时间格式须为 HH:MM';
+  if (!form.closeTime.trim()) return '请填写营业结束时间';
+  if (!TIME_RE.test(form.closeTime.trim())) return '营业结束时间格式须为 HH:MM';
+  if (timeToMinutes(form.openTime.trim()) >= timeToMinutes(form.closeTime.trim())) {
+    return '营业结束时间须晚于开始时间';
+  }
+  if (!form.categoryId.trim()) return '请选择店铺类型';
   if (form.intro.trim()) {
     const len = form.intro.trim().length;
     if (len < 10 || len > 500) return '门店简介须为 10~500 字';

apps/h5-partner/src/pages/StoreCreatePage.tsx

@@ -45,14 +45,15 @@ import {
 
 const STEPS = ['基本信息', '照片上传', '结算资质'] as const;
 
-
+type StoreCategoryNode = {
+  id: string;
+  name: string;
+  children?: StoreCategoryNode[];
+};
 
 type FieldErrors = {
-
   phone?: string;
-
   storeSmsCode?: string;
-
 };
 
 
@@ -101,6 +102,8 @@ export default function StoreCreatePage() {
 
   const [smsHint, setSmsHint] = useState('');
 
+  const [categoryTree, setCategoryTree] = useState<StoreCategoryNode[]>([]);
+
   const draftSaveDisabledRef = useRef(false);
 
   function reportFormError(message: string) {
@@ -151,6 +154,26 @@ export default function StoreCreatePage() {
 
   }, []);
 
+  useEffect(() => {
+    void request<StoreCategoryNode[]>('PARTNER_H5', '/partner/store-categories')
+      .then((list) => {
+        const tree = Array.isArray(list) ? list : [];
+        setCategoryTree(tree);
+        if (form.categoryId && !form.categoryParentId) {
+          const parent = tree.find((root) =>
+            (root.children ?? []).some((child) => child.id === form.categoryId),
+          );
+          if (parent) patchForm({ categoryParentId: parent.id });
+        }
+      })
+      .catch(() => setCategoryTree([]));
+  }, []);
+
+  const categoryChildren = useMemo(() => {
+    const parent = categoryTree.find((item) => item.id === form.categoryParentId);
+    return Array.isArray(parent?.children) ? parent!.children! : [];
+  }, [categoryTree, form.categoryParentId]);
+
 
 
   useEffect(() => {
@@ -487,6 +510,12 @@ export default function StoreCreatePage() {
 
           address: form.address.trim(),
 
+          openTime: form.openTime.trim(),
+
+          closeTime: form.closeTime.trim(),
+
+          categoryId: form.categoryId.trim(),
+
           intro: form.intro.trim() || undefined,
 
           coverUrl: form.coverUrl.trim() || undefined,
@@ -649,6 +678,62 @@ export default function StoreCreatePage() {
 
             </div>
 
+            <div className="partner-field">
+
+              <label>店铺类型 <span className="text-primary">*</span></label>
+
+              <div className="partner-input-row" style={{ gap: 8 }}>
+
+                <select
+
+                  className="partner-field-input partner-field-input--block"
+
+                  value={form.categoryParentId}
+
+                  onChange={(e) => patchForm({ categoryParentId: e.target.value, categoryId: '' })}
+
+                  aria-label="一级店铺类型"
+
+                >
+
+                  <option value="">选择大类</option>
+
+                  {categoryTree.map((item) => (
+
+                    <option key={item.id} value={item.id}>{item.name}</option>
+
+                  ))}
+
+                </select>
+
+                <select
+
+                  className="partner-field-input partner-field-input--block"
+
+                  value={form.categoryId}
+
+                  onChange={(e) => patchForm({ categoryId: e.target.value })}
+
+                  disabled={!form.categoryParentId}
+
+                  aria-label="二级店铺类型"
+
+                >
+
+                  <option value="">{form.categoryParentId ? '选择细类' : '请先选大类'}</option>
+
+                  {categoryChildren.map((item) => (
+
+                    <option key={item.id} value={item.id}>{item.name}</option>
+
+                  ))}
+
+                </select>
+
+              </div>
+
+            </div>
+
             <div className="partner-field">
 
               <label>详细地址 <span className="text-primary">*</span></label>
@@ -657,6 +742,52 @@ export default function StoreCreatePage() {
 
             </div>
 
+            <div className="partner-field">
+
+              <label>营业时间 <span className="text-primary">*</span></label>
+
+              <div className="partner-input-row" style={{ alignItems: 'center', gap: 8 }}>
+
+                <input
+
+                  className="partner-field-input partner-field-input--block"
+
+                  type="time"
+
+                  value={form.openTime}
+
+                  onChange={(e) => patchForm({ openTime: e.target.value })}
+
+                  aria-label="营业开始时间"
+
+                />
+
+                <span className="label-md text-muted">至</span>
+
+                <input
+
+                  className="partner-field-input partner-field-input--block"
+
+                  type="time"
+
+                  value={form.closeTime}
+
+                  onChange={(e) => patchForm({ closeTime: e.target.value })}
+
+                  aria-label="营业结束时间"
+
+                />
+
+              </div>
+
+              <p className="label-md text-muted" style={{ marginTop: 8 }}>
+
+                将展示给用户端与门店端，默认 10:00–22:00，可按实际调整。
+
+              </p>
+
+            </div>
+
             <div className="partner-field">
 
               <label>门店简介</label>

apps/h5-partner/src/pages/StoreDetailPage.tsx

@@ -47,6 +47,7 @@ export default function StoreDetailPage() {
   const [saving, setSaving] = useState(false);
   const [mediaSaving, setMediaSaving] = useState(false);
   const [actionError, setActionError] = useState('');
+  const [closeConfirmOpen, setCloseConfirmOpen] = useState(false);
 
   function applyStore(data: Record<string, unknown>) {
     setStore(data);
@@ -92,8 +93,8 @@ export default function StoreDetailPage() {
       return;
     }
     if (next === 'CLOSED') {
-      const ok = window.confirm('关闭后不可恢复营业，确认关闭该门店？');
+      setCloseConfirmOpen(true);
-      if (!ok) return;
+      return;
     }
     setStatusSaving(true);
     setActionError('');
@@ -104,7 +105,27 @@ export default function StoreDetailPage() {
       });
       setStatus(next);
       setStore((prev) => (prev ? { ...prev, ...updated, status: next } : prev));
-      toastSuccess('状态已更新');
+      toastSuccess(next === 'OPEN' ? '开店成功' : '状态已更新');
+    } catch (e) {
+      setActionError(e instanceof Error ? e.message : '状态更新失败');
+    } finally {
+      setStatusSaving(false);
+    }
+  }
+
+  async function confirmCloseStore() {
+    if (!id || statusSaving) return;
+    setCloseConfirmOpen(false);
+    setStatusSaving(true);
+    setActionError('');
+    try {
+      const updated = await request<Record<string, unknown>>('PARTNER_H5', `/partner/stores/${id}/status`, {
+        method: 'PUT',
+        body: JSON.stringify({ status: 'CLOSED' }),
+      });
+      setStatus('CLOSED');
+      setStore((prev) => (prev ? { ...prev, ...updated, status: 'CLOSED' } : prev));
+      toastSuccess('门店已关闭');
     } catch (e) {
       setActionError(e instanceof Error ? e.message : '状态更新失败');
     } finally {
@@ -385,6 +406,25 @@ export default function StoreDetailPage() {
         </button>
         )}
       </footer>
+
+      {closeConfirmOpen && (
+        <div className="partner-ship-modal-backdrop" role="presentation" onClick={() => setCloseConfirmOpen(false)}>
+          <div className="partner-ship-modal" role="dialog" aria-modal="true" onClick={(e) => e.stopPropagation()}>
+            <h3 className="headline-md" style={{ marginBottom: 8 }}>确认关闭门店？</h3>
+            <p className="body-md text-muted" style={{ lineHeight: 1.5 }}>
+              关闭后不可恢复营业，确认关闭该门店？
+            </p>
+            <div className="partner-ship-actions">
+              <button type="button" className="partner-btn-secondary" onClick={() => setCloseConfirmOpen(false)}>
+                取消
+              </button>
+              <button type="button" className="partner-btn-primary" onClick={() => void confirmCloseStore()}>
+                确认关闭
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
     </div>
   );
 }

apps/h5-partner/src/pages/StoreListPage.tsx

@@ -2,6 +2,7 @@ import { useCallback, useEffect, useMemo, useState } from 'react';
 import { Link, useNavigate, useSearchParams } from 'react-router-dom';
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
 import { isLoggedIn, request } from '../lib/api';
+import { toastSuccess } from '../lib/toast';
 import { usePartnerSession } from '../contexts/PartnerSessionContext';
 import { canCreatePartnerStore, canManagePartnerStore } from '../lib/partnerAccess';
 import {
@@ -36,6 +37,7 @@ export default function StoreListPage() {
   const [filter, setFilter] = useState<StatusFilter>(initialFilter);
   const [updatingId, setUpdatingId] = useState<string | null>(null);
   const [error, setError] = useState('');
+  const [closeTarget, setCloseTarget] = useState<string | null>(null);
 
   const loadStores = useCallback(() => {
     return request<Array<Record<string, unknown>>>('PARTNER_H5', '/partner/stores').then(setStores);
@@ -67,8 +69,8 @@ export default function StoreListPage() {
       return;
     }
     if (next === 'CLOSED') {
-      const ok = window.confirm('关闭后不可恢复营业，确认关闭该门店？');
+      setCloseTarget(storeId);
-      if (!ok) return;
+      return;
     }
     setUpdatingId(storeId);
     setError('');
@@ -78,6 +80,26 @@ export default function StoreListPage() {
         body: JSON.stringify({ status: next }),
       });
       await loadStores();
+      if (next === 'OPEN') toastSuccess('开店成功');
+    } catch {
+      /* request 已 toast */
+    } finally {
+      setUpdatingId(null);
+    }
+  }
+
+  async function confirmCloseStore() {
+    if (!closeTarget) return;
+    const storeId = closeTarget;
+    setCloseTarget(null);
+    setUpdatingId(storeId);
+    setError('');
+    try {
+      await request('PARTNER_H5', `/partner/stores/${storeId}/status`, {
+        method: 'PUT',
+        body: JSON.stringify({ status: 'CLOSED' }),
+      });
+      await loadStores();
     } catch {
       /* request 已 toast */
     } finally {
@@ -189,6 +211,24 @@ export default function StoreListPage() {
           </div>
         );
       })}
+      {closeTarget && (
+        <div className="partner-ship-modal-backdrop" role="presentation" onClick={() => setCloseTarget(null)}>
+          <div className="partner-ship-modal" role="dialog" aria-modal="true" onClick={(e) => e.stopPropagation()}>
+            <h3 className="headline-md" style={{ marginBottom: 8 }}>确认关闭门店？</h3>
+            <p className="body-md text-muted" style={{ lineHeight: 1.5 }}>
+              关闭后不可恢复营业，确认关闭该门店？
+            </p>
+            <div className="partner-ship-actions">
+              <button type="button" className="partner-btn-secondary" onClick={() => setCloseTarget(null)}>
+                取消
+              </button>
+              <button type="button" className="partner-btn-primary" onClick={() => void confirmCloseStore()}>
+                确认关闭
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
     </PullToRefresh>
   );
 }

server/dukang-api/prisma/schema.prisma

@@ -477,12 +477,18 @@ model CommonProductDetailTemplate {
 }
 
 model CommonStoreCategory {
-  id    BigInt  @id @default(autoincrement()) @db.UnsignedBigInt
+  id       BigInt  @id @default(autoincrement()) @db.UnsignedBigInt
-  code  String  @unique @db.VarChar(32)
+  code     String  @unique @db.VarChar(32)
-  name  String  @db.VarChar(64)
+  name     String  @db.VarChar(64)
-  sort  Int     @default(0)
+  sort     Int     @default(0)
-  stores Store[]
+  parentId BigInt? @map("parent_id") @db.UnsignedBigInt
+  status   String  @default("ACTIVE") @db.VarChar(16)
+  parent   CommonStoreCategory?  @relation("StoreCategoryTree", fields: [parentId], references: [id], onDelete: Restrict)
+  children CommonStoreCategory[] @relation("StoreCategoryTree")
+  stores   Store[]
 
+  @@index([parentId, sort])
+  @@index([status])
   @@map("common_store_category")
 }
 

server/dukang-api/prisma/schema.v31.prisma

@@ -335,12 +335,18 @@ model CommonProductItem {
 }
 
 model CommonStoreCategory {
-  id    BigInt  @id @default(autoincrement()) @db.UnsignedBigInt
+  id       BigInt  @id @default(autoincrement()) @db.UnsignedBigInt
-  code  String  @unique @db.VarChar(32)
+  code     String  @unique @db.VarChar(32)
-  name  String  @db.VarChar(64)
+  name     String  @db.VarChar(64)
-  sort  Int     @default(0)
+  sort     Int     @default(0)
-  stores Store[]
+  parentId BigInt? @map("parent_id") @db.UnsignedBigInt
+  status   String  @default("ACTIVE") @db.VarChar(16)
+  parent   CommonStoreCategory?  @relation("StoreCategoryTree", fields: [parentId], references: [id], onDelete: Restrict)
+  children CommonStoreCategory[] @relation("StoreCategoryTree")
+  stores   Store[]
 
+  @@index([parentId, sort])
+  @@index([status])
   @@map("common_store_category")
 }
 

server/dukang-api/prisma/seed-v31.ts

@@ -266,13 +266,36 @@ async function main() {
 
 
 
-  const categories = await Promise.all([
+  const { DEFAULT_STORE_CATEGORY_TREE } = await import('../src/modules/store/store-category.defaults');
-
+  const categoryByCode = new Map<string, { id: bigint }>();
-    prisma.commonStoreCategory.create({ data: { code: 'HOTPOT', name: '火锅', sort: 1 } }),
+  for (const root of DEFAULT_STORE_CATEGORY_TREE) {
-
+    const parent = await prisma.commonStoreCategory.create({
-    prisma.commonStoreCategory.create({ data: { code: 'LOCAL', name: '地方菜', sort: 2 } }),
+      data: {
-
+        code: root.code,
-  ]);
+        name: root.name,
+        sort: root.sort,
+        parentId: null,
+        status: 'ACTIVE',
+      },
+    });
+    categoryByCode.set(root.code, parent);
+    for (const child of root.children) {
+      const row = await prisma.commonStoreCategory.create({
+        data: {
+          code: child.code,
+          name: child.name,
+          sort: child.sort,
+          parentId: parent.id,
+          status: 'ACTIVE',
+        },
+      });
+      categoryByCode.set(child.code, row);
+    }
+  }
+  const categories = [
+    categoryByCode.get('HOTPOT')!,
+    categoryByCode.get('LOCAL')!,
+  ];
 
 
 

server/dukang-api/src/common/hq-operation/hq-operation.constants.ts

@@ -31,6 +31,10 @@ export const HqOperationAction = {
   STORE_MEDIA_CREATE: 'STORE_MEDIA_CREATE',
   STORE_MEDIA_UPDATE: 'STORE_MEDIA_UPDATE',
   STORE_MEDIA_DELETE: 'STORE_MEDIA_DELETE',
+  STORE_CATEGORY_CREATE: 'STORE_CATEGORY_CREATE',
+  STORE_CATEGORY_UPDATE: 'STORE_CATEGORY_UPDATE',
+  STORE_CATEGORY_DELETE: 'STORE_CATEGORY_DELETE',
+  STORE_CATEGORY_ENSURE: 'STORE_CATEGORY_ENSURE',
   PRODUCT_CREATE: 'PRODUCT_CREATE',
   PRODUCT_UPDATE: 'PRODUCT_UPDATE',
   PRODUCT_DELETE: 'PRODUCT_DELETE',
@@ -94,6 +98,10 @@ export const HQ_OPERATION_ACTION_LABELS: Record<string, string> = {
   [HqOperationAction.STORE_MEDIA_CREATE]: '新增门店资源',
   [HqOperationAction.STORE_MEDIA_UPDATE]: '编辑门店资源',
   [HqOperationAction.STORE_MEDIA_DELETE]: '删除门店资源',
+  [HqOperationAction.STORE_CATEGORY_CREATE]: '新增门店分类',
+  [HqOperationAction.STORE_CATEGORY_UPDATE]: '编辑门店分类',
+  [HqOperationAction.STORE_CATEGORY_DELETE]: '删除门店分类',
+  [HqOperationAction.STORE_CATEGORY_ENSURE]: '初始化默认门店分类',
   [HqOperationAction.PRODUCT_CREATE]: '新增商品',
   [HqOperationAction.PRODUCT_UPDATE]: '编辑商品',
   [HqOperationAction.PRODUCT_DELETE]: '删除商品',

server/dukang-api/src/modules/ops/admin-store-categories.controller.ts

@@ -0,0 +1,68 @@
+import { Body, Controller, Delete, Get, Param, Post, Put, UseGuards } from '@nestjs/common';
+import { HqAuthGuard } from '../../common/guards/hq-auth.guard';
+import { HqOperation } from '../../common/hq-operation/hq-operation.decorator';
+import { HqOperationAction } from '../../common/hq-operation/hq-operation.constants';
+import { StoreCategoryService } from '../store/store-category.service';
+import {
+  CreateStoreCategoryDto,
+  UpdateStoreCategoryDto,
+} from './dto/admin-mutate.dto';
+
+@Controller('admin/store-categories')
+@UseGuards(HqAuthGuard)
+export class AdminStoreCategoriesController {
+  constructor(private readonly categories: StoreCategoryService) {}
+
+  @Get()
+  list() {
+    return this.categories.listTree({ includeDisabled: true, ensure: true });
+  }
+
+  @Get('flat')
+  listFlat() {
+    return this.categories.listFlat({ includeDisabled: true, ensure: true });
+  }
+
+  @Post('ensure-defaults')
+  @HqOperation({
+    action: HqOperationAction.STORE_CATEGORY_ENSURE,
+    refType: 'STORE_CATEGORY',
+    includeBody: false,
+  })
+  async ensureDefaults() {
+    await this.categories.ensureDefaults();
+    return this.categories.listTree({ includeDisabled: true, ensure: false });
+  }
+
+  @Post()
+  @HqOperation({
+    action: HqOperationAction.STORE_CATEGORY_CREATE,
+    refType: 'STORE_CATEGORY',
+    refIdField: 'id',
+    includeBody: true,
+  })
+  create(@Body() dto: CreateStoreCategoryDto) {
+    return this.categories.create(dto);
+  }
+
+  @Put(':id')
+  @HqOperation({
+    action: HqOperationAction.STORE_CATEGORY_UPDATE,
+    refType: 'STORE_CATEGORY',
+    refIdParam: 'id',
+    includeBody: true,
+  })
+  update(@Param('id') id: string, @Body() dto: UpdateStoreCategoryDto) {
+    return this.categories.update(BigInt(id), dto);
+  }
+
+  @Delete(':id')
+  @HqOperation({
+    action: HqOperationAction.STORE_CATEGORY_DELETE,
+    refType: 'STORE_CATEGORY',
+    refIdParam: 'id',
+  })
+  remove(@Param('id') id: string) {
+    return this.categories.remove(BigInt(id));
+  }
+}

server/dukang-api/src/modules/ops/dto/admin-mutate.dto.ts

@@ -1150,3 +1150,53 @@ export class AdminBenefitGrantDto {
   @IsString()
   remark?: string;
 }
+
+export class CreateStoreCategoryDto {
+  @IsString()
+  @IsNotEmpty()
+  code: string;
+
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @IsOptional()
+  @Type(() => Number)
+  @IsNumber()
+  sort?: number;
+
+  /** 空/不传 = 一级分类；传入一级 id = 二级分类 */
+  @IsOptional()
+  @IsString()
+  parentId?: string | null;
+
+  @IsOptional()
+  @IsIn(['ACTIVE', 'DISABLED'])
+  status?: string;
+}
+
+export class UpdateStoreCategoryDto {
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  code?: string;
+
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  name?: string;
+
+  @IsOptional()
+  @Type(() => Number)
+  @IsNumber()
+  sort?: number;
+
+  @IsOptional()
+  @ValidateIf((_, v) => v !== null && v !== undefined)
+  @IsString()
+  parentId?: string | null;
+
+  @IsOptional()
+  @IsIn(['ACTIVE', 'DISABLED'])
+  status?: string;
+}

server/dukang-api/src/modules/ops/ops.module.ts

@@ -3,6 +3,7 @@ import { CityScopeModule } from '../city-scope/city-scope.module';
 import { IamModule } from '../iam/iam.module';
 import { TradeModule } from '../trade/trade.module';
 import { FulfillmentModule } from '../fulfillment/fulfillment.module';
+import { StoreModule } from '../store/store.module';
 import { AdminDashboardController } from './admin-dashboard.controller';
 import { AdminDashboardService } from './admin-dashboard.service';
 import { AdminUsersController } from './admin-users.controller';
@@ -10,6 +11,7 @@ import { AdminUsersService } from './admin-users.service';
 import { AdminOrdersController } from './admin-orders.controller';
 import { AdminOrdersService } from './admin-orders.service';
 import { AdminStoresController, AdminStoreAccountsController, AdminStoreMediaController } from './admin-stores.controller';
+import { AdminStoreCategoriesController } from './admin-store-categories.controller';
 import { AdminStoresService } from './admin-stores.service';
 import { AdminPartnersController, AdminPartnerAccountsController } from './admin-partners.controller';
 import { AdminPartnersService } from './admin-partners.service';
@@ -59,7 +61,7 @@ import { AdminSystemConfigController } from './admin-system-config.controller';
 import { AdminFulfillmentProvidersController } from './admin-fulfillment-providers.controller';
 
 @Module({
-  imports: [CityScopeModule, IamModule, TradeModule, FulfillmentModule, BenefitModule, CommonModule, IntegrationsModule, RedeemModule],
+  imports: [CityScopeModule, IamModule, TradeModule, FulfillmentModule, BenefitModule, CommonModule, IntegrationsModule, RedeemModule, StoreModule],
   controllers: [
     AdminDashboardController,
     AdminDeployController,
@@ -68,6 +70,7 @@ import { AdminFulfillmentProvidersController } from './admin-fulfillment-provide
     AdminStoresController,
     AdminStoreAccountsController,
     AdminStoreMediaController,
+    AdminStoreCategoriesController,
     AdminPartnersController,
     AdminPartnerAccountsController,
     AdminCitiesController,

server/dukang-api/src/modules/store/store-category.defaults.ts

@@ -0,0 +1,33 @@
+/** 门店两级分类默认树（一级 + 二级） */
+export const DEFAULT_STORE_CATEGORY_TREE = [
+  {
+    code: 'DINING',
+    name: '餐饮',
+    sort: 1,
+    children: [
+      { code: 'LOCAL', name: '地方菜', sort: 1 },
+      { code: 'WESTERN', name: '西餐', sort: 2 },
+      { code: 'BBQ', name: '烧烤', sort: 3 },
+      { code: 'HOTPOT', name: '火锅', sort: 4 },
+    ],
+  },
+  {
+    code: 'LODGING',
+    name: '住宿',
+    sort: 2,
+    children: [
+      { code: 'BUDGET_HOTEL', name: '快捷酒店', sort: 1 },
+      { code: 'INN', name: '旅馆', sort: 2 },
+      { code: 'LUXURY_HOTEL', name: '豪华酒店', sort: 3 },
+    ],
+  },
+  {
+    code: 'ENTERTAINMENT',
+    name: '娱乐',
+    sort: 3,
+    children: [
+      { code: 'KTV', name: 'KTV', sort: 1 },
+      { code: 'CLUB', name: '会所', sort: 2 },
+    ],
+  },
+] as const;

server/dukang-api/src/modules/store/store-category.service.ts

@@ -0,0 +1,267 @@
+import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
+import { Prisma } from '@prisma/client';
+import { PrismaService } from '../../common/prisma/prisma.module';
+import { serializeBigInt } from '../../common/decorators/current-user.decorator';
+import { DEFAULT_STORE_CATEGORY_TREE } from './store-category.defaults';
+
+export type StoreCategoryNode = {
+  id: string;
+  code: string;
+  name: string;
+  sort: number;
+  parentId: string | null;
+  status: string;
+  children: StoreCategoryNode[];
+};
+
+@Injectable()
+export class StoreCategoryService {
+  constructor(private readonly prisma: PrismaService) {}
+
+  /**
+   * 仅补齐缺失的默认分类，绝不 update 已有行（避免改动线上历史数据）。
+   * 已存在的 HOTPOT/LOCAL 等保持原样；缺的一级/二级才 create。
+   */
+  async ensureDefaults() {
+    for (const root of DEFAULT_STORE_CATEGORY_TREE) {
+      let parent = await this.prisma.commonStoreCategory.findUnique({
+        where: { code: root.code },
+      });
+      if (!parent) {
+        parent = await this.prisma.commonStoreCategory.create({
+          data: {
+            code: root.code,
+            name: root.name,
+            sort: root.sort,
+            parentId: null,
+            status: 'ACTIVE',
+          },
+        });
+      }
+      for (const child of root.children) {
+        const existing = await this.prisma.commonStoreCategory.findUnique({
+          where: { code: child.code },
+        });
+        if (existing) continue;
+        await this.prisma.commonStoreCategory.create({
+          data: {
+            code: child.code,
+            name: child.name,
+            sort: child.sort,
+            parentId: parent.id,
+            status: 'ACTIVE',
+          },
+        });
+      }
+    }
+  }
+
+  private mapNode(
+    row: {
+      id: bigint;
+      code: string;
+      name: string;
+      sort: number;
+      parentId: bigint | null;
+      status: string;
+      children?: Array<{
+        id: bigint;
+        code: string;
+        name: string;
+        sort: number;
+        parentId: bigint | null;
+        status: string;
+      }>;
+    },
+    includeDisabledChildren: boolean,
+  ): StoreCategoryNode {
+    const children = (row.children ?? [])
+      .filter((c) => includeDisabledChildren || c.status === 'ACTIVE')
+      .sort((a, b) => a.sort - b.sort || Number(a.id - b.id))
+      .map((c) => this.mapNode(c, includeDisabledChildren));
+    return {
+      id: String(row.id),
+      code: row.code,
+      name: row.name,
+      sort: row.sort,
+      parentId: row.parentId != null ? String(row.parentId) : null,
+      status: row.status,
+      children,
+    };
+  }
+
+  async listTree(options?: { includeDisabled?: boolean; ensure?: boolean }) {
+    if (options?.ensure !== false) {
+      await this.ensureDefaults();
+    }
+    const includeDisabled = options?.includeDisabled === true;
+    const roots = await this.prisma.commonStoreCategory.findMany({
+      where: {
+        parentId: null,
+        ...(includeDisabled ? {} : { status: 'ACTIVE' }),
+      },
+      include: {
+        children: {
+          orderBy: [{ sort: 'asc' }, { id: 'asc' }],
+        },
+      },
+      orderBy: [{ sort: 'asc' }, { id: 'asc' }],
+    });
+    return serializeBigInt(roots.map((r) => this.mapNode(r, includeDisabled)));
+  }
+
+  async listFlat(options?: { includeDisabled?: boolean; ensure?: boolean }) {
+    if (options?.ensure !== false) {
+      await this.ensureDefaults();
+    }
+    const includeDisabled = options?.includeDisabled === true;
+    const rows = await this.prisma.commonStoreCategory.findMany({
+      where: includeDisabled ? undefined : { status: 'ACTIVE' },
+      orderBy: [{ parentId: 'asc' }, { sort: 'asc' }, { id: 'asc' }],
+    });
+    return serializeBigInt(
+      rows.map((row) => ({
+        id: String(row.id),
+        code: row.code,
+        name: row.name,
+        sort: row.sort,
+        parentId: row.parentId != null ? String(row.parentId) : null,
+        status: row.status,
+        level: row.parentId == null ? 1 : 2,
+      })),
+    );
+  }
+
+  async assertLeafCategoryId(categoryId: bigint) {
+    const row = await this.prisma.commonStoreCategory.findUnique({ where: { id: categoryId } });
+    if (!row || row.status !== 'ACTIVE') {
+      throw new BadRequestException('店铺类型不存在或已停用');
+    }
+    if (row.parentId == null) {
+      throw new BadRequestException('请选择二级店铺类型');
+    }
+    return row;
+  }
+
+  async create(dto: {
+    code: string;
+    name: string;
+    sort?: number;
+    parentId?: string | null;
+    status?: string;
+  }) {
+    const code = dto.code.trim().toUpperCase();
+    const name = dto.name.trim();
+    if (!code) throw new BadRequestException('请填写分类编码');
+    if (!name) throw new BadRequestException('请填写分类名称');
+    let parentId: bigint | null = null;
+    if (dto.parentId) {
+      const parent = await this.prisma.commonStoreCategory.findUnique({
+        where: { id: BigInt(dto.parentId) },
+      });
+      if (!parent || parent.parentId != null) {
+        throw new BadRequestException('父级必须是一级分类');
+      }
+      parentId = parent.id;
+    }
+    try {
+      const row = await this.prisma.commonStoreCategory.create({
+        data: {
+          code,
+          name,
+          sort: dto.sort ?? 0,
+          parentId,
+          status: dto.status === 'DISABLED' ? 'DISABLED' : 'ACTIVE',
+        },
+      });
+      return serializeBigInt(row);
+    } catch (e) {
+      if (e instanceof Prisma.PrismaClientKnownRequestError && e.code === 'P2002') {
+        throw new BadRequestException('分类编码已存在');
+      }
+      throw e;
+    }
+  }
+
+  async update(
+    id: bigint,
+    dto: {
+      code?: string;
+      name?: string;
+      sort?: number;
+      parentId?: string | null;
+      status?: string;
+    },
+  ) {
+    const existing = await this.prisma.commonStoreCategory.findUnique({ where: { id } });
+    if (!existing) throw new NotFoundException('分类不存在');
+
+    let parentId: bigint | null | undefined = undefined;
+    if (dto.parentId !== undefined) {
+      if (dto.parentId == null || dto.parentId === '') {
+        parentId = null;
+      } else {
+        if (BigInt(dto.parentId) === id) {
+          throw new BadRequestException('不能将分类设为自己的子级');
+        }
+        const parent = await this.prisma.commonStoreCategory.findUnique({
+          where: { id: BigInt(dto.parentId) },
+        });
+        if (!parent || parent.parentId != null) {
+          throw new BadRequestException('父级必须是一级分类');
+        }
+        // 一级分类若已有子级，不允许变成二级
+        if (existing.parentId == null) {
+          const childCount = await this.prisma.commonStoreCategory.count({
+            where: { parentId: id },
+          });
+          if (childCount > 0) {
+            throw new BadRequestException('该一级分类下仍有二级分类，不能改为二级');
+          }
+        }
+        parentId = parent.id;
+      }
+    }
+
+    try {
+      const row = await this.prisma.commonStoreCategory.update({
+        where: { id },
+        data: {
+          ...(dto.code !== undefined ? { code: dto.code.trim().toUpperCase() } : {}),
+          ...(dto.name !== undefined ? { name: dto.name.trim() } : {}),
+          ...(dto.sort !== undefined ? { sort: dto.sort } : {}),
+          ...(parentId !== undefined ? { parentId } : {}),
+          ...(dto.status !== undefined
+            ? { status: dto.status === 'DISABLED' ? 'DISABLED' : 'ACTIVE' }
+            : {}),
+        },
+      });
+      return serializeBigInt(row);
+    } catch (e) {
+      if (e instanceof Prisma.PrismaClientKnownRequestError && e.code === 'P2002') {
+        throw new BadRequestException('分类编码已存在');
+      }
+      throw e;
+    }
+  }
+
+  async remove(id: bigint) {
+    const existing = await this.prisma.commonStoreCategory.findUnique({ where: { id } });
+    if (!existing) throw new NotFoundException('分类不存在');
+    const childCount = await this.prisma.commonStoreCategory.count({ where: { parentId: id } });
+    if (childCount > 0) {
+      throw new BadRequestException('请先删除或停用下级分类');
+    }
+    const storeCount = await this.prisma.store.count({ where: { categoryId: id } });
+    if (storeCount > 0) {
+      // 软停用，避免破坏已有门店关联
+      const row = await this.prisma.commonStoreCategory.update({
+        where: { id },
+        data: { status: 'DISABLED' },
+      });
+      return serializeBigInt({ ...row, softDisabled: true });
+    }
+    await this.prisma.commonStoreCategory.delete({ where: { id } });
+    return { id: String(id), deleted: true };
+  }
+}

server/dukang-api/src/modules/store/store.controller.ts

@@ -1,5 +1,6 @@
 import { Body, Controller, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
 import { StoreService } from './store.service';
+import { StoreCategoryService } from './store-category.service';
 import { RedeemService } from '../redeem/redeem.service';
 import { JwtAuthGuard, AuthUser } from '../../common/guards/jwt-auth.guard';
 import { PartnerPrimaryGuard } from '../../common/guards/partner-primary.guard';
@@ -23,6 +24,17 @@ export class PublicStoreController {
   }
 }
 
+@Controller('partner/store-categories')
+@UseGuards(JwtAuthGuard)
+export class PartnerStoreCategoriesController {
+  constructor(private readonly categories: StoreCategoryService) {}
+
+  @Get()
+  list() {
+    return this.categories.listTree({ includeDisabled: false, ensure: true });
+  }
+}
+
 @Controller('partner/stores')
 @UseGuards(JwtAuthGuard)
 export class PartnerStoreController {

server/dukang-api/src/modules/store/store.module.ts

@@ -4,9 +4,11 @@ import { RedeemModule } from '../redeem/redeem.module';
 import { AnalyticsModule } from '../analytics/analytics.module';
 import { CityScopeModule } from '../city-scope/city-scope.module';
 import { StoreService } from './store.service';
+import { StoreCategoryService } from './store-category.service';
 import {
   PartnerDashboardController,
   PartnerReportController,
+  PartnerStoreCategoriesController,
   PartnerStoreController,
   PublicStoreController,
   ShopDashboardController,
@@ -17,13 +19,14 @@ import {
   imports: [IamModule, AnalyticsModule, CityScopeModule, forwardRef(() => RedeemModule)],
   controllers: [
     PublicStoreController,
+    PartnerStoreCategoriesController,
     PartnerStoreController,
     PartnerDashboardController,
     PartnerReportController,
     ShopStoreController,
     ShopDashboardController,
   ],
-  providers: [StoreService],
+  providers: [StoreService, StoreCategoryService],
-  exports: [StoreService],
+  exports: [StoreService, StoreCategoryService],
 })
 export class StoreModule {}

server/dukang-api/src/modules/store/store.service.ts

@@ -13,6 +13,7 @@ import { parseBigIntParam } from '../../common/parse-bigint';
 import { AnalyticsService } from '../analytics/analytics.service';
 import { PartnerCityService } from '../city-scope/partner-city.service';
 import { AuthService } from '../iam/auth.service';
+import { StoreCategoryService } from './store-category.service';
 
 @Injectable()
 export class StoreService {
@@ -23,6 +24,7 @@ export class StoreService {
     private readonly analyticsService: AnalyticsService,
     private readonly partnerCityService: PartnerCityService,
     private readonly authService: AuthService,
+    private readonly storeCategoryService: StoreCategoryService,
   ) {}
 
   async listOpenStores(cityCode?: string) {
@@ -172,11 +174,17 @@ export class StoreService {
     const bankAccountNo = body.bankAccountNo ? String(body.bankAccountNo) : null;
     const bankBranch = body.bankBranch ? String(body.bankBranch) : null;
 
+    if (!body.categoryId) {
+      throw new BadRequestException('请选择店铺类型');
+    }
+    const categoryId = parseBigIntParam(body.categoryId, '分类ID');
+    await this.storeCategoryService.assertLeafCategoryId(categoryId);
+
     const store = await this.prisma.store.create({
       data: {
         cityId: city.id,
         partnerAccountId: primaryId,
-        categoryId: body.categoryId ? parseBigIntParam(body.categoryId, '分类ID') : null,
+        categoryId,
         name: String(body.name),
         phone: normalizedPhone,
         province: String(body.province ?? city.province ?? '河南省'),