Admin Guide¶
This guide explains how to run the Freeze Design webshop day to day from the admin dashboard. It is written for shop operators and staff (the UI is Dutch — Dutch menu labels are shown in parentheses) and doubles as an onboarding reference for new team members.
Two admin surfaces
| Surface | URL | Login | Use it for |
|---|---|---|---|
| Frontend admin (primary) | /admin |
Staff account + MFA | Everything below — orders, products, pricing, quotes, figures |
| Django admin (low-level) | /django-admin/ |
Staff account (plain session) | Raw data fixes, the print-area editor and catalog import/export. No TOTP wizard here. |
Almost all daily work happens in the frontend admin (/admin). Only reach for
Django admin when a record needs a low-level edit that the dashboard doesn't expose.
Access & security¶
- Go to
/admin/loginand sign in with your staff account (e-mail and password). - Staff accounts must complete multi-factor authentication. On first login you'll be
guided through TOTP setup (authenticator app, issuer "Freeze Design Admin") and given
recovery codes — store these safely. After the password, the login asks for the code in
the same form (field Verificatiecode, or Herstelcode), so a password manager such as
1Password fills it in. Enforcement is handled by
StaffMFAEnforcementMiddleware; you cannot reach admin pages until MFA is set up. - Brute-force protection: after 5 failed logins the account is locked for 1 hour
(
django-axes). A staff session logs out after 30 minutes without activity (StaffSessionTimeoutMiddleware).
Staging is protected
On staging (staging.freezedesign.nl) the whole site sits behind HTTP basic auth. The
admin is only reachable after the basic-auth gate. Production is live on
www.freezedesign.nl since the DNS move on 2026-09-30; freezedesign.nl and
prod.freezedesign.nl redirect there.
The dashboard at a glance¶
The sidebar (components/admin/AdminNav.tsx) groups the back office in five sections.
Each item maps to a route under /admin (last verified 2026-11-07, v1.60):
| Group | Item (Dutch label) | Route | What you manage |
|---|---|---|---|
| Dagelijks werk | Vandaag | /admin |
Work list (orders needing attention, designs to review, new quote requests, production, low stock, setup readiness) and the shop pulse |
| Cijfers | /admin/cijfers |
Tabs Verkoop, Producten, Klanten, Website (PostHog/Sentry tiles), Winst en conversie | |
| Bestellingen | /admin/orders |
Order list, filters, order detail, production status, refunds, customer messages | |
| Productie | /admin/productie |
Production board — what to print/embroider next, plus manual jobs | |
| Ontwerpen | /admin/designs |
Customer designs + design review (approve/reject uploads), collection items, print files | |
| Offertes | /admin/quotes |
B2B quote requests → quote → convert to order | |
| Klanten | /admin/customers |
Customer profiles and order history | |
| Assortiment | Producten | /admin/products |
Product wizard, "Kant-en-klaar product" (no designer), variants, photos per colour (also all at once from file names), detail photo, print zones, bulk actions; new products start inactive |
| Categorieën / Merken / Kleuren / Maten | /admin/{categories,brands,colors,sizes} |
Catalog taxonomy (category SEO text and FAQ, colour categories per brand, size charts) | |
| Prijzen & kortingen | /admin/pricing |
Discounts, decoration pricing engine, simulator, wizard, bulk price tool; /admin/pricing/proefontwerp for a test design |
|
| Designer-assets | /admin/design-assets |
Fonts, clipart, text colours and personalisation colours offered in the designer | |
| Webwinkel | Pagina's | /admin/pages |
Legal/content pages (rich-text editor) |
| Winkelinstellingen | /admin/settings |
Store settings and switches (see below) | |
| Financiën | Betalingen | /admin/payments |
Read-only Mollie payment log, transaction export |
| Boekhouding | /admin/boekhouding |
Informer bookkeeping link (v1.53): per paid order whether it reached Informer, with the counters Totaal, Afgehandeld, Aandacht and Niet verstuurd; off by default | |
| Facturen | /admin/invoices |
Invoice PDFs | |
| Beheer (collapsed) | Staf & gebruikers | /admin/staff |
Staff accounts & permissions |
| Logboek | /admin/audit-logs |
Who changed what, when | |
| Systeemstatus | /admin/health |
Live health checks (DB, Redis, Celery, backups) | |
| Back-ups | /admin/backups |
Backup history & status |
/admin/beveiliging (login attempts and lockouts) is not in the sidebar; it is linked from the header as "Inloggen en beveiliging".
Vandaag is the guardrail for less-experienced admins: its work list (lib/admin/workItems.ts)
shows, in order of urgency, orders with a problem, designs waiting for review, new quote
requests, open production work, low stock and the setup readiness check. The readiness
item flags products that are not sellable yet (missing price, variants, image or print
zones) and pricing gaps, each with a deep link to the page that fixes it. The sidebar shows
the same counts as badges on Bestellingen, Ontwerpen and Offertes.
Catalog setup¶
A product is only sellable when it passes the completeness check. Work top-down:
- Taxonomy first — create the Categories, Brands, Colors and Sizes you need. Colors and sizes become the axes of a product's variants.
- Create the product (
/admin/products→ new): name, category, base price, description. A new product starts inactive (v1.54); "Activeren" on the product page says what is still missing (price, variants, photo, print areas) but does not block. - Variants — generate the color × size matrix; set stock per variant.
- Images — upload at least one image per color. On the tab Afbeeldingen the button
"Foto's in één keer uploaden" takes all colour photos at once; colour and view come from
the file name (
PREFIX_COLOUR_VIEW_BACKGROUND, e.g.JH50J_ARCTICWHITE_FRONT_WHITE.png; onlyWHITEfiles are used, v1.55). The block "Detailfoto" holds one detail photo with caption, the same for every colour (v1.52). - Print zones — define where the design can go (front/back/left/right) and, optionally, per-zone pricing (see below). Zones drive the designer overlay and the price.
Use the readiness check
The product completeness badge (also on the product list) tells you exactly what a product still needs before it can be sold. Green = ready. It checks: base price, active variants, at least one image, and at least one print zone (the category is required by the data model).
Bulk actions on the product list let you activate/deactivate or feature many products at once, and apply a bulk price change (set / +%/ +amount) to a selection or a whole category. "Dupliceren" on a product page makes an inactive copy with the basic data, prices and print zones; images and variants (colours and sizes) are not copied (feedback #67).
Photo check (v1.60): the block "Foto's" on a product page lists missing or too small
photos as red, orange or grey (red: an active colour without a front photo, or a main or front
photo under 500 × 500 px; orange: under 1000 × 1000 px; grey: for information). The product
list has a column Foto's and the filter "Met foto-waarschuwingen". When some colours have
a front photo, the shop hides the active colours that have none. Photos uploaded before v1.60
are measured once with python manage.py meet_productfotos (--droog only counts, --alles
measures everything again).
A product with is_listed off (Django admin, product status) is only reachable through its
direct link: not in the shop, search, categories, sitemap or product feed. The synthetics test
product uses this (Synthetics).
Collection products
A product can carry a personalisation template (product → tab Personalisatie): Eefje's SVG from Illustrator, with roles per colour and an optional text group (e.g. a year), plus Kleine teksten the customer fills in or leaves empty (feedback #70). The allowed flock and thread colours come from Designer-assets → Personalisatiekleuren. Such a product has no designer button; the customer picks colours and text on the product page.
Pricing & discounts¶
This is the heart of the shop. Pricing has two layers: the decoration engine (what the printing/embroidery costs) and discounts (what comes off the total).
Decoration engine¶
A Decoration method (DecorationMethod) models one technique (e.g. Embroidery / DTF) with:
| Component | Meaning |
|---|---|
setup_fee |
One-off setup per order line |
| per-color charge | Cost per thread/print color |
| per-location charge | Cost per print location |
area matrix (DecorationAreaTier) |
Price tiers by printed area (cm²) |
minimum_charge |
Floor per line |
px_per_cm |
Converts designer pixels → real cm² for the area tiers |
The default method is set in Winkelinstellingen (SiteSettings.default_decoration_method). Each
print zone can carry a price_modifier (a surcharge) so, e.g., a back print costs more.
Activate your default method
If the default decoration method is missing or inactive, the engine falls back silently and prices can come out wrong. The setup-readiness panel flags this.
Price simulator¶
/admin/pricing includes a price simulator. Enter a product, decoration method, colors,
locations, area and quantity, and it shows the full itemised breakdown. It uses the same
decoration_cost_breakdown() function as the real checkout, so what you see is what customers
pay — no drift.
Simulator scope
The simulator covers product base price + decoration + VAT. It deliberately does not apply discount codes, volume discounts (including the staffelkorting on a team order), or shipping — those are separate layers applied at checkout. Use it to sanity-check decoration pricing, not the final cart total. Since v1.54 the print price counts the area in the 600 × 800 reference frame, so phone and laptop give the same price.
Pricing setup wizard¶
For a fast start, the wizard creates ready-to-use decoration methods from presets:
| Preset | Base setup |
|---|---|
| Embroidery (Borduren) | € 10,00 |
| DTF / Transfer | € 2,50 |
(Screen printing / DTG are intentionally not offered.) After running the wizard, open the simulator to verify the numbers before going live.
Discounts¶
Under Pricing & discounts (tabs Kortingscodes, Volumekorting, Acties, Prijsregels,
Decoratiemethoden, Prijs-simulator, Bulk-prijs) you also manage: discount codes,
volume discounts (quantity tiers; a team order gets them as staffelkorting), special
offers and pricing rules. The separate Teamkorting is gone since v1.53. Prices are shown
VAT-inclusive; VAT is server-authoritative. Why a discount code is refused is measured in
PostHog (discount_code_rejected, see the PostHog guide).
Orders & production¶
Order list & detail¶
- Bestellingen (
/admin/orders) — filter by status, date and aandacht (orders flagged for manual handling, e.g. paid but short on stock). Statuses: Wacht op betaling, Betaald, In behandeling, Wordt bedrukt, Verzonden, Afgeleverd, Klaar om af te halen, Afgehaald, Geannuleerd, Terugbetaald. - Order detail — view artwork per line, edit order lines (quantities/variants) with
automatic recalculation, set the production status per line, download the invoice, open the product slip
for the embroidery studio ("Productbon (PDF)", only when a line gets a print; per line product,
colour, size, quantity and print with a picture of the product and the design preview, no prices),
and issue a refund via Mollie (with audit logging). The status buttons (and the bulk status
bar on the list) have a checkbox "Klant een e-mail sturen over de nieuwe status" /
"Klanten mailen", on by default; untick it to change the status without a customer email
(feedback #71). You can also message the customer
directly from the order. The card Betaling shows when the customer accepted the terms and,
for personalised lines, the no-return notice. A team order (v1.53) is one block
Teambestelling ·
· N stuks · maatverdeling with the names list as Excel ("Namenlijst (Excel)"). With the Informer link on, the panel Informer shows the bookkeeping status with "Nu bijwerken" and "Afgehandeld".
Production board¶
Productie (/admin/productie) is a board view of what needs to be produced, per line, with
its print zones and artwork — your shop-floor worklist. Update line status as items move through
printing/embroidery. Orders that come in by WhatsApp or mail can be added with "Handmatige
opdracht toevoegen"; they get a purple Handmatig label and are not orders (no invoice,
stock or mails). When every item of an order is on Verzonden, the order itself goes to
Verzonden (pickup: Klaar om af te halen) without a mail to the customer.
Team orders¶
Since v1.53 a team order is one flow inside the normal shop (behind team_order_enabled,
on in production). The product page offers "Voor jezelf | Voor een team" with quantities
per size and a live price; "Ontwerp voor je team (N stuks)" opens the designer in team
mode, where one row per shirt is prefilled, a pasted list from WhatsApp or Excel is accepted,
and the whole team goes to the cart with one button. In the shop it is one card
(TEAMBESTELLING · /teamkleding explains the flow (the old /team-order and /namen-nummers redirect there).
The Namen & nrs tab in the designer only exists in team mode.
Invoices & payments¶
- Facturen (
/admin/invoices) — PDF invoices with gap-free sequential numbers (INV-YYYY-NNNNN), generated automatically and downloadable by staff. - Betalingen (
/admin/payments) — a read-only log of Mollie payments, including status, webhooks and retries, with a transaction export. Which payment methods the shop offers (iDEAL always; cards, Apple Pay, PayPal, Bancontact, Klarna, Riverty, bank transfer when enabled in Mollie) is set in Winkelinstellingen: the switch "Alle betaalmethoden van Mollie aanbieden" sends the customer to Mollie's own choice screen; off (the default) the checkout shows iDEAL with the bank choice. Eefje ticks which methods are active in Mollie; the USP bar and the checkout name exactly those. - Boekhouding (
/admin/boekhouding) — the Informer link (v1.53, feedback #57). With Boekhouding (Informer) in Winkelinstellingen on, a paid order becomes a sales invoice in Informer with the customer as relation; the page lists what went through and what did not. The checkout block "Ik bestel voor een bedrijf of vereniging" (company name, VAT number) feeds the relation.
Quotes (Offertes)¶
B2B customers can request a quote. In Quotes (/admin/quotes) you review the request,
adjust and send the quote (PDF, numbered OFF-YYYY-NNNNN via QuoteCounter), and — once
accepted — convert it into an order in one click. Quote pricing reuses the same engine as
orders, so it stays consistent.
Next to each request the block "Concept van de assistent" shows a draft from the quote assistant (Freeze AI) once it is there, as plain text. It does nothing by itself; the buttons Bruikbaar / Niet bruikbaar are only for the evaluation. See the agent API runbook.
Customers, designs & content¶
- Klanten (
/admin/customers) — profiles with order history and contact details; messages to a customer are sent from the order. - Ontwerpen (
/admin/designs) — the design review queue. A customer asks for approval from the designer or cart; you approve or reject with a reason (tick "Klant niet mailen" to skip the email; the reason is then optional). Approving also clears the automatic attention flag on the customer's order. See the Design Review guide for the full state machine. A guest who asks for the check gives an email address first (v1.54); the admin shows it as the customer email. From here you can also publish a design to the collection and generate the print file. The block "Ontwerp als los bestand" on a design downloads each side at true size with a transparent background as PNG (300 dpi) or SVG (text as paths) (feedback #72). - Designer-assets (
/admin/design-assets) — manage the fonts, clipart, text colours (with surcharge) and personalisation colours (flock/thread) offered in the designer and on collection products. - Pagina's (
/admin/pages) — edit legal/content pages (terms, privacy, returns, about) in a rich-text editor.
Settings, staff & operations¶
- Winkelinstellingen (
/admin/settings) — sections Ontwerp- & printprijzen (text/image prices, default decoration method), Voorraad & functies (stock management, team ordersteam_order_enabled, all Mollie payment methods and which ones are active, abandoned-cart reminder and its delay, and "Kleurrondjes in de catalogus tonen" (catalog_color_swatches_enabled, off by default: colour dots under the photo on the product card)), Nieuwsbrief (sign-up on/off), Reviews (Google Place-ID, review-request mail and its delay), Mail bij een nieuwe bestelling (shop mail for every paid order and its address, off by default; see the runbook Winkelmail), Boekhouding (Informer) (off / test / live, ledger numbers, payment condition), Homepage (collection section), BTW & verzending, Winkelgegevens and Footer & bedrijfsgegevens (WhatsApp number instead of LinkedIn, and the switch for the "Vraag het via WhatsApp" buttons on the product page and in the designer,whatsapp_buttons_enabled). Each switch says what Ivar has to arrange first. Changes are staff-only and logged. Read the live state of a switch fromGET /api/settings/, not from the changelog. - Staf & gebruikers (
/admin/staff) — manage staff accounts and permissions. - Beveiliging (
/admin/beveiliging) — review login attempts and lockouts (not in the sidebar). - Logboek (
/admin/audit-logs) — an append-only record of admin changes (who/what/when). - Systeemstatus (
/admin/health) & Back-ups (/admin/backups) — live health checks and backup history. Deeper detail lives in the Monitoring and Disaster Recovery runbooks. - Cijfers → Website — five tiles with production numbers from PostHog and Sentry (visitors and sources, shop funnel, orders per source, errors customers hit, slowest pages); all but Bestellingen per bron have a 12-week line. A tile without an API key says "Nog niet ingesteld". Above the tiles, the switch "Deze browser telt mee in de websitecijfers": after logging in to the admin your browser no longer counts in PostHog on the real webshop; switch it on to test a measurement. See the PostHog guide.
Common tasks (recipes)¶
- Ensure the category / colors / sizes exist.
- Products → New: name, category, base price.
- Add variants (color × size) and stock.
- Upload one image per color.
- Add print zones (front/back/…), with per-zone surcharge if needed.
- Check the completeness badge is green → "Activeren" (a new product is inactive until then; the confirmation lists what is still missing).
- Pricing → wizard: pick Embroidery or DTF preset (or configure manually).
- Set it as the default in Winkelinstellingen (or per zone via
price_modifier). - Open the price simulator, enter a realistic product/zone/quantity.
- Confirm the itemised breakdown (base + decoration + VAT) looks right before selling.
- Orders → open the paid order.
- Verify artwork per line; adjust lines if needed (auto-recalculates).
- Set each line's production status; the item appears on the Production board.
- Print/embroider, mark lines done, advance the order to shipped/delivered.
- The invoice PDF is available throughout; message the customer on status changes.
- Quotes → open the request.
- Adjust items/pricing and send the quote (PDF).
- On acceptance, Convert to order — it carries over items and pricing.
Something not sellable or priced oddly?
Start at Vandaag → work list → setup readiness. It pinpoints the product or pricing gap and links straight to the page that fixes it — the fastest path from "something's off" to "fixed".