Skip to content

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

  1. Go to /admin/login and sign in with your staff account (e-mail and password).
  2. 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.
  3. 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:

  1. Taxonomy first — create the Categories, Brands, Colors and Sizes you need. Colors and sizes become the axes of a product's variants.
  2. 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.
  3. Variants — generate the color × size matrix; set stock per variant.
  4. 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; only WHITE files are used, v1.55). The block "Detailfoto" holds one detail photo with caption, the same for every colour (v1.52).
  5. 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 · ) in cart, checkout, thank-you page and "Mijn bestellingen"; in the admin it is the block described above, with the names list as Excel. The landing page /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 orders team_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 from GET /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)

  1. Ensure the category / colors / sizes exist.
  2. Products → New: name, category, base price.
  3. Add variants (color × size) and stock.
  4. Upload one image per color.
  5. Add print zones (front/back/…), with per-zone surcharge if needed.
  6. Check the completeness badge is green → "Activeren" (a new product is inactive until then; the confirmation lists what is still missing).
  1. Pricing → wizard: pick Embroidery or DTF preset (or configure manually).
  2. Set it as the default in Winkelinstellingen (or per zone via price_modifier).
  3. Open the price simulator, enter a realistic product/zone/quantity.
  4. Confirm the itemised breakdown (base + decoration + VAT) looks right before selling.
  1. Orders → open the paid order.
  2. Verify artwork per line; adjust lines if needed (auto-recalculates).
  3. Set each line's production status; the item appears on the Production board.
  4. Print/embroider, mark lines done, advance the order to shipped/delivered.
  5. The invoice PDF is available throughout; message the customer on status changes.
  1. Quotes → open the request.
  2. Adjust items/pricing and send the quote (PDF).
  3. 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".