智能配送与跑腿平台 — 摩洛哥萨菲

JAHEEZ 是一个多应用的配送和跑腿平台，连接客户与本地司机。用户可以订购食品、杂货、药品、包裹或定制差事。司机负责接收和履行配送。管理员负责管理平台。

---

这个单人里的应用

---

先修条件

• Node.js ≥18
• npm ≥ 9
• Expo CLI： npm install -g expo-cli（或使用 npx expo）
• 手机上的Expo Go应用（用于移动测试）
• Supabase 项目（后端）
• 代码编辑器（推荐使用VS Code）

---

环境设置

1.复制环境文件

2.填写你的Supabase资历

JAHEEZ — جاهز

Smart Delivery & Errands Platform — Safi, Morocco

JAHEEZ is a multi-app delivery and errand platform connecting customers with local drivers. Users order food, groceries, pharmacy items, parcels, or custom errands. Drivers accept and fulfill deliveries. Admins manage the platform.

---

Apps in This Monorepo

---

Prerequisites

• Node.js ≥ 18
• npm ≥ 9
• Expo CLI: npm install -g expo-cli (or use npx expo)
• Expo Go app on your phone (for mobile testing)
• Supabase project (for backend)
• A code editor (VS Code recommended)

---

Environment Setup

1. Copy environment files

# Root (for admin API)
cp .env.example .env

# User app
cp user-app/.env.example user-app/.env

# Admin panel
cp admin/.env.example admin/.env

2. Fill in your Supabase credentials

Get these from your Supabase project dashboard → Settings → API:

• SUPABASE_URL / EXPO_PUBLIC_SUPABASE_URL / VITE_SUPABASE_URL
• SUPABASE_ANON_KEY / EXPO_PUBLIC_SUPABASE_ANON_KEY / VITE_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY (root .env only — for admin API)

3. Optional services

• Infobip — SMS OTP (set INFOBIP_API_KEY and INFOBIP_BASE_URL)
• Stripe — Card payments (set STRIPE_SECRET_KEY and EXPO_PUBLIC_STRIPE_PUBLISHABLE_KEY)
• ModernMT — Dynamic translation (set EXPO_PUBLIC_MODERNMT_API_KEY)

---

Running the User App

cd user-app
npm install
npx expo start

Then scan the QR code with Expo Go on your phone, or press:

• a — Open on Android emulator
• i — Open on iOS simulator
• w — Open in web browser

---

Running the Driver App

cd driver-app
npm install
npx expo start

---

Running the Admin Panel

cd admin
npm install
npm run dev

Opens at http://localhost:5173. Login requires an admin account.

---

Running the Admin API

# From root directory
npm install
node scripts/admin-api.js

Runs on http://localhost:3001. Required for:

• Admin panel authentication
• User registration (phone-disabled fallback)
• Store/driver/order management

Creating an Admin Account

node scripts/create-admin.js

Seeding Sample Stores

node scripts/seed-stores.js

---

Project Structure

jaheez/
├── user-app/          # Customer mobile app (Expo/React Native)
├── driver-app/        # Driver mobile app (Expo/React Native)
├── admin/             # Admin web panel (Vite/React)