Catalog Guide
Your catalog is the master register of everything you test β finished products, the raw materials and packaging they're made from, and the environmental points you monitor. Anything you send to the lab lives here first.
In one sentence: set an item up once in the catalog, keep its details, composition and history in one place, and send it to the lab in a click.
The four sections
| Section | What lives here | Example |
|---|---|---|
| π§΄ Products | Finished goods that go to market | Whole Milk Yogurt 500 g |
| π§ͺ Raw Materials | Ingredients and inputs, tracked delivery by delivery | Skimmed Milk Powder, Citric Acid |
| π¦ Packaging | Containers and packaging components | 1 L PET Bottle |
| π‘οΈ Environmental | Monitoring points (surfaces, water, air) | Filling Line 1 β surface swab |
You'll find all four under Catalog in the left-hand menu.
How work flows
Create the item β Fill in its details β Approve a version β Send to the lab
- Create the catalog entry (name + type).
- Fill in its field values on its own dossier.
- Approve a version to freeze its current state.
- Send to the lab β a request is raised and linked back to the item.
New here? Jump to First-time setup at the bottom for the full order of operations, including the admin steps.
Reading a dossier
Every catalog item opens onto a dossier β one page that tells its whole story, and the only place you edit it. There is no separate "Manage" page any more: fields, composition, documents, history and versions are all edited inline, right where you're reading them.
Each category gets its own dossier shape, described below.
Creating an item, and the β― menu
New β¦ on each catalog page asks three things: the type β already set to your catalog's standard type for that category, so change it only if another fits better β the name, and, only where the platform offers any, a Based on reference. Create takes you straight to the new item's dossier, where you fill in its details.
The β― button beside Send to lab holds the rest of the item's lifecycle:
- Edit details β rename it, or change its Based on reference. Its type is changed on the Details tab instead, where you see what the change moves before it happens.
- Deactivate β it stays on every request, lot, recipe and batch that already uses it, but is no longer offered when you pick an item for a new sample, delivery, recipe or batch. An Inactive badge marks it everywhere, and Reactivate brings it back.
An item added from a request's sample picker carries a Quick-added badge β a name and a type, nothing else yet β until someone saves its details here.
Two completeness indicators
Every dossier carries two different completeness readings β they answer different questions, so don't conflate them:
-
The header bar β a coloured percentage of required fields filled in. This is the "is it safe to test" number.
Colour Meaning π’ Green (β₯ 85%) Ready to rely on π‘ Amber (β₯ 50%) Getting there π΄ Red (< 50%) Missing key details -
The Details/Specification tab badge β a plain filled / total count across every field the type defines, required or not. It's a completeness count for the record as a whole, not a readiness signal.
100% on the header bar means "safe to test", not "every optional box ticked" β that's what the tab badge is for.
Products
A product is your finished, market-ready item. Its dossier has nine tabs: Details, Recipe, Batches, Composition, Packaged Product, Lab Requests, Documents, History, Versions.
Create one: Catalog β Products β New product β check its type (e.g. Generic Product, Cosmetic Product), enter a name, optionally link a platform reference under Based on, and Create β you land on its Details.
- Details β every field defined for this item, with its current value. Click Edit to turn the tile grid into a form and save every value at once. If a value has drifted from the item's last approved version, that tile shows an amber "was: β¦" caption, with an Approve as v{n} shortcut right there so you don't have to leave the tab to catch up the version.
- Recipe β the production formula linked to this product (see the Manufacturing Guide).
- Batches β every production run made against this product.
- Composition β the raw materials and packaging this product is built from. + Add picks a catalog item and adds it as a component; Remove takes it back off. This is the product's current, live make-up.
- Packaged Product β the actual packaged output recorded from production runs. Don't confuse this with Composition: Composition is what the product is specified to contain; Packaged Product is what a run actually produced.
- Lab Requests β every request raised for this product, in one place.
- Documents / History β see Documents and history.
- Versions β the version record; see the Versioning Guide.
The only button in the header is Send product to lab, which raises a request for this product and takes you straight to it.
Types tailor the fields. A Cosmetic Product asks for a Responsible Person and CPNP reference; a plain Generic Product doesn't. Your admin sets which type carries which fields β see Types.
Raw Materials
The ingredients and inputs that go into your products. A raw material's dossier is lots-first: a material is a stable definition, but what people actually come here for is the stream of deliveries, so the dossier opens on Lots, not Details. Its tabs are: Lots, Specification, Documents, History, Versions, Movements.
Create one: Catalog β Raw Materials β New raw material β type + name β Create.
The header carries two buttons β Receive lot (primary) and Send to lab (secondary, since a delivery arrives far more often than the material goes for testing) β plus an overview strip led by stock figures: On hand, Usable lots, Next expiry, In quarantine, Expired, and the completeness bar.
- Lots β every delivery of this material, each a dated pile of stock with its own quantity remaining. Click a lot to open its detail drawer: quantity left, expiry, supplier, lot numbers, received date, and any fields recorded specifically for that delivery. A quarantined lot's drawer offers Edit, Reject, and Approve; once decided, only approved lots are available to production. Select several lots and use the bulk Send to lab action to raise one request covering all of them.
- Specification β the material's own fields (supplier, CAS number, gradeβ¦), edited the same inline way as a product's Details tab.
- Movements β the append-only stock ledger for this material: every Receipt (+), Consumption (β), Production (+) and Adjustment (Β±) entry, each with its reference and who recorded it. Stock on hand is simply the sum of this ledger, not a separately-kept balance.
- Documents / History / Versions β see below; Documents here can optionally be linked to a specific lot, since a certificate of analysis belongs to a delivery, not the material in general. Versions on this dossier alone also offers Add correction β see the Versioning Guide.
Receive a lot: Lots β Receive lot β quantity, unit, received date, expiry date (this drives which lot gets consumed first β see the Manufacturing Guide), supplier and lot numbers, plus any fields recorded per-delivery β Receive. The lot lands in quarantine.
One material, many products. A raw material can feed any number of products. Link it from the product's Composition tab, so the material itself stays one clean, reusable entry.
Packaging
The physical containers and packaging components for your products. Structurally this dossier is closer to a product's than to a raw material's β it opens on Details, not Lots β with four tabs: Details, Documents, Versions, Lots.
Create one: Catalog β Packaging β New packaging β type + name β Create, then use Edit on Details to record material, food-contact status and recyclability.
The header has one button, Send product to lab. Deliveries are still tracked on the Lots tab exactly as for raw materials β the Lots tab's own Receive lot action lives there rather than in the header.
The Documents tab here is a placeholder for the moment β it lists the document types you'll be able to attach (manufacturer specification, declaration of compliance) marked "Coming soon," rather than a live uploader. Use the raw material or product Documents tab in the meantime if you need to attach a file to a packaging record.
Link packaging to a product from the product's Composition tab β one packaging entry can serve many products.
Environmental monitoring points
Fixed locations or conditions you check on a schedule β not a product or ingredient, but the space around the process (a surface, a water inlet, an air point).
Create one: Catalog β Environmental β New monitoring point β type + a descriptive name (e.g. Kitchen Surface A β north wall faucet) β Create.
A monitoring point's dossier works like the others, with five tabs: Details, Lab Requests, Documents, History, Versions. The overview strip shows when it was last sent to the lab. Send it from the header for each visit; to keep that visit's readings, fill in Details and Approve as v{n}, as on any dossier.
Each version is one test event:
- v1 β January swab of Kitchen Surface A
- v2 β February swab of Kitchen Surface A
- v3 β March swab β¦
Each version records that visit's readings (who sampled, temperature, observations), then goes to the lab.
Documents and history
Every dossier (Packaging's Documents tab excepted, for now) carries two sub-resource tabs:
- Documents β upload any supporting file (PDF, image, Office document, up to 10 MB). Each row shows who uploaded it, when, and its size, with Download and (if you can manage the item) Delete.
- History β a freeform log, not structured data: write a note, attach files if you like, and Post. Entries show the author, timestamp and any attachments. It's where you record context that doesn't belong in a field β a correction, an explanation, a decision.
Finding items
Every catalog list page gives you:
- π a search box β find by name;
- status filter β show only approved, draft, or no-version items;
- stats cards β live totals across the top;
- a view switch β flip between a dense table and a visual card grid.
Click any item to open its dossier.
Types β the fields behind each item
Every catalog item belongs to a subject type, and the type decides which fields the item has, split into General fields (recorded once, on the item itself) and Item fields (recorded on each physical piece of it β every sample sent to a laboratory and, for raw materials and packaging, every lot received). The type also sets which built-in sample fields are asked and the item's default tests β see Subject Types.
- Dairy Product β pH, fat %, protein %, shelf life
- Cosmetic Product β Responsible Person, CPNP reference
- Surface Swipe β location, sampler, temperature, time
Types come in two flavours:
- Platform types (a "Platform" badge) β shipped by SmartQC, shared by everyone. The platform ships neutral generics (Generic Product, Generic Raw Material, β¦) plus a few industry templates like Cosmetic Product.
- Company types β created by your organisation for your own needs.
Need a new field or type? These are managed under Settings & Administration β see the Settings & Administration Guide for how to create and attach them, including how a field's width on the form is set by hovering it in the type's Preview pane.
Platform references β "Based on"
Some items carry a Platform badge: standard references predefined by the platform (a common raw material, a standard monitoring point). When you create your own item you can link it to one via Based on β a simple "ours is derived from the standard" pointer. Platform items themselves can only be edited by administrators.
First-time setup
Setting things up from scratch? This is the recommended order.
Administrator
- Create field definitions β Settings & Administration β Field Definitions.
- Create types and attach their fields β Settings & Administration β Subject Types.
- (Optional) Create platform reference items.
Your team
- Create your raw materials.
- Create your packaging.
- Create your products and link their raw materials and packaging on Composition.
- Fill in field values for each item on its Details/Specification tab.
- Approve a version and send it to the lab when ready β see the Versioning Guide.
Tip: work bottom-up β materials and packaging first, then products β so a product's components already exist when you go to link them.