Mina Choi
11d30bb3d1
여러 줄 주석이 설명보다 경위(예전·실측·지적)를 적고 있어 읽는 사람이 결론을 찾기 어려웠다. - ts·tsx·js·mjs·css·py 478개: 여러 줄 주석은 첫 문장 한 줄로, 과거형·날짜 문장은 삭제 - 주석 위치는 TypeScript 파서·파이썬 tokenize/ast 로 찾는다 — 문자열 안의 # · /* 는 건드리지 않는다 - eslint·ts·noqa·type: ignore 같은 지시 주석은 그대로 둔다 파이썬 275개 정리 전후 AST 동일, TS 298개 주석 뺀 토큰 동일(빈 JSX 주석 10곳만 차이). site·frontend·admin tsc, site vitest 105 passed Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
53 lines
1.9 KiB
TypeScript
53 lines
1.9 KiB
TypeScript
import { Body, Controller, Get, Param, Post, Query } from '@nestjs/common';
|
|
import { MatchService } from './match.service';
|
|
import { ServingService } from './serving.service';
|
|
|
|
@Controller('v1')
|
|
export class ServingController {
|
|
constructor(
|
|
private readonly serving: ServingService,
|
|
private readonly matcher: MatchService,
|
|
) {}
|
|
|
|
/** 발행된 사이트가 렌더링 시 호출 — SEO 메타 */
|
|
@Get('sites/:id/seo')
|
|
seo(@Param('id') id: string, @Query('limit') limit?: string) {
|
|
return this.serving.seo(id, clamp(limit, 20, 50));
|
|
}
|
|
|
|
/** 발행된 사이트가 렌더링 시 호출 — AEO(답변엔진) 소스 */
|
|
@Get('sites/:id/aeo')
|
|
aeo(@Param('id') id: string, @Query('limit') limit?: string) {
|
|
return this.serving.aeo(id, clamp(limit, 10, 30));
|
|
}
|
|
|
|
/** 어드민: 의미 기반 키워드 검색 */
|
|
@Post('keywords/search')
|
|
search(@Body() body: { query: string; limit?: number }) {
|
|
return this.serving.searchKeywords(body.query, Math.min(body.limit ?? 10, 50));
|
|
}
|
|
|
|
/** 자유 입력(업체명/문장) → 적재된 사전에서 잘 맞는 키워드. */
|
|
@Post('match')
|
|
match(@Body() body: { query: string; limit?: number; mode?: 'fusion' | 'single' }) {
|
|
const limit = Math.min(body.limit ?? 40, 200);
|
|
return body.mode === 'single'
|
|
? this.serving.match(body.query ?? '', limit)
|
|
: this.matcher.fusion(body.query ?? '', limit);
|
|
}
|
|
|
|
/** 성과 피드백 주입 (Search Console / 유입 로그) */
|
|
@Post('sites/:id/performance')
|
|
performance(
|
|
@Param('id') id: string,
|
|
@Body() body: { items: Array<{ keyword: string; impressions: number; clicks: number }> },
|
|
) {
|
|
return this.serving.applyPerformance(id, body.items ?? []);
|
|
}
|
|
}
|
|
|
|
function clamp(v: string | undefined, def: number, max: number): number {
|
|
const n = v ? Number(v) : def;
|
|
return Number.isFinite(n) ? Math.min(Math.max(1, n), max) : def;
|
|
}
|