How meykiio/openstore-dz works
OpenStore DZ is a self-hosted, Arabic-first e-commerce shop for Algerian merchants. Buyers discover products, choose variants and delivery, then submit cash-on-delivery orders; owners configure the shop, manage orders and products, and moderate reviews. Supabase provides the data and authentication layer, while Guepex and optional AI/Telegram integrations extend operations. The main page’s query and layout wiring and the review-moderation flow are evidenced in excerpts; other product branches are represented from README capabilities, so their internal links are kept conservative.
Main entry points: client.ts Shop database · index.tsx Home storefront · admin.index.tsx Owner dashboard · checkout.tsx COD checkout
Components 22
Buyer storefront
- Home storefront
src/routes/index.tsx - Product discovery
src/lib/catalogue.ts - Product details
src/routes/product.$slug.tsx - Buyer reviews
src/components/storefront/reviews.tsx - COD checkout
src/routes/checkout.tsx - Order tracking
src/routes/track.tsx - Store layout
src/components/storefront/store-layout.tsx
Shop operations
- Shop setup
src/routes/setup.tsx - Owner dashboard
src/routes/admin.index.tsx - Product management
src/routes/admin.products.tsx - Order management
src/routes/admin.slips.tsx - Review moderation
src/routes/admin.reviews.tsx - Delivery operations
src/lib/server/guepex-server.ts
Platform services
- Language and RTL
src/lib/i18n-context.tsx - Query services
src/lib/queries.ts - Shop database
src/lib/supabase/client.ts
External integrations
- AI shop tools
src/lib/server/mcp/server.ts - Order notifications
src/lib/server/telegram.ts - Guepex carrier
Other components
- Buyer
- Shop owner
- Claude assistant
Connections 29
- Buyer → Home storefront: opens shop
- Home storefront → Store layout: renders within
src/routes/index.tsx - Home storefront → Product discovery: loads products
src/routes/index.tsx - Home storefront → Query services: prefetches reviews
src/routes/index.tsx - Product discovery → Product details: opens product
- Product details → COD checkout: starts purchase
- Product details → Buyer reviews: shows reviews
- Buyer → COD checkout: places order
- COD checkout → Order management: creates order
- Buyer → Order tracking: tracks order
- Shop owner → Shop setup: configures shop
- Shop owner → Owner dashboard: manages shop
- Owner dashboard → Product management: manages products
- Owner dashboard → Order management: manages orders
- Owner dashboard → Review moderation: moderates reviews
- Review moderation → Buyer reviews: approves reviews
src/routes/admin.reviews.tsx - Buyer reviews → Shop database: inserts review
src/components/storefront/reviews.tsx - Review moderation → Shop database: updates reviews
- Query services → Shop database: reads shop data
src/lib/queries.ts - Product discovery → Shop database: loads catalogue
src/lib/catalogue.ts - COD checkout → Shop database: records order
- Order management → Delivery operations: creates parcels
- Delivery operations → Guepex carrier: creates shipment
- Order tracking → Guepex carrier: syncs status
- Store layout → Language and RTL: renders locale
- Shop owner → AI shop tools: connects assistant
- Claude assistant → AI shop tools: calls shop tools
- AI shop tools → Shop database: accesses shop data
src/lib/server/mcp/server.ts - Order management → Order notifications: notifies owner