# Delivery Date & Time

Shopify app: scheduling for Shipping / Local Delivery / Store Pickup, with
date-time slots, capacity intelligence, and **all-plan checkout enforcement**
via Cart/Checkout Validation Functions.

Read **[PRODUCT_STRATEGY.md](./PRODUCT_STRATEGY.md)** (why) and
**[IMPLEMENTATION_PLAN.md](./IMPLEMENTATION_PLAN.md)** (how, phased build
order) before making changes. [CLAUDE.md](./CLAUDE.md) holds the
non-negotiables for AI-assisted work in this repo.

## Getting started

```sh
npm install
cp .env.example .env        # fill in Shopify app credentials after linking
npx prisma migrate dev      # creates prisma/dev.sqlite locally
npm run dev                 # shopify app dev — requires `shopify auth login` first
```

Redis must be running locally for slot-holds/BullMQ (Phase 4+):

```sh
redis-server                # or: docker run -p 6379:6379 redis
npm run worker              # BullMQ worker (jobs/worker.ts)
```

## Commands

| Command | Purpose |
|---|---|
| `npm run dev` | `shopify app dev` — local dev against a dev store |
| `npm test` | Vitest unit tests |
| `npm run test:e2e` | Playwright E2E |
| `npm run lint` / `npm run typecheck` | ESLint / `tsc --noEmit` |
| `npx prisma migrate dev` | DB migrations |
| `npm run deploy` | `shopify app deploy` — deploy extensions/functions |
| `npm run worker` | BullMQ worker (hold-expiry, notifications) |

## Status

Greenfield — Phase 0 (scaffold & CI) complete. See §6 of
`IMPLEMENTATION_PLAN.md` for the phased build order and acceptance criteria.