diff --git a/.cursor/skills/dukang-coding/reference-backend.md b/.cursor/skills/dukang-coding/reference-backend.md index 2bf3cc1..98c2006 100644 --- a/.cursor/skills/dukang-coding/reference-backend.md +++ b/.cursor/skills/dukang-coding/reference-backend.md @@ -102,7 +102,7 @@ Admin 路由在 `modules/ops/` 下，前缀 `/admin/*`。 | `/admin/users` | C 端用户 | | `/admin/orders` | 订单 | | `/admin/stores` | 门店 | -| `/admin/store-accounts` | 门店账号 | +| `/admin/store-accounts` | 门店账号（含子账号 CRUD：`/:id/staff`） | | `/admin/store-media` | 门店媒体 | | `/admin/partners` | 合伙人 | | `/admin/partner-accounts` | 合伙人账号 | diff --git a/apps/admin-web/src/App.tsx b/apps/admin-web/src/App.tsx index 8573032..204977c 100644 --- a/apps/admin-web/src/App.tsx +++ b/apps/admin-web/src/App.tsx @@ -36,6 +36,7 @@ import StoreBillsPage from './pages/StoreBillsPage'; import PartnerBillsPage from './pages/PartnerBillsPage'; import WineryBillsPage from './pages/WineryBillsPage'; import LogisticsBillsPage from './pages/LogisticsBillsPage'; +import BankAccountsPage from './pages/BankAccountsPage'; import TicketsPage from './pages/TicketsPage'; import SupportTicketsPage from './pages/SupportTicketsPage'; import InvoicesPage from './pages/InvoicesPage'; @@ -133,6 +134,7 @@ export default function App() { } /> } /> } /> + } /> } /> } /> { const data = await request(`/admin/partners/${partnerId}/assoc`); @@ -78,6 +79,26 @@ export default function PartnerAssocPanel({ partnerId }: PartnerAssocPanelProps) } } + async function downloadBareQrcode() { + if (!summary?.qrcodeUrl) { + message.warning('尚未生成关联码'); + return; + } + setDownloadingQr(true); + try { + await requestDownload( + `/admin/partners/${partnerId}/assoc/qrcode`, + {}, + `partner-assoc-${partnerId}.png`, + ); + message.success('已开始下载二维码'); + } catch (e) { + message.error(e instanceof Error ? e.message : '下载二维码失败'); + } finally { + setDownloadingQr(false); + } + } + async function unbind(userId: string) { try { await request(`/admin/partners/${partnerId}/assoc/users/${userId}/unbind`, { method: 'POST' }); @@ -137,12 +158,19 @@ export default function PartnerAssocPanel({ partnerId }: PartnerAssocPanelProps) 关联用户 {summary?.userCount ?? 0} 人 - - {canDownloadPosters ? ( - - ) : null} + + + {summary?.qrcodeUrl ? ( + + ) : null} + {canDownloadPosters ? ( + + ) : null} + (); + const [items, setItems] = useState([]); + const [loading, setLoading] = useState(false); + const [editingId, setEditingId] = useState(null); + const [modalOpen, setModalOpen] = useState(false); + const [submitting, setSubmitting] = useState(false); + + const load = useCallback(async () => { + setLoading(true); + try { + const res = await request(`/admin/stores/${storeId}/bank-accounts`); + setItems(res ?? []); + } catch (e) { + message.error(e instanceof Error ? e.message : '加载失败'); + } finally { + setLoading(false); + } + }, [storeId]); + + useEffect(() => { + void load(); + }, [load]); + + function openCreate() { + setEditingId(null); + form.resetFields(); + setModalOpen(true); + } + + function openEdit(item: StoreBankAccountDto) { + setEditingId(item.id); + form.setFieldsValue({ + bankAccountName: item.bankAccountName, + bankAccountNo: item.bankAccountNo, + bankBranch: item.bankBranch ?? '', + }); + setModalOpen(true); + } + + async function submit() { + const v = await form.validateFields(); + setSubmitting(true); + try { + const body = JSON.stringify({ + bankAccountName: v.bankAccountName.trim(), + bankAccountNo: v.bankAccountNo.replace(/\s+/g, ''), + bankBranch: v.bankBranch?.trim() || undefined, + }); + if (editingId) { + await request(`/admin/stores/${storeId}/bank-accounts/${editingId}`, { method: 'PUT', body }); + } else { + await request(`/admin/stores/${storeId}/bank-accounts`, { method: 'POST', body }); + } + message.success('已保存'); + setModalOpen(false); + void load(); + } catch (e) { + message.error(e instanceof Error ? e.message : '保存失败'); + } finally { + setSubmitting(false); + } + } + + async function setDefault(id: string) { + try { + await request(`/admin/stores/${storeId}/bank-accounts/${id}/default`, { method: 'POST' }); + message.success('已设为默认打款账户'); + void load(); + } catch (e) { + message.error(e instanceof Error ? e.message : '设置失败'); + } + } + + async function remove(id: string) { + try { + await request(`/admin/stores/${storeId}/bank-accounts/${id}`, { method: 'DELETE' }); + message.success('已删除'); + void load(); + } catch (e) { + message.error(e instanceof Error ? e.message : '删除失败'); + } + } + + const columns: ColumnsType = [ + { title: '收款人', dataIndex: 'bankAccountName', width: 140 }, + { title: '银行账号', dataIndex: 'bankAccountNo', width: 180 }, + { title: '开户行', dataIndex: 'bankBranch', render: (v) => v || '—' }, + { + title: '默认', + dataIndex: 'isDefault', + width: 80, + render: (v) => (v ? 默认 : null), + }, + { + title: '操作', + width: 220, + render: (_, row) => ( + + + {!row.isDefault ? ( + + ) : null} + {!row.isDefault ? ( + void remove(row.id)} + > + + + ) : null} + + ), + }, + ]; + + return ( +
+ + + 每门店可维护多个收款账户，标记「默认」的账户用于核销结算与提现打款；切换即时生效、无需重启服务。 + + + +
+ setModalOpen(false)} + onOk={() => void submit()} + okText="保存" + > +
+ + + + + + + + + + + + + ); +} diff --git a/apps/admin-web/src/layouts/AdminLayout.tsx b/apps/admin-web/src/layouts/AdminLayout.tsx index 68c820d..55bf212 100644 --- a/apps/admin-web/src/layouts/AdminLayout.tsx +++ b/apps/admin-web/src/layouts/AdminLayout.tsx @@ -86,6 +86,7 @@ const MENU_ITEMS: MenuProps['items'] = [ { key: '/finance/partner-bills', label: '合伙人账单' }, { key: '/finance/winery-bills', label: '酒厂账单' }, { key: '/finance/logistics-bills', label: '物流对账' }, + { key: '/finance/bank-accounts', label: '银行账户' }, ], }, { @@ -211,6 +212,7 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean { '/finance/partner-bills': 'finance', '/finance/winery-bills': 'finance', '/finance/logistics-bills': 'finance', + '/finance/bank-accounts': 'finance', 'benefit-group': 'benefit', '/benefit/coupons': 'benefit', '/benefit/ledgers': 'benefit', diff --git a/apps/admin-web/src/lib/hq-log.ts b/apps/admin-web/src/lib/hq-log.ts index 843ecd5..ba4fc94 100644 --- a/apps/admin-web/src/lib/hq-log.ts +++ b/apps/admin-web/src/lib/hq-log.ts @@ -28,6 +28,8 @@ export const HQ_OPERATION_ACTION_OPTIONS = [ { value: 'STORE_AUDIT', label: '门店审核' }, { value: 'STORE_ACCOUNT_CREATE', label: '新增门店账户' }, { value: 'STORE_ACCOUNT_UPDATE', label: '编辑门店账户' }, + { value: 'STORE_ACCOUNT_STAFF_CREATE', label: '新增门店子账号' }, + { value: 'STORE_ACCOUNT_STAFF_UPDATE', label: '编辑门店子账号' }, { value: 'STORE_ACCOUNT_STAFF_DELETE', label: '删除门店子账号' }, { value: 'STORE_CATEGORY_CREATE', label: '新增门店分类' }, { value: 'STORE_CATEGORY_UPDATE', label: '编辑门店分类' }, diff --git a/apps/admin-web/src/pages/BankAccountsPage.tsx b/apps/admin-web/src/pages/BankAccountsPage.tsx new file mode 100644 index 0000000..99f4a75 --- /dev/null +++ b/apps/admin-web/src/pages/BankAccountsPage.tsx @@ -0,0 +1,389 @@ +import { useEffect, useMemo, useState } from 'react'; +import { + Button, + Form, + Input, + Modal, + Popconfirm, + Select, + Space, + Table, + Tag, + message, +} from 'antd'; +import type { ColumnsType } from 'antd/es/table'; +import { + FINANCE_BANK_ACCOUNT_TYPE_LABELS, + FINANCE_BANK_ACCOUNT_TYPES, + type FinanceBankAccountDto, + type FinanceBankAccountType, +} from '@dukang/shared-types'; +import { request, type Paginated } from '../lib/api'; +import { ADMIN_OPTIONS_PAGE_SIZE } from '../lib/constants'; +import { downloadBase64File } from '../lib/exportExcel'; +import { useAdminList } from '../lib/useAdminList'; +import { useAdminListColumns } from '../lib/useAdminListColumns'; +import { AdminListHeader } from '../components/AdminListHeader'; + +type CityOption = { id: string; name: string }; + +type ExportResult = { + filename: string; + mimeType: string; + contentBase64: string; + count: number; +}; + +type OtherForm = { + name?: string; + bankAccountName: string; + bankAccountNo: string; + bankBranch?: string; + remark?: string; +}; + +const TYPE_COLORS: Record = { + STORE: 'blue', + WINERY: 'gold', + PARTNER: 'purple', + LOGISTICS: 'cyan', + OTHER: 'default', +}; + +function otherNumericId(id: string) { + return id.startsWith('OTHER:') ? id.slice('OTHER:'.length) : id; +} + +export default function BankAccountsPage() { + const [filterForm] = Form.useForm<{ + type?: FinanceBankAccountType; + cityId?: string; + keyword?: string; + }>(); + const [otherForm] = Form.useForm(); + const [remarkForm] = Form.useForm<{ remark?: string }>(); + const [filters, setFilters] = useState({ type: '', cityId: '', keyword: '' }); + const [cities, setCities] = useState([]); + const [otherOpen, setOtherOpen] = useState(false); + const [editing, setEditing] = useState(null); + const [remarkTarget, setRemarkTarget] = useState(null); + const [saving, setSaving] = useState(false); + const [exporting, setExporting] = useState<'xlsx' | 'pdf' | null>(null); + + useEffect(() => { + void request>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`) + .then((res) => setCities(res.items ?? [])) + .catch(() => setCities([])); + }, []); + + const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList( + '/admin/finance/bank-accounts', + () => { + const qs = new URLSearchParams(); + if (filters.type) qs.set('type', filters.type); + if (filters.cityId) qs.set('cityId', filters.cityId); + if (filters.keyword) qs.set('keyword', filters.keyword); + return qs; + }, + [filters.type, filters.cityId, filters.keyword], + ); + + function openCreate() { + setEditing(null); + otherForm.resetFields(); + setOtherOpen(true); + } + + function openEdit(row: FinanceBankAccountDto) { + setEditing(row); + otherForm.setFieldsValue({ + name: row.ownerName === row.bankAccountName ? undefined : row.ownerName, + bankAccountName: row.bankAccountName, + bankAccountNo: row.bankAccountNo, + bankBranch: row.bankBranch ?? undefined, + remark: row.remark ?? undefined, + }); + setOtherOpen(true); + } + + function openRemark(row: FinanceBankAccountDto) { + setRemarkTarget(row); + remarkForm.setFieldsValue({ remark: row.remark ?? undefined }); + } + + async function saveOther() { + const values = await otherForm.validateFields(); + setSaving(true); + try { + if (editing) { + await request(`/admin/finance/bank-accounts/other/${otherNumericId(editing.id)}`, { + method: 'PUT', + body: JSON.stringify(values), + }); + message.success('已保存'); + } else { + await request('/admin/finance/bank-accounts', { + method: 'POST', + body: JSON.stringify(values), + }); + message.success('已新增'); + } + setOtherOpen(false); + await reload(); + } catch (e) { + message.error(e instanceof Error ? e.message : '保存失败'); + } finally { + setSaving(false); + } + } + + async function saveRemark() { + if (!remarkTarget) return; + const values = await remarkForm.validateFields(); + setSaving(true); + try { + await request(`/admin/finance/bank-accounts/${encodeURIComponent(remarkTarget.id)}/remark`, { + method: 'PUT', + body: JSON.stringify({ remark: values.remark ?? '' }), + }); + message.success('备注已保存'); + setRemarkTarget(null); + await reload(); + } catch (e) { + message.error(e instanceof Error ? e.message : '保存失败'); + } finally { + setSaving(false); + } + } + + async function removeOther(row: FinanceBankAccountDto) { + try { + await request(`/admin/finance/bank-accounts/other/${otherNumericId(row.id)}`, { method: 'DELETE' }); + message.success('已删除'); + await reload(); + } catch (e) { + message.error(e instanceof Error ? e.message : '删除失败'); + } + } + + async function exportFile(format: 'xlsx' | 'pdf') { + setExporting(format); + try { + const qs = new URLSearchParams(); + qs.set('format', format); + if (filters.type) qs.set('type', filters.type); + if (filters.cityId) qs.set('cityId', filters.cityId); + if (filters.keyword) qs.set('keyword', filters.keyword); + const result = await request(`/admin/finance/bank-accounts/export?${qs}`); + downloadBase64File(result.contentBase64, result.filename, result.mimeType); + message.success(`已导出 ${result.count} 条`); + } catch (e) { + message.error(e instanceof Error ? e.message : '导出失败'); + } finally { + setExporting(null); + } + } + + const typeOptions = useMemo( + () => FINANCE_BANK_ACCOUNT_TYPES.map((value) => ({ value, label: FINANCE_BANK_ACCOUNT_TYPE_LABELS[value] })), + [], + ); + + const baseColumns: ColumnsType = [ + { + title: '类型', + dataIndex: 'type', + width: 88, + render: (type: FinanceBankAccountType) => ( + {FINANCE_BANK_ACCOUNT_TYPE_LABELS[type]} + ), + }, + { title: '归属', dataIndex: 'ownerName', width: 180 }, + { title: '城市', dataIndex: 'cityName', width: 100, render: (v?: string | null) => v || '—' }, + { title: '户名', dataIndex: 'bankAccountName', width: 140 }, + { title: '银行账号', dataIndex: 'bankAccountNo', width: 180 }, + { title: '开户行', dataIndex: 'bankBranch', width: 180, render: (v?: string | null) => v || '—' }, + { + title: '默认', + dataIndex: 'isDefault', + width: 72, + render: (v: boolean | undefined, row) => (row.type === 'STORE' ? (v ? '是' : '否') : '—'), + }, + { title: '备注', dataIndex: 'remark', width: 200, render: (v?: string | null) => v || '—' }, + { + title: '操作', + key: 'actions', + width: 160, + fixed: 'right', + render: (_, row) => ( + + + {row.editable ? ( + <> + + void removeOther(row)} + > + + + + ) : null} + + ), + }, + ]; + + const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-bank-accounts', baseColumns, { + page, + pageSize, + }); + + return ( +
+ {settingsModal} + + 新增账户 + + } + /> + +
{ + setFilters({ + type: v.type || '', + cityId: v.cityId || '', + keyword: v.keyword?.trim() || '', + }); + setPage(1); + }} + > + + ({ value: c.id, label: c.name }))} + /> + + + + + + + + + + + + + + + + + + +
{ + setPage(p); + setPageSize(ps); + }, + }} + /> + + setOtherOpen(false)} + onOk={() => void saveOther()} + confirmLoading={saving} + destroyOnClose + > +
+ + + + + + + + + + + + + + + + + + + setRemarkTarget(null)} + onOk={() => void saveRemark()} + confirmLoading={saving} + destroyOnClose + > +
+ + + + + + + ); +} diff --git a/apps/admin-web/src/pages/HqPermissionsPage.tsx b/apps/admin-web/src/pages/HqPermissionsPage.tsx index 4b03d93..b4d087e 100644 --- a/apps/admin-web/src/pages/HqPermissionsPage.tsx +++ b/apps/admin-web/src/pages/HqPermissionsPage.tsx @@ -246,7 +246,7 @@ export default function HqPermissionsPage() { 按角色配置基础权限；按用户可追加或撤销。最终生效权限 =（角色权限 ∪ 追加）− 撤销。 超级管理员默认拥有除「危险操作」外的全部权限；删除用户/订单/城市、修改用户关联合伙人需在「按用户分配」或「按角色分配」中单独勾选（默认均无）。 运营/财务默认可删除门店分类；城市门店服务可新增分类，不可删除。 - 「系统设置」已拆分为各配置分组；「财务」对应门店/合伙人/酒厂账单。 + 「系统设置」已拆分为各配置分组；「财务」对应门店/合伙人/酒厂账单、物流对账与银行账户。 ; + staff?: AdminStoreStaffItem[]; }; type StoreOption = { id: string; name: string }; +const STAFF_ROLE_OPTIONS = Object.entries(STORE_STAFF_ROLE_LABELS).map(([value, label]) => ({ value, label })); +const STAFF_PERMISSION_OPTIONS = STORE_STAFF_DEFAULT_PERMISSIONS.map((value) => ({ + value, + label: STORE_STAFF_PERMISSION_LABELS[value], +})); + export default function StoreAccountsPage() { const [form] = Form.useForm(); const [createForm] = Form.useForm(); + const [staffForm] = Form.useForm(); + const [staffEditForm] = Form.useForm(); const [filters, setFilters] = useState>({}); const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList( '/admin/store-accounts', @@ -50,9 +64,14 @@ export default function StoreAccountsPage() { const [detail, setDetail] = useState(null); const [drawerOpen, setDrawerOpen] = useState(false); const [createOpen, setCreateOpen] = useState(false); + const [staffOpen, setStaffOpen] = useState(false); + const [staffEditOpen, setStaffEditOpen] = useState(false); + const [editingStaffId, setEditingStaffId] = useState(null); const [stores, setStores] = useState([]); const [deletingStaffId, setDeletingStaffId] = useState(null); + const parentStoreOptions = (detail?.stores ?? []).map((s) => ({ value: s.id, label: s.name })); + async function loadStores() { const res = await request>(`/admin/stores?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`); setStores(res.items); @@ -64,6 +83,34 @@ export default function StoreAccountsPage() { void reload(); } + function openAddStaff() { + if (!detail) return; + if (!detail.stores?.length) { + message.warning('请先为该主账号绑定门店'); + return; + } + staffForm.resetFields(); + staffForm.setFieldsValue({ + staffRole: StoreStaffRole.CASHIER, + permissions: [...STORE_STAFF_DEFAULT_PERMISSIONS], + storeIds: detail.stores.map((s) => s.id), + }); + setStaffOpen(true); + } + + function openEditStaff(staff: AdminStoreStaffItem) { + setEditingStaffId(staff.id); + staffEditForm.setFieldsValue({ + name: staff.name, + phone: staff.phone, + staffRole: staff.staffRole ?? StoreStaffRole.CASHIER, + status: staff.status, + permissions: staff.permissions?.length ? staff.permissions : [...STORE_STAFF_DEFAULT_PERMISSIONS], + storeIds: staff.storeIds?.length ? staff.storeIds : (staff.stores ?? []).map((s) => s.id), + }); + setStaffEditOpen(true); + } + async function deleteStaff(staffId: string) { if (!detail) return; setDeletingStaffId(staffId); @@ -151,13 +198,58 @@ export default function StoreAccountsPage() { const { columns, settingsButton, settingsModal } = useAdminListColumns('store-accounts', baseColumns, { page, pageSize }); + const staffColumns: ColumnsType = [ + { title: '姓名', dataIndex: 'name', width: 90 }, + { title: '手机', dataIndex: 'phone', width: 120 }, + { + title: '角色', + dataIndex: 'staffRole', + width: 80, + render: (role) => STORE_STAFF_ROLE_LABELS[role as StoreStaffRole] || role || '—', + }, + { + title: '门店', + render: (_, staff) => + staff.stores?.length ? staff.stores.map((s) => s.name).join('、') : '—', + }, + { + title: '状态', + dataIndex: 'status', + width: 70, + render: (s) => {ACCOUNT_STATUS_LABELS[s] || s}, + }, + { + title: '操作', + width: 120, + render: (_, staff) => ( + + + void deleteStaff(staff.id)} + > + + + + ), + }, + ]; + return (
{settingsModal} setDrawerOpen(false)} extra={ detail && (
{ACCOUNT_STATUS_LABELS[s] || s}, - }, - { - title: '操作', - width: 80, - render: (_, staff) => ( - void deleteStaff(staff.id)} - > - - - ), - }, - ]} - /> - - ) : ( - - 暂无子账号 - - )} +
+ + 子账号（{detail.staff?.length ?? 0}）· 仅主账号可添加，不可多级 + + +
+
)} @@ -321,6 +387,87 @@ export default function StoreAccountsPage() { + setStaffOpen(false)} + onOk={async () => { + if (!detail) return; + const v = await staffForm.validateFields(); + await request(`/admin/store-accounts/${detail.id}/staff`, { + method: 'POST', + body: JSON.stringify(v), + }); + message.success('子账号已创建'); + setStaffOpen(false); + await refreshDetail(detail.id); + }} + > +
+ + + + + + + + + + + + + setStaffEditOpen(false)} + onOk={async () => { + if (!detail || !editingStaffId) return; + const v = await staffEditForm.validateFields(); + await request(`/admin/store-accounts/${detail.id}/staff/${editingStaffId}`, { + method: 'PUT', + body: JSON.stringify(v), + }); + message.success('子账号已更新'); + setStaffEditOpen(false); + await refreshDetail(detail.id); + }} + > +
+ + + + + + ({ value, label }))} /> + + + setForm({ ...form, bankAccountName: e.target.value })} + /> + {fieldErrors.bankAccountName ? ( +

{fieldErrors.bankAccountName}

+ ) : null} + + + setForm({ ...form, bankAccountNo: e.target.value.replace(/[^\d]/g, '') })} + /> + {fieldErrors.bankAccountNo ? ( +

{fieldErrors.bankAccountNo}

+ ) : null} + + + setForm({ ...form, bankBranch: e.target.value })} + /> + +
+ + {editing ? ( + + ) : null} +
+ + + ) : ( +

仅主账号可维护收款账户

+ )} + + {msg ?

{msg}

: null} + + + ); +} diff --git a/apps/h5-shop/src/pages/MinePage.tsx b/apps/h5-shop/src/pages/MinePage.tsx index 471cf12..304c8a9 100644 --- a/apps/h5-shop/src/pages/MinePage.tsx +++ b/apps/h5-shop/src/pages/MinePage.tsx @@ -153,6 +153,12 @@ export default function MinePage() { account_balance_wallet 结算提现 + {profile?.isPrimary ? ( + + ) : null} {profile?.isPrimary ? (