README

Boutique e-commerce pour l’écosystème Astral — catalogue, panier, checkout, Stripe, frais de port, facture PDF, remboursements et retours colis.

Version 1.5.0 — worker (mail/PDF), stock idempotent, cache catalogue, checklist prod.

Ouvrir une boutique reste à la charge du marchand : identité, textes, paiements, port, exploitation.
→ Documentation : docs/README.md · guides dans docs/Installation/

Écosystème : Astral MVC · astral-payment · astral-shipping · astral-template · astral-php.dev

Périmètre 1.0.0

Zone	Contenu
Catalogue	Catégories, produits TTC, stock, upload image
Auth	`AUTH_REGISTRATION=confirm` (défaut boutique), `/install` 1er admin
Tunnel	Panier → adresse → livraison → carte / virement / chèque + acceptation CGV
Paiement	Stripe + PayPal (webhook) + offline (IBAN / chèque)
Port	`astral-shipping` ^0.5 : forfait + retrait + Colissimo / MR (barèmes) + franco
Commandes	Statut paiement ≠ statut colis ; admin préparation / expédition
Facture	PDF Dompdf via file worker (`QUEUE_DRIVER`), espace client
File	`astral-worker` — confirmation mail + PDF hors requête HTTP
Cache	Catalogue / home (`CACHE_DRIVER=file
Remboursements	Demande client, RIB offline, accept/refus, Stripe / marquage offline
Retours	Délai, réception admin / dispense, refund verrouillé tant que non reçu
Légal	Pages modèles CGV / mentions / retours / confidentialité + `SHOP_LEGAL_*`
UI	Indigo Nova-like (`#4f46e5`), `astral-template` admin

1.1.1 : PayPal Orders v2. 1.5.0 : worker + stock + cache + prod checklist.
Sendcloud / API étiquettes → plus tard.

Moteur vs marchand (à être clair)

Fourni par Astral Shop	À établir par la personne qui ouvre la boutique
Parcours commande, états, garde-fous retours/refund	Identité légale (SIRET, adresse, hébergeur, contact)
Pages légales modèles + case CGV checkout	Textes adaptés à l’activité + validation pro si besoin
Intégration Stripe / offline / facture PDF	Clés live, IBAN/chèque réels, mailer prod
Port forfait + franco + retrait	Montants et politique tarifaire
Admin, cron expire offline	Catalogue, `APP_URL`, cron, monitoring

Sans cette configuration, le projet sert de démo / socle — pas d’une boutique professionnelle ouverte telle quelle.

Détail et checklist : docs/Installation/ouvrir-une-boutique-fr.md

Prérequis

PHP ^8.3, Composer 2 · astral-core ^2.1
SQLite (défaut) ou MySQL
Mailpit (ou SMTP) pour les e-mails
Compte Stripe test + CLI (stripe listen) pour la carte

Installation locale

git clone https://github.com/astral-php/astral-shop.git
cd astral-shop
composer install
cp .env.example .env
php bin/console migrate
php bin/console shipping:rates:import database/rates.example.csv --replace
composer run serve
# ou vhost Laragon → http://astral-shop.local

Ouvrir /install → créer le compte admin
Admin : catégories + produits (poids en grammes pour les barèmes)
Configurer STRIPE_*, PAYPAL_* (sandbox), SHOP_LEGAL_*, IBAN / chèque si besoin
Webhook local :
stripe listen --forward-to http://astral-shop.local/webhooks/stripe

Barèmes Colissimo / MR : CSV d’exemple ci-dessus (valeurs fictives — remplace par ton contrat).
Widgets relais officiels : doc package astral-shipping → docs/widgets-pickup.md (UI démo intégrée au checkout).

Dépendances Astral (Packagist)

"astral-php/astral-core": "^2.1",
"astral-php/astral-payment": "^0.2",
"astral-php/astral-paypal": "^0.2",
"astral-php/astral-shipping": "^0.6",
"astral-php/astral-template": "^0.2",
"astral-php/astral-worker": "^0.2"

Configuration utile

AUTH_REGISTRATION=confirm
SHOP_PRIMARY=#4f46e5
SHOP_FLAT_RATE_CENTS=590
SHOP_FREE_SHIPPING_CENTS=6000
SHOP_OFFLINE_PAYMENT_DAYS=7
SHOP_STORE_ADDRESS="Votre adresse magasin / retour colis"
SHOP_LEGAL_COMPANY="Votre Société SAS"
SHOP_LEGAL_SIRET="123 456 789 00012"
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
QUEUE_DRIVER=database
CACHE_DRIVER=file

Voir .env.example pour Stripe, PayPal, virement, chèque, Redis et l’ensemble SHOP_LEGAL_*.

Après paiement (QUEUE_DRIVER=database) :

php bin/console worker:work --stop-when-empty

Chèque / virement : le stock est réservé à l’engagement jusqu’à payment_due_at.
Expiration + restock (cron / Task Scheduler, ex. 1×/heure) :

php bin/console orders:expire-offline

Documentation

Doc	Chemin
Index docs (entrée unique)	`docs/README.md`
Install pas à pas	`docs/Installation/guide-install-pas-a-pas.md`
Ouvrir une boutique FR	`docs/Installation/ouvrir-une-boutique-fr.md`
Roadmap / QA (hub interne)	`astral-informations/astral-shop/Roadmap/`

Roadmap

1.0.0 → 1.0.2 — livré
1.1.0 — Colissimo / MR barèmes + weight_g
1.1.1 — PayPal
1.5.0 — Optimisation (worker + stock + cache + prod) — livré
Suite écosystème : hub 1.2.8 (après astral-testing)

Licence

MIT

astral-php / astral-shop

Package info

Security

Statistics