forked from yoone/API
1
0
Fork 0

Compare commits

...

4 Commits

Author SHA1 Message Date
zhuotianyuan 837254159a feat(adapter): 公开映射方法以支持统一接口调用
将各适配器中的私有映射方法改为公开,并在接口中定义统一方法签名
修改webhook控制器以使用适配器映射方法处理订单数据
2026-01-07 11:54:34 +08:00
zhuotianyuan f2b1036286 refactor(entity): 将可选字段明确标记为可选类型 2026-01-06 19:00:02 +08:00
zhuotianyuan 4af69aeb6f fix(webhook): 更新webhook控制器中的密钥值 2026-01-06 18:57:26 +08:00
zhuotianyuan ecd2a6712b feat(webhook): 添加对shoppy平台webhook的支持
- 在site.entity.ts中添加webhookUrl字段
- 在auth.middleware.ts中添加/shoppy路由到白名单
- 在webhook.controller.ts中实现shoppy平台webhook处理逻辑
2026-01-06 18:48:07 +08:00
6 changed files with 117 additions and 30 deletions

View File

@ -50,7 +50,7 @@ export class ShopyyAdapter implements ISiteAdapter {
// this.mapSubscription = this.mapSubscription.bind(this);
}
private mapMedia(item: any): UnifiedMediaDTO {
mapMedia(item: any): UnifiedMediaDTO {
// 映射媒体项目
return {
id: item.id,
@ -63,7 +63,7 @@ export class ShopyyAdapter implements ISiteAdapter {
};
}
private mapMediaSearchParams(params: UnifiedSearchParamsDTO): any {
mapMediaSearchParams(params: UnifiedSearchParamsDTO): any {
const { search, page, per_page } = params;
const shopyyParams: any = {
page: page || 1,
@ -77,7 +77,7 @@ export class ShopyyAdapter implements ISiteAdapter {
return shopyyParams;
}
private mapProduct(item: ShopyyProduct & { permalink?: string }): UnifiedProductDTO {
mapProduct(item: ShopyyProduct & { permalink?: string }): UnifiedProductDTO {
// 映射产品状态
function mapProductStatus(status: number) {
return status === 1 ? 'publish' : 'draft';
@ -129,7 +129,7 @@ export class ShopyyAdapter implements ISiteAdapter {
};
}
private mapVariation(variant: ShopyyVariant): UnifiedProductVariationDTO {
mapVariation(variant: ShopyyVariant): UnifiedProductVariationDTO {
// 映射变体
return {
id: variant.id,
@ -152,7 +152,7 @@ export class ShopyyAdapter implements ISiteAdapter {
[180]: OrderStatus.COMPLETED, // 180 已完成(确认收货) 转为 completed
[190]: OrderStatus.CANCEL // 190 取消 转为 cancelled
}
private mapOrder(item: ShopyyOrder): UnifiedOrderDTO {
mapOrder(item: ShopyyOrder): UnifiedOrderDTO {
// 提取账单和送货地址 如果不存在则为空对象
const billing = (item as any).billing_address || {};
const shipping = (item as any).shipping_address || {};
@ -333,7 +333,7 @@ export class ShopyyAdapter implements ISiteAdapter {
// 确认发货
}
private mapCustomer(item: ShopyyCustomer): UnifiedCustomerDTO {
mapCustomer(item: ShopyyCustomer): UnifiedCustomerDTO {
// 处理多地址结构
const addresses = item.addresses || [];
const defaultAddress = item.default_address || (addresses.length > 0 ? addresses[0] : {});
@ -726,7 +726,7 @@ export class ShopyyAdapter implements ISiteAdapter {
return this.mapReview(review);
}
private mapReview(review: any): UnifiedReviewDTO {
mapReview(review: any): UnifiedReviewDTO {
// 将ShopYY评论数据映射到统一评论DTO格式
return {
id: review.id || review.review_id,
@ -743,7 +743,7 @@ export class ShopyyAdapter implements ISiteAdapter {
};
}
private mapReviewSearchParams(params: UnifiedSearchParamsDTO): any {
mapReviewSearchParams(params: UnifiedSearchParamsDTO): any {
const { search, page, per_page, where } = params;
const shopyyParams: any = {
page: page || 1,
@ -780,7 +780,7 @@ export class ShopyyAdapter implements ISiteAdapter {
}
// Webhook相关方法
private mapWebhook(item: ShopyyWebhook): UnifiedWebhookDTO {
mapWebhook(item: ShopyyWebhook): UnifiedWebhookDTO {
return {
id: item.id,
name: item.webhook_name || `Webhook-${item.id}`,

View File

@ -42,7 +42,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
}
// 映射 WooCommerce webhook 到统一格式
private mapWebhook(webhook: WooWebhook): UnifiedWebhookDTO {
mapWebhook(webhook: WooWebhook): UnifiedWebhookDTO {
return {
id: webhook.id.toString(),
name: webhook.name,
@ -169,7 +169,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
private mapProductSearchParams(params: UnifiedSearchParamsDTO): Partial<WooProductSearchParams> {
mapProductSearchParams(params: UnifiedSearchParamsDTO): Partial<WooProductSearchParams> {
const page = Number(params.page ?? 1);
const per_page = Number(params.per_page ?? 20);
const where = params.where && typeof params.where === 'object' ? params.where : {};
@ -225,7 +225,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
return mapped;
}
private mapOrderSearchParams(params: UnifiedSearchParamsDTO): Partial<WooOrderSearchParams> {
mapOrderSearchParams(params: UnifiedSearchParamsDTO): Partial<WooOrderSearchParams> {
// 计算分页参数
const page = Number(params.page ?? 1);
const per_page = Number(params.per_page ?? 20);
@ -293,7 +293,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
return mapped;
}
private mapCustomerSearchParams(params: UnifiedSearchParamsDTO): Record<string, any> {
mapCustomerSearchParams(params: UnifiedSearchParamsDTO): Record<string, any> {
const page = Number(params.page ?? 1);
const per_page = Number(params.per_page ?? 20);
const where = params.where && typeof params.where === 'object' ? params.where : {};
@ -346,7 +346,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
return mapped;
}
private mapProduct(item: WooProduct): UnifiedProductDTO {
mapProduct(item: WooProduct): UnifiedProductDTO {
// 将 WooCommerce 产品数据映射为统一产品DTO
// 保留常用字段与时间信息以便前端统一展示
// https://woocommerce.github.io/woocommerce-rest-api-docs/?javascript#product-properties
@ -449,7 +449,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
addr.phone
].filter(Boolean).join(', ');
}
private mapOrder(item: WooOrder): UnifiedOrderDTO {
mapOrder(item: WooOrder): UnifiedOrderDTO {
// 将 WooCommerce 订单数据映射为统一订单DTO
// 包含账单地址与收货地址以及创建与更新时间
@ -502,7 +502,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
};
}
private mapSubscription(item: WooSubscription): UnifiedSubscriptionDTO {
mapSubscription(item: WooSubscription): UnifiedSubscriptionDTO {
// 将 WooCommerce 订阅数据映射为统一订阅DTO
// 若缺少创建时间则回退为开始时间
return {
@ -520,7 +520,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
};
}
private mapMedia(item: WpMedia): UnifiedMediaDTO {
mapMedia(item: WpMedia): UnifiedMediaDTO {
// 将 WordPress 媒体数据映射为统一媒体DTO
// 兼容不同字段命名的时间信息
return {
@ -866,7 +866,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
return media.map((mediaItem: any) => this.mapMedia(mediaItem));
}
private mapReview(item: any): UnifiedReviewDTO & { raw: any } {
mapReview(item: any): UnifiedReviewDTO & { raw: any } {
// 将 WooCommerce 评论数据映射为统一评论DTO
return {
id: item.id,
@ -939,7 +939,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
return result as any;
}
private mapCustomer(item: WooCustomer): UnifiedCustomerDTO {
mapCustomer(item: WooCustomer): UnifiedCustomerDTO {
// 将 WooCommerce 客户数据映射为统一客户DTO
// 包含基础信息地址信息与时间信息
return {
@ -1070,7 +1070,7 @@ export class WooCommerceAdapter implements ISiteAdapter {
}
// 映射 WooCommerce 变体到统一格式
private mapVariation(variation: any, productName?: string): UnifiedProductVariationDTO {
mapVariation(variation: any, productName?: string): UnifiedProductVariationDTO {
// 将变体属性转换为统一格式
const mappedAttributes = variation.attributes && Array.isArray(variation.attributes)
? variation.attributes.map((attr: any) => ({

View File

@ -12,6 +12,7 @@ import * as crypto from 'crypto';
import { SiteService } from '../service/site.service';
import { OrderService } from '../service/order.service';
import { SiteApiService } from '../service/site-api.service';
@Controller('/webhook')
export class WebhookController {
@ -30,6 +31,8 @@ export class WebhookController {
@Inject()
private readonly siteService: SiteService;
@Inject()
private readonly siteApiService: SiteApiService;
// 移除配置中的站点数组,来源统一改为数据库
@ -75,7 +78,14 @@ export class WebhookController {
.update(rawBody)
.digest('base64');
try {
if (hash === signature) {
if (hash !== signature) {
return {
code: 403,
success: false,
message: 'Webhook verification failed',
};
}
const adapter = await this.siteApiService.getAdapter(siteId);
switch (topic) {
case 'product.created':
case 'product.updated':
@ -86,7 +96,8 @@ export class WebhookController {
break;
case 'order.created':
case 'order.updated':
await this.orderService.syncSingleOrder(siteId, body);
const order = adapter.mapOrder(body)
await this.orderService.syncSingleOrder(siteId, order);
break;
case 'order.deleted':
break;
@ -98,6 +109,72 @@ export class WebhookController {
break;
default:
console.log('Unhandled event:', body.event);
return {
code: 200,
success: true,
message: 'Webhook processed successfully',
};
}
} catch (error) {
console.log(error);
}
}
@Post('/shoppy')
async handleShoppyWebhook(
@Body() body: any,
@Query('siteId') siteIdStr: string,
@Query('signature') signature: string,
@Headers() header: any
) {
console.log(`webhook shoppy`, siteIdStr, body, header)
const topic = header['x-oemsaas-event-type'];
// const source = header['x-oemsaas-shop-domain'];
const siteId = Number(siteIdStr);
if (!signature) {
return {
code: HttpStatus.BAD_REQUEST,
success: false,
message: 'Signature missing',
};
}
//shopyy 无法提供加密字段校验,注释校验逻辑
// const rawBody = this.ctx.request.rawBody;
// const hash = crypto
// .createHmac('sha256', this.secret)
// .update(rawBody)
// .digest('base64');
const adapter = await this.siteApiService.getAdapter(siteId);
try {
if (this.secret === signature) {
switch (topic) {
case 'product.created':
case 'product.updated':
// 不再写入本地,平台事件仅确认接收
break;
case 'product.deleted':
// 不再写入本地,平台事件仅确认接收
break;
case 'orders/create':
case 'orders/update':
const order = adapter.mapOrder(body)
await this.orderService.syncSingleOrder(siteId, order);
break;
case 'orders/delete':
break;
case 'customer.created':
break;
case 'customer.updated':
break;
case 'customer.deleted':
break;
default:
console.log('Unhandled event:', topic);
}
return {

View File

@ -11,7 +11,10 @@ export class Site {
apiUrl: string;
@Column({ name: 'website_url', length: 255, nullable: true })
websiteUrl: string;
websiteUrl?: string;
@Column({ name: 'webhook_url', length: 255, nullable: true })
webhookUrl?: string;
@Column({ length: 255, nullable: true })
consumerKey?: string;

View File

@ -20,6 +20,12 @@ import { UnifiedPaginationDTO, UnifiedSearchParamsDTO } from '../dto/api.dto';
import { BatchOperationDTO, BatchOperationResultDTO } from '../dto/batch.dto';
export interface ISiteAdapter {
mapOrder(order: any): UnifiedOrderDTO;
mapWebhook(webhook:any):UnifiedWebhookDTO;
mapProduct(product:any): UnifiedProductDTO;
mapReview(data: any): UnifiedReviewDTO;
mapCustomer(data: any): UnifiedCustomerDTO;
mapMedia(data: any): UnifiedMediaDTO;
/**
*
*/

View File

@ -21,6 +21,7 @@ export class AuthMiddleware implements IMiddleware<Context, NextFunction> {
whiteList = [
'/user/login',
'/webhook/woocommerce',
'/webhook/shoppy',
'/logistics/getTrackingNumber',
'/logistics/getListByTrackingId',
'/product/categories/all',