yoone
/
WEB
1
0
Fork 3
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: 移除代码中的中文注释标记

This commit is contained in:
tikkhun 2025-11-24 10:32:31 +08:00
parent 1d0cddf901
commit 3614efef1e
3 changed files with 28 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/pages/Site/List/index.tsx
View File

@ -4,7 +4,7 @@ import { DrawerForm, ProFormText, ProFormSelect, ProFormSwitch } from '@ant-desi
import { Button, message, Popconfirm, Space, Tag } from 'antd'; import { Button, message, Popconfirm, Space, Tag } from 'antd';
import { request } from '@umijs/max'; import { request } from '@umijs/max';
// 中文注释：站点数据项类型（前端不包含密钥字段，后端列表不返回密钥） // 站点数据项类型（前端不包含密钥字段，后端列表不返回密钥）
interface SiteItem { interface SiteItem {
id: number; id: number;
siteName: string; siteName: string;
@ -14,14 +14,14 @@ interface SiteItem {
isDisabled: number; isDisabled: number;
} }
// 中文注释：创建/更新表单的值类型，包含可选的密钥字段 // 创建/更新表单的值类型，包含可选的密钥字段
interface SiteFormValues { interface SiteFormValues {
siteName: string; siteName: string;
apiUrl?: string; apiUrl?: string;
type?: 'woocommerce' | 'shopyy'; type?: 'woocommerce' | 'shopyy';
isDisabled?: boolean; isDisabled?: boolean;
consumerKey?: string; // 中文注释：WooCommerce REST API 的 consumer key consumerKey?: string; // WooCommerce REST API 的 consumer key
consumerSecret?: string; // 中文注释：WooCommerce REST API 的 consumer secret consumerSecret?: string; // WooCommerce REST API 的 consumer secret
skuPrefix?: string; skuPrefix?: string;
} }
@ -56,7 +56,7 @@ const SiteList: React.FC = () => {
} }
}, [open, editing]); }, [open, editing]);
// 中文注释：表格列定义 // 表格列定义
const columns: ProColumns<SiteItem>[] = [ const columns: ProColumns<SiteItem>[] = [
{ title: 'ID', dataIndex: 'id', width: 80, sorter: true, hideInSearch: true }, { title: 'ID', dataIndex: 'id', width: 80, sorter: true, hideInSearch: true },
{ title: '站点名称', dataIndex: 'siteName', width: 220 }, { title: '站点名称', dataIndex: 'siteName', width: 220 },
@ -124,7 +124,7 @@ const SiteList: React.FC = () => {
}, },
]; ];
// 中文注释：表格数据请求 // 表格数据请求
const tableRequest = async (params: Record<string, any>) => { const tableRequest = async (params: Record<string, any>) => {
try { try {
const { current = 1, pageSize = 10, siteName, type } = params; const { current = 1, pageSize = 10, siteName, type } = params;
@ -150,19 +150,19 @@ const SiteList: React.FC = () => {
} }
}; };
// 中文注释：提交创建/更新逻辑；编辑时未填写密钥则不提交（保持原值） // 提交创建/更新逻辑；编辑时未填写密钥则不提交（保持原值）
const handleSubmit = async (values: SiteFormValues) => { const handleSubmit = async (values: SiteFormValues) => {
try { try {
if (editing) { if (editing) {
const payload: Record<string, any> = { const payload: Record<string, any> = {
// 中文注释：仅提交存在的字段，避免覆盖为 null/空 // 仅提交存在的字段，避免覆盖为 null/空
...(values.siteName ? { siteName: values.siteName } : {}), ...(values.siteName ? { siteName: values.siteName } : {}),
...(values.apiUrl ? { apiUrl: values.apiUrl } : {}), ...(values.apiUrl ? { apiUrl: values.apiUrl } : {}),
...(values.type ? { type: values.type } : {}), ...(values.type ? { type: values.type } : {}),
...(typeof values.isDisabled === 'boolean' ? { isDisabled: values.isDisabled } : {}), ...(typeof values.isDisabled === 'boolean' ? { isDisabled: values.isDisabled } : {}),
...(values.skuPrefix ? { skuPrefix: values.skuPrefix } : {}), ...(values.skuPrefix ? { skuPrefix: values.skuPrefix } : {}),
}; };
// 中文注释：仅当输入了新密钥时才提交，未输入则保持原本值 // 仅当输入了新密钥时才提交，未输入则保持原本值
if (values.consumerKey && values.consumerKey.trim()) { if (values.consumerKey && values.consumerKey.trim()) {
payload.consumerKey = values.consumerKey.trim(); payload.consumerKey = values.consumerKey.trim();
} }
@ -171,7 +171,7 @@ const SiteList: React.FC = () => {
} }
await request(`/site/update/${editing.id}`, { method: 'PUT', data: payload }); await request(`/site/update/${editing.id}`, { method: 'PUT', data: payload });
} else { } else {
// 中文注释：新增站点时要求填写 consumerKey 和 consumerSecret // 新增站点时要求填写 consumerKey 和 consumerSecret
if (!values.consumerKey || !values.consumerSecret) { if (!values.consumerKey || !values.consumerSecret) {
throw new Error('Consumer Key and Secret are required'); throw new Error('Consumer Key and Secret are required');
} }
@ -226,11 +226,11 @@ const SiteList: React.FC = () => {
formRef={formRef} formRef={formRef}
onFinish={handleSubmit} onFinish={handleSubmit}
> >
{/* 中文注释：站点名称，必填 */} {/* 站点名称，必填 */}
<ProFormText name="siteName" label="站点名称" placeholder="例如：本地商店" rules={[{ required: true, message: '站点名称为必填项' }]} /> <ProFormText name="siteName" label="站点名称" placeholder="例如：本地商店" rules={[{ required: true, message: '站点名称为必填项' }]} />
{/* 中文注释：API 地址，可选 */} {/* API 地址，可选 */}
<ProFormText name="apiUrl" label="API 地址" placeholder="例如：https://shop.example.com" /> <ProFormText name="apiUrl" label="API 地址" placeholder="例如：https://shop.example.com" />
{/* 中文注释：平台类型选择 */} {/* 平台类型选择 */}
<ProFormSelect <ProFormSelect
name="type" name="type"
label="平台" label="平台"
@ -239,12 +239,12 @@ const SiteList: React.FC = () => {
{ label: 'Shopyy', value: 'shopyy' }, { label: 'Shopyy', value: 'shopyy' },
]} ]}
/> />
{/* 中文注释：是否禁用 */} {/* 是否禁用 */}
<ProFormSwitch name="isDisabled" label="禁用" /> <ProFormSwitch name="isDisabled" label="禁用" />
<ProFormText name="skuPrefix" label="SKU 前缀" placeholder={editing ? '留空表示不修改' : '可选'} /> <ProFormText name="skuPrefix" label="SKU 前缀" placeholder={editing ? '留空表示不修改' : '可选'} />
{/* 中文注释：WooCommerce REST consumer key；新增必填，编辑不填则保持原值 */} {/* WooCommerce REST consumer key；新增必填，编辑不填则保持原值 */}
<ProFormText name="consumerKey" label="Key" placeholder={editing ? '留空表示不修改' : '必填'} rules={editing ? [] : [{ required: true, message: 'Key 为必填项' }]} /> <ProFormText name="consumerKey" label="Key" placeholder={editing ? '留空表示不修改' : '必填'} rules={editing ? [] : [{ required: true, message: 'Key 为必填项' }]} />
{/* 中文注释：WooCommerce REST consumer secret；新增必填，编辑不填则保持原值 */} {/* WooCommerce REST consumer secret；新增必填，编辑不填则保持原值 */}
<ProFormText name="consumerSecret" label="Secret" placeholder={editing ? '留空表示不修改' : '必填'} rules={editing ? [] : [{ required: true, message: 'Secret 为必填项' }]} /> <ProFormText name="consumerSecret" label="Secret" placeholder={editing ? '留空表示不修改' : '必填'} rules={editing ? [] : [{ required: true, message: 'Secret 为必填项' }]} />
</DrawerForm> </DrawerForm>
</> </>

22
src/pages/Subscription/Orders/OrderDetailDrawer.tsx
View File

@ -27,21 +27,21 @@ import { formatShipmentState, formatSource } from '@/utils/format';
import RelatedOrders from './RelatedOrders'; import RelatedOrders from './RelatedOrders';
import { ORDER_STATUS_ENUM } from '@/constants'; import { ORDER_STATUS_ENUM } from '@/constants';
// 中文注释:为保持原文件结构简单，此处从 index.tsx 引入的子组件仍由原文件导出或保持原状 // 为保持原文件结构简单，此处从 index.tsx 引入的子组件仍由原文件导出或保持原状
// 若后续需要彻底解耦，可将 OrderNote / Shipping / SalesChange 也独立到文件 // 若后续需要彻底解耦，可将 OrderNote / Shipping / SalesChange 也独立到文件
// 当前按你的要求仅抽离详情 Drawer // 当前按你的要求仅抽离详情 Drawer
type OrderRecord = API.Order; type OrderRecord = API.Order;
interface OrderDetailDrawerProps { interface OrderDetailDrawerProps {
tableRef: React.MutableRefObject<ActionType | undefined>; // 中文注释:列表刷新引用 tableRef: React.MutableRefObject<ActionType | undefined>; // 列表刷新引用
orderId: number; // 中文注释:订单主键 ID orderId: number; // 订单主键 ID
record: OrderRecord; // 中文注释:订单行记录 record: OrderRecord; // 订单行记录
open: boolean; // 中文注释:是否打开抽屉 open: boolean; // 是否打开抽屉
onClose: () => void; // 中文注释:关闭抽屉回调 onClose: () => void; // 关闭抽屉回调
setActiveLine: (id: number) => void; // 中文注释:高亮当前行 setActiveLine: (id: number) => void; // 高亮当前行
OrderNoteComponent: React.ComponentType<any>; // 中文注释:备注组件(从外部注入) OrderNoteComponent: React.ComponentType<any>; // 备注组件(从外部注入)
SalesChangeComponent: React.ComponentType<any>; // 中文注释:换货组件(从外部注入) SalesChangeComponent: React.ComponentType<any>; // 换货组件(从外部注入)
} }
const OrderDetailDrawer: React.FC<OrderDetailDrawerProps> = ({ const OrderDetailDrawer: React.FC<OrderDetailDrawerProps> = ({
@ -57,7 +57,7 @@ const OrderDetailDrawer: React.FC<OrderDetailDrawerProps> = ({
const { message } = App.useApp(); const { message } = App.useApp();
const ref = useRef<ActionType>(); const ref = useRef<ActionType>();
// 中文注释:加载详情数据(与 index.tsx 中完全保持一致) // 加载详情数据(与 index.tsx 中完全保持一致)
const initRequest = async () => { const initRequest = async () => {
const { data, success }: API.OrderDetailRes = await ordercontrollerGetorderdetail({ orderId }); const { data, success }: API.OrderDetailRes = await ordercontrollerGetorderdetail({ orderId });
if (!success || !data) return { data: {} } as any; if (!success || !data) return { data: {} } as any;
@ -84,7 +84,7 @@ const OrderDetailDrawer: React.FC<OrderDetailDrawerProps> = ({
size="large" size="large"
onClose={onClose} onClose={onClose}
footer={[ footer={[
// 中文注释:备注组件(外部传入以避免循环依赖) // 备注组件(外部传入以避免循环依赖)
<OrderNoteComponent key="order-note" id={orderId} descRef={ref} />, <OrderNoteComponent key="order-note" id={orderId} descRef={ref} />,
...(['after_sale_pending', 'pending_reshipment'].includes( ...(['after_sale_pending', 'pending_reshipment'].includes(
record.orderStatus, record.orderStatus,

2
src/pages/Subscription/Orders/RelatedOrders.tsx
View File

@ -8,7 +8,7 @@ dayjs.extend(relativeTime);
/** /**
* RelatedOrders 表格组件 * RelatedOrders 表格组件
* 用于展示订单详情中的关联数据(订阅/订单)，按统一表格样式渲染 * 用于展示订单详情中的关联数据(订阅/订单)，按统一表格样式渲染
* 中文注释:本组件将订阅与订单统一归一化为五列展示，便于快速浏览 * 本组件将订阅与订单统一归一化为五列展示，便于快速浏览
*/ */
const RelatedOrders: React.FC<{ data?: any[] }> = ({ data = [] }) => { const RelatedOrders: React.FC<{ data?: any[] }> = ({ data = [] }) => {
const rows = (Array.isArray(data) ? data : []).map((it: any) => { const rows = (Array.isArray(data) ? data : []).map((it: any) => {