# PureNest Shop — owner guide

Admin: https://shop.purenesteggs.com/admin. Sign in with the separately supplied owner credentials. Change the bootstrap password in Settings. Sessions expire after 30 minutes of inactivity.

## Preview and launch
The public sees Coming soon. While signed in, use Preview store to explore the complete storefront. No preview prices are invented: the four initial products are drafts, without prices or stock. Six-pack images are six-egg illustrations, not photographs of the twelve-pack.

1. Products: enter PKR prices, available packs and descriptions; upload pack images if desired. Publish each ready product.
2. Delivery cities: add covered cities, flat delivery fees and optional free-delivery thresholds. An inactive city cannot receive new orders. Existing orders keep their original city and charges.
3. Settings: supply and approve delivery, cancellation/refund and privacy terms.
4. Open the storefront in Settings. It requires a priced product with stock and an active delivery city. COD then becomes available.

## Orders
Orders are saved to the private shop database. Stock is deducted when a COD order is placed. Review incoming orders regularly; no automated email or WhatsApp notification is sent. Use status and payment controls, customer search and CSV export. Cancelling an undelivered order restores stock once. Delivered orders are not automatically restocked. A refund record documents money you have already returned; it does not transfer funds.

## Weekly packages
Create packages by selecting packs per delivery, the number of weeks (1–52), and the total prepaid product price. Delivery charges are added for every weekly delivery. Each city's free-delivery threshold is checked against the package price divided by its number of deliveries. You may publish packages now, but customers cannot purchase them until an approved payment provider is implemented.

There is intentionally no admin switch to bypass the missing payment integration. The current release has no gateway, card collection, bank-transfer checkout, automatic renewals or live subscription purchase endpoint. Provider-specific checkout, signed payment callbacks and payment/refund reconciliation are the next integration step.

The tested internal settlement service reserves all package stock after verified payment. A payment with insufficient stock is flagged for resolution and creates no schedule. Review flagged purchases and arrange fulfilment/refund with the customer. Once stock is available, the Resolve paid stock shortage control reserves the package and schedules the first delivery at least 48 hours ahead. Do not treat a screenshot or browser redirect as proof of payment.

Active subscriptions have dated deliveries and a private management link. Share that link only with the customer; it gives access to their schedule. Reissuing a link revokes the old one. Customers can skip before midnight PKT on the preceding day; all remaining scheduled deliveries move forward seven days. Packages never renew automatically. Admin can edit individual delivery dates/statuses, cancel unused deliveries and record refunds. Cancellation does not refund money automatically. Dispatched deliveries are not restocked by cancelling the remaining package.

## Operations
The fulfilment task runs daily at 00:10 Pakistan time and creates preparation records for deliveries due within two days, without duplicates. Overview shows the last successful run. The current fulfilment queue is shown in the subscription delivery records.

The marketing site's contact and retailer databases are independent. This admin manages shop purchases only.

## Public catalogue and SEO (September 2026 redesign)
The shop is now public in **browse-only mode**. In Settings, catalogue visibility and opening COD orders are separate controls. The four initial egg packs are visible; prices and stock remain unset until you enter them. No public order can be submitted while ordering is closed, including through a direct API request. Online package booking still needs a verified payment provider integration.

Products and weekly packages have a **Visible in public catalogue** checkbox plus independent sales controls. Use descriptive, lowercase hyphenated URL slugs. Published slug changes automatically retain a permanent redirect; old product `?id=` links also redirect. Edit each product/package’s SEO title, description and image alternative text in its editor. Leave optional SEO fields empty for name/description defaults. Package pages containing unpublished products are withheld from the public catalogue.

Published product pages are indexed; search results, admin, basket/checkout and private links are not. Policies stay noindex until approved. Sitemap: https://shop.purenesteggs.com/sitemap.xml — submit this in your verified Google Search Console property. Ranking or indexing is not guaranteed. Public metadata includes branded social preview images; WhatsApp may cache earlier previews.

Launch checklist: enter true prices and stock, enable sales for the intended products, configure delivery cities, approve policy text, then open COD orders. Update descriptions that mention the upcoming launch. The six-pack images are branded SVG pack illustrations and can be replaced with final product photography through the image uploader.

## Sale prices and promo codes
Products and Weekly packages now include optional sale prices. Keep the regular price accurate; sale prices must be positive and lower. Dates are Pakistan time, inclusive at the start and exclusive at the end; blank dates mean no date restriction. Clear the sale price and both dates to remove a sale. Existing orders retain their original snapshots.

Use **Discounts** to create percentage or fixed-PKR codes. Codes are case-insensitive. Choose ordinary orders, weekly packages or both, and optionally set full-price minimum spend, a percentage-saving cap, validity dates and a total redemption limit. Leave limits blank for unlimited use. Disable a code to stop future use. A code applies only to full-price items, excluding delivery. A sale-priced package cannot also take a code. Fixed discounts cannot exceed the eligible merchandise value. Cancelled orders do not return code allowance.

Delivery thresholds use the product total after discounts. Package thresholds apply per delivery, based on the discounted package total divided over its weeks. Customers see regular price, sale savings, promo savings, delivery and total; any changed checkout pricing must be reviewed before submitting again.

No prices or codes were configured for launch by this update. Browse-only and subscription payment restrictions remain. Configure offers only against genuine regular prices. Public pages do not advertise made-up discounts.

### Gateway integration boundary
Package quote requests never consume redemption allowance. Subscription purchasing is still disabled. The internal settlement function deliberately rejects promo-bearing subscription snapshots until a future gateway adapter provides transactional reservation, expiry/release and exactly-once redemption after verified payment. Do not bypass this guard. Integrate and test reservations before opening subscription payment; no live package discount redemption is possible in this release.
