Keremet

KEREMET супермаркеті

KEREMET — FastAPI + PostgreSQL және React (Vite) негізіндегі онлайн-супермаркет. Каталог деректері енді PostgreSQL-дағы catalog_items кестесінде сақталады (catalog.json тек seed үшін қолданылады), ал тапсырыстар WhatsApp мәтінімен өңделеді.

Жоба құрылымы

keremet/
├── backend/
│   ├── Dockerfile
│   ├── requirements.txt
│   └── app/...
├── frontend/
│   ├── package.json, src/, public/
├── catalog.json
└── docker-compose.yml

Docker арқылы іске қосу

docker compose build && docker compose up

Сервис порттары:

• Backend API: http://localhost:8000
• PostgreSQL: localhost:5432 (keremet/keremet)
• Adminer: http://localhost:8081 (server: postgres, user: keremet, pass: keremet)

backend сервисі .env ішіндегі айнымалылар арқылы бапталады. Өзгертуге болатын негізгі мәндер:

• STORE_NAME, STORE_CURRENCY, DELIVERY_FREE_FROM, DELIVERY_FEE

Каталогты БД-ға жүктеу

Алдымен контейнерлерді іске қосып алыңыз, содан кейін:

docker compose run --rm backend python -m backend.scripts.load_catalog

Бұл командa catalog.json ішіндегі барлық позицияларды catalog_items кестесіне импорттайды.

Фронтенд (React + Vite)

cd frontend
npm install
npm run dev # http://localhost:5173
# üretim
npm run build && npm run preview

VITE_API_BASE_URL айнымалысын орнатсаңыз, API адресін өзгерте аласыз.

API ерекшеліктері

• Каталог: /api/catalog, /api/catalog/categories, /api/catalog/items — бәрі PostgreSQL-тегі catalog_items кестесінен оқылады.
• Аутентификация: /api/auth/register, /api/auth/login, JWT токен.
• Профиль: /api/profile (GET/PUT) — аты, телефон, мекенжай, тапсырыстар.
• Тапсырыстар: /api/orders (авторизация қажет) — БД-ға сақтап, WhatsApp мәтініне бағыттайды (admin рөліне тыйым салынған).
• Admin Catalog API (Auth: JWT + users.role = 'admin'):
  • GET /api/admin/catalog/items — барлық позицияны көру.
  • POST /api/admin/catalog/items — жаңа тауар қосу (image_url URL-ді де сақтайды).
  • PUT /api/admin/catalog/items/{id} — жазбаны өзгерту.
  • DELETE /api/admin/catalog/items/{id} — өшіру.
  • Admin Orders API:
    • GET /api/admin/orders — барлық тапсырыстар, клиент деректері және статусымен.
    • PUT /api/admin/orders/{id}/status — статусын жаңарту (pending, processing, delivering, completed, cancelled).
  • Веб-интерфейс: фронтендте /admin беті бар (http://localhost:5173/admin), онда «Тауарлар» және «Тапсырыстар» табтары арқылы каталог пен тапсырыстарды басқаруға болады (статус өзгерісі клиент профилінде көрінеді).

Админ жасау үшін users кестесінде role бағанын admin мәніне өзгертіңіз (мысалы, Adminer арқылы). Қарапайым қолданушыларға role='customer' қалады.

Фронтенд беттері

• Home, Catalog, Category, Cart, Profile (қорғалған), Login, Register.
• Себет localStorage-та сақталады, жеткізу ақысы автоматты есептеледі.
• Cart беті профильдегі ФИО/телефон/мекенжайды тек оқуға арналған режимде көрсетеді (тапсырыс тек авторизациядан кейін мүмкін).

WhatsApp логикасы

1. /api/orders — себет элементтері және профиль snapshot-ы БД-ға жазылады.
2. Фронтенд профиль ақпаратын және себет деректерін пайдаланып шаблонға сай хабарлама құрастырады.
3. Қолданушы https://wa.me/77000000000?text=... сілтемесіне бағытталады, чатта дайын мәтін ашылады.