@core / kit-store

1.0.1 ▾

1.0.1

인증됨MIT

GitHub

Next.js 온라인 스토어 키트: 카탈로그, 장바구니, Stripe 결제, 주문, 배송, 쿠폰, 검증 리뷰, 계정

코드파일 27개컨텍스트약 1천토큰검사 통과

약 1천토큰→ src/app/(store)/AGENTS.md→ .cursor/rules/genpm-core-kit-store.mdc

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

@core/kit-store — rules for AI agents

Purpose

An online store on top of @core/kit-cms, managed from the same /admin: products with variants and categories, cart, Stripe Checkout, orders (created only by the Stripe webhook), shipping zones and rates, discount codes, verified reviews, customer orders page, transactional emails and SEO (Product JSON-LD, sitemap). Every storefront form is a Next.js Server Action, so it works without JavaScript and never accepts prices from the browser.

Map

_templates/genpm.md — the exact lines this kit adds to the project's src/genpm/*.ts (generated, always current).
_lib/maintenance.ts — daily store.maintenance job (deletes expired carts).
shop/page.tsx, categories/[slug], collections/[slug] — listings. products/[slug]/page.tsx — product page.
cart/page.tsx — cart, discount code, shipping country/method, totals and payment. checkout/success — real status.
orders/[number]/page.tsx — order for its owner or with the signed email link. account/page.tsx — customer orders.
api/stripe/webhook/route.ts — Stripe webhook (@core/stripe).
_lib/actions.ts — server actions (add, update, code, shipping, checkout, review). _lib/store.ts — helpers.
_components/ — product card/grid, add to cart, CartLink for the header, reviews, order summary, store.css.
_blocks/products.tsx — "Product grid" and "Buy now" blocks. _lib/widgets.ts — sales, orders to ship, low stock.
_lib/legal.ts + _scripts/seed-legal.ts — legal pages as drafts pending review, with a dashboard warning.

Integration

@core/kit-cms must be integrated first.
Env: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, CART_COOKIE_SECRET and ORDER_LINK_SECRET (≥ 32 chars), STORE_CURRENCY (e.g. EUR), SITE_URL, EMAIL_FROM. Use Stripe test mode until the end-to-end check passes. If the Stripe MCP server is available and the person agrees, use it to inspect the test account (never live keys).
Migrations for catalog, cart, checkout, orders, shipping, discounts, reviews, comments and stripe.
Add every line of _templates/genpm.md to the project's src/genpm/*.ts (it says which file and where): it creates src/genpm/commerce.ts (imports that register webhooks, cart steps and the daily store.maintenance job), the product sitemap and search sources, the productGrid / buyNow blocks, and the admin resources and widgets (including comments, where product reviews are moderated). Then run the kit-cms setup-schedules.ts again.
Stripe webhook: endpoint https://<site>/api/stripe/webhook with checkout.session.completed, checkout.session.async_payment_succeeded and checkout.session.expired (refunds are started from the admin); locally stripe listen --forward-to localhost:3000/api/stripe/webhook.
Create shipping zones and rates in the admin; put <CartLink /> in the site header and "Shop" in the menu.
The person runs npx tsx "src/app/(store)/_scripts/seed-legal.ts": terms, shipping, returns/withdrawal, privacy and cookies are created as drafts. They must complete them and have them reviewed before publishing.
Verify in test mode: buy with card 4242 4242 4242 4242, the webhook creates the order, the email arrives, stock decreases, the order page opens from the email link and not without it.

Conventions

Prices are integers in minor units; the client only sends variant ids, quantities, codes and the shipping choice.
Orders exist only after Stripe confirms payment (webhook), never from the success page.
The "before" price is hidden: in the EU it must be the lowest price of the previous 30 days (Omnibus directive). With @core/pricing installed, show it only through honestCompareAt.

Don't

Don't publish legal pages the person has not reviewed, and never present generated legal text as final.
Don't show fake reviews, ratings, stock counts or countdowns; review JSON-LD only with real approved reviews.
Don't expose order pages without the owner session or the signed token; don't put tokens in analytics.

# @core/kit-store — rules for AI agents

## Purpose
An online store on top of @core/kit-cms, managed from the same `/admin`: products with variants and categories,
cart, Stripe Checkout, orders (created only by the Stripe webhook), shipping zones and rates, discount codes,
verified reviews, customer orders page, transactional emails and SEO (Product JSON-LD, sitemap). Every storefront
form is a Next.js Server Action, so it works without JavaScript and never accepts prices from the browser.

## Map
- `_templates/genpm.md` — the exact lines this kit adds to the project's `src/genpm/*.ts` (generated, always current).
- `_lib/maintenance.ts` — daily `store.maintenance` job (deletes expired carts).
- `shop/page.tsx`, `categories/[slug]`, `collections/[slug]` — listings. `products/[slug]/page.tsx` — product page.
- `cart/page.tsx` — cart, discount code, shipping country/method, totals and payment. `checkout/success` — real status.
- `orders/[number]/page.tsx` — order for its owner or with the signed email link. `account/page.tsx` — customer orders.
- `api/stripe/webhook/route.ts` — Stripe webhook (@core/stripe).
- `_lib/actions.ts` — server actions (add, update, code, shipping, checkout, review). `_lib/store.ts` — helpers.
- `_components/` — product card/grid, add to cart, `CartLink` for the header, reviews, order summary, `store.css`.
- `_blocks/products.tsx` — "Product grid" and "Buy now" blocks. `_lib/widgets.ts` — sales, orders to ship, low stock.
- `_lib/legal.ts` + `_scripts/seed-legal.ts` — legal pages as drafts pending review, with a dashboard warning.

## Integration
1. @core/kit-cms must be integrated first.
2. Env: `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `CART_COOKIE_SECRET` and `ORDER_LINK_SECRET` (≥ 32 chars),
   `STORE_CURRENCY` (e.g. `EUR`), `SITE_URL`, `EMAIL_FROM`. Use Stripe test mode until the end-to-end check passes.
   If the Stripe MCP server is available and the person agrees, use it to inspect the test account (never live keys).
3. Migrations for catalog, cart, checkout, orders, shipping, discounts, reviews, comments and stripe.
4. Add every line of `_templates/genpm.md` to the project's `src/genpm/*.ts` (it says which file and where): it creates
   `src/genpm/commerce.ts` (imports that register webhooks, cart steps and the daily `store.maintenance` job), the
   product sitemap and search sources, the `productGrid` / `buyNow` blocks, and the admin resources and widgets
   (including comments, where product reviews are moderated). Then run the kit-cms `setup-schedules.ts` again.
5. Stripe webhook: endpoint `https://<site>/api/stripe/webhook` with `checkout.session.completed`,
   `checkout.session.async_payment_succeeded` and `checkout.session.expired` (refunds are started from the admin); locally `stripe listen --forward-to localhost:3000/api/stripe/webhook`.
6. Create shipping zones and rates in the admin; put `<CartLink />` in the site header and "Shop" in the menu.
7. The person runs `npx tsx "src/app/(store)/_scripts/seed-legal.ts"`: terms, shipping, returns/withdrawal, privacy
   and cookies are created as drafts. They must complete them and have them reviewed before publishing.
8. Verify in test mode: buy with card 4242 4242 4242 4242, the webhook creates the order, the email arrives, stock
   decreases, the order page opens from the email link and not without it.

## Conventions
- Prices are integers in minor units; the client only sends variant ids, quantities, codes and the shipping choice.
- Orders exist only after Stripe confirms payment (webhook), never from the success page.
- The "before" price is hidden: in the EU it must be the lowest price of the previous 30 days (Omnibus directive).
  With @core/pricing installed, show it only through `honestCompareAt`.

## Don't
- Don't publish legal pages the person has not reviewed, and never present generated legal text as final.
- Don't show fake reviews, ratings, stock counts or countdowns; review JSON-LD only with real approved reviews.
- Don't expose order pages without the owner session or the signed token; don't put tokens in analytics.

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

src/app/(store)/_scripts/seed-legal.ts읽기 전용 · 6a45dae

// Crea las páginas legales de la tienda como borradores pendientes de revisión.
// Uso (lo ejecuta la persona, con DATABASE_URL): npx tsx "src/app/(store)/_scripts/seed-legal.ts"
import '@/genpm';
import { seedLegalPages } from '../_lib/legal';

// Sin top-level await: tsx compila a CommonJS en proyectos sin "type": "module" (lo normal en Next).
seedLegalPages().then((created) => {
  console.log(created.length ? `Draft legal pages created: ${created.map((s) => `/${s}`).join(', ')}. Complete and review them before publishing.` : 'Legal pages already exist.');
  process.exit(0);
}, (e) => {
    console.error(e);
    process.exit(1);
  });

버전	커밋	게시일	검사
1.0.1	6a45dae	6시간 전	검사 통과

$genpm add @core/kit-store

주입 위치: src/app/(store)
커밋
태그: v1.0.1
필요: @core/cart ^1.0.0 @core/catalog ^1.0.0 @core/checkout ^1.0.0 @core/discounts ^1.0.0 @core/kit-cms ^1.0.0 @core/orders ^1.0.0 @core/reviews ^1.0.0 @core/shipping ^1.0.0
npm: next >=15.5.0react ^19.0.0zod ^4.0.0
Env: STRIPE_SECRET_KEY STRIPE_WEBHOOK_SECRET CART_COOKIE_SECRET ORDER_LINK_SECRET STORE_CURRENCY
품질: 100/100
사용처: 1
설치 수: 0 / 30일
게시일: 6시간 전 · genpm-system

README 배지

[![genpm](https://api.genpm.net/v1/badge/@core/kit-store.svg)](https://genpm.net/p/@core/kit-store)