@core / reviews

1.0.1 ▾

1.0.1

인증됨MIT

GitHub

@core/comments 기반 상품 리뷰: 구매 인증, 사진, 출처 표시된 가져온 리뷰, 평점, 리뷰 요청 메일

코드파일 5개컨텍스트약 540토큰검사 통과

약 540토큰→ src/lib/reviews/AGENTS.md→ .cursor/rules/genpm-core-reviews.mdc

이것이 AI가 src/lib/reviews에서 작업할 때 읽는 내용 그대로입니다. 그 외에는 컨텍스트에 아무것도 추가되지 않습니다.

@core/reviews — rules for AI agents

Purpose

Product reviews built on @core/comments (no duplicate comment system): a review is a comment on product/<id> with a 1–5 rating, plus review_meta (verified purchase, photos from @core/media, source) and review_stats per product. "Verified" means the signed-in author has a paid and shipped order with that product (by user id or their account's verified email); guest reviews are never verified, so the response never reveals whether an email bought. Imported reviews are always labeled with their source and never verified. Asks customers for a review N days after delivery.

Map

index.ts — public API: postReview, listReviews, productRating, moderateReview, importReviews, verifiedOrder.
reviews.ts — logic, stats and the reviews.request job (scheduled from the order delivered event on import).

Integration

Requires @core/comments (moderation, anti-spam) and @core/orders. Env: optional REVIEW_REQUEST_DELAY_DAYS (default 7, -1 disables), SITE_URL, EMAIL_FROM.
Migrations as in src/lib/db/AGENTS.md; import this module at startup.
Product page: productRating(id) for stars and JSON-LD (jsonLd.product({ rating }) from @core/seo), listReviews(id, { page, rating, sort }) for the list; show a "Verified purchase" badge and, for imported ones, "Imported from <source>".
Review form → postReview({ productId, rating, body, user | guest, photos }, { headers, fields }) with @core/antispam fields.
Moderate in the comments admin (filter entityType=product) and call moderateReview so stats update.
Verify: a buyer's review shows as verified after approval and the product rating changes.

Conventions

Explain on the page how reviews are checked (EU Omnibus Directive): verified = confirmed order.
Show all approved reviews, including negative ones; sort options must not hide them by default.

Don't

Don't write, generate or buy fake reviews, and don't mark imported reviews as verified.
Don't put aggregateRating in JSON-LD when there are no approved reviews.
Don't offer rewards conditioned on a positive review.

# @core/reviews — rules for AI agents

## Purpose
Product reviews built on @core/comments (no duplicate comment system): a review is a comment on `product/<id>` with a
1–5 rating, plus `review_meta` (verified purchase, photos from @core/media, source) and `review_stats` per product.
"Verified" means the signed-in author has a paid and shipped order with that product (by user id or their account's
verified email); guest reviews are never verified, so the response never reveals whether an email bought. Imported reviews are always labeled with
their source and never verified. Asks customers for a review N days after delivery.

## Map
- `index.ts` — public API: `postReview`, `listReviews`, `productRating`, `moderateReview`, `importReviews`, `verifiedOrder`.
- `reviews.ts` — logic, stats and the `reviews.request` job (scheduled from the order `delivered` event on import).

## Integration
1. Requires @core/comments (moderation, anti-spam) and @core/orders. Env: optional `REVIEW_REQUEST_DELAY_DAYS` (default 7, `-1` disables), `SITE_URL`, `EMAIL_FROM`.
2. Migrations as in `src/lib/db/AGENTS.md`; import this module at startup.
3. Product page: `productRating(id)` for stars and JSON-LD (`jsonLd.product({ rating })` from @core/seo), `listReviews(id, { page, rating, sort })`
   for the list; show a "Verified purchase" badge and, for imported ones, "Imported from <source>".
4. Review form → `postReview({ productId, rating, body, user | guest, photos }, { headers, fields })` with @core/antispam fields.
5. Moderate in the comments admin (filter `entityType=product`) and call `moderateReview` so stats update.
6. Verify: a buyer's review shows as verified after approval and the product rating changes.

## Conventions
- Explain on the page how reviews are checked (EU Omnibus Directive): verified = confirmed order.
- Show all approved reviews, including negative ones; sort options must not hide them by default.

## Don't
- Don't write, generate or buy fake reviews, and don't mark imported reviews as verified.
- Don't put `aggregateRating` in JSON-LD when there are no approved reviews.
- Don't offer rewards conditioned on a positive review.

.genpmignore 적용 후 주입될 정확한 트리입니다. 고정 대상:

src/lib/reviews/LICENSE읽기 전용 · 9c40b7a

MIT License

Copyright (c) 2026 GenPM

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.