67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
|
# quiXzoom Shop
|
||
|
|
|
||
|
|
E-handel för quiXzoom Field Gear Collection.
|
||
|
|
|
||
|
|
## Arkitektur
|
||
|
|
|
||
|
|
- **Backend:** FastAPI + asyncpg + Redis
|
||
|
|
- **Databas:** PostgreSQL (delad med IOM)
|
||
|
|
- **Frontend:** Jinja2-templates (mobilanpassade)
|
||
|
|
- **App:** WebView som laddar shoppen
|
||
|
|
- **Gating:** Endast Zoomers med 10+ completed missions
|
||
|
|
|
||
|
|
## Produkter
|
||
|
|
|
||
|
|
18 produkter i Field Gear Collection:
|
||
|
|
- Kläder: Field Vest, Mission Shell, Field Pants, Base Layer
|
||
|
|
- Accessoarer: Field Beanie, Field Gloves, Ref. Coin, Tactical Belt, quiXzoom Patch, Field Socks
|
||
|
|
- Utrustning: Capture Strap, Utility Pouch, Pocket Light, Power Module, Cable Kit, Rain Cover, Field Bag, Field Bottle
|
||
|
|
|
||
|
|
## API Endpoints
|
||
|
|
|
||
|
|
| Endpoint | Method | Auth | Beskrivning |
|
||
|
|
|----------|--------|------|-------------|
|
||
|
|
| `/health` | GET | Nej | Health check |
|
||
|
|
| `/api/products` | GET | Nej | Lista produkter |
|
||
|
|
| `/api/products/{id}` | GET | Nej | Produktinfo |
|
||
|
|
| `/api/eligibility` | GET | Ja | Kolla om användare får handla |
|
||
|
|
| `/api/orders` | POST | Ja | Skapa order |
|
||
|
|
| `/api/orders` | GET | Ja | Lista mina ordrar |
|
||
|
|
| `/api/orders/{id}` | GET | Ja | Orderdetaljer |
|
||
|
|
|
||
|
|
## Deployment
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Bygg
|
||
|
|
docker build -t quixzoom-shop:latest .
|
||
|
|
|
||
|
|
# Kör (kräver att iom-network finns)
|
||
|
|
docker-compose up -d
|
||
|
|
```
|
||
|
|
|
||
|
|
## Miljövariabler
|
||
|
|
|
||
|
|
| Variabel | Default | Beskrivning |
|
||
|
|
|----------|---------|-------------|
|
||
|
|
| `DATABASE_URL` | `postgresql://iom:iom_secret@localhost:5432/iom` | PostgreSQL connection |
|
||
|
|
| `REDIS_URL` | `redis://localhost:6379/0` | Redis connection |
|
||
|
|
| `JWT_SECRET` | `quixzoom_secret` | JWT signing key |
|
||
|
|
| `SHOP_MISSION_THRESHOLD` | `10` | Minsta antal uppdrag för att handla |
|
||
|
|
|
||
|
|
## Integration med quiXzoom App
|
||
|
|
|
||
|
|
1. Appen har en "Shop"-tab (🛒)
|
||
|
|
2. WebView laddar `https://shop.quixzoom.com`
|
||
|
|
3. Token injectas via `localStorage`
|
||
|
|
4. Eligibility checkas vid laddning
|
||
|
|
5. Om < 10 uppdrag → låsskärm med progress
|
||
|
|
|
||
|
|
## Framtida förbättringar
|
||
|
|
|
||
|
|
- [ ] Stripe betalningsintegration
|
||
|
|
- [ ] Admin-panel för produkthantering
|
||
|
|
- [ ] Orderhantering (packing, shipping)
|
||
|
|
- [ ] Inventory tracking
|
||
|
|
- [ ] Kampanjkoder
|
||
|
|
- [ ] Wishlist
|