What's Live Today vs. On the Roadmap

Trazir's current focus is Digital Product Passports and compliance data traceability — that layer is production-ready and is what the platform is being promoted on. The planning and AI layers are already built and usable; they are being refactored and reconfigured before they move to the same production-ready bar.

Logging In

1. Navigate to your tenant's subdomain (e.g. acme.trazir.com).
2. Enter your email and password on the Login screen.
3. On success you are redirected to the Dashboard Home.
4. Your session is maintained via a short-lived JWT access token refreshed automatically in the background — no need to log in again during a working day.

Navigation

The sidebar links map to modules. Visibility depends on your role permissions.

Home Dashboard

The home page shows a live summary tailored to your role. Factory users see:

• KPI cards: pending assignment requests, active assignments, documents uploaded, and pending review items.
• Production Planning widget: total active plans with a colour-coded risk breakdown (Low / Medium / High / Critical). The top 3 plans are listed with their completion progress bars and ship dates. Click the widget to go directly to the Production Planning module.
• DPP Progress chart: shows digital product passports at Draft / Generated / Published stages.

Production — Dashboard Tab

The dashboard is the first thing factory operators see when opening Production Planning. It shows a live snapshot of all active and draft plans.

• Risk summary cards — counts of plans at LOW / MEDIUM / HIGH / CRITICAL risk.
• Active plans table — each row shows order number, style, buyer, quantity, SAM, completion %, days to ship, and risk badge.
• Risk colours: green = LOW, amber = MEDIUM, orange = HIGH, red = CRITICAL.
• Click View on any plan to open its detail panel directly in the Plans tab.

Production — Creating a Plan

1. Go to Production → Plans tab and click + New Plan.
2. Select a Production Profile — this defines shift hours, learning curve parameters, and production phases.
3. Fill in order details: Order Number, Style Name, Buyer, Quantity (pcs), SAM (standard allowed minutes).
4. Set Planned Start Date and Ship Date.
5. Optionally override the profile's initial/target efficiency and learning curve days.
6. Click Create Plan. The system calculates the projected completion date and initial risk level immediately.

Production — Managing Plan Status

Each plan moves through a defined status lifecycle. Status transitions are available from the plan's detail header.

To edit a plan (order details, dates, efficiency parameters), click the pencil icon on any row in the Plans list. All fields are optional in the edit dialog — only changed values are sent to the server.

Production — Submitting Daily Output

This is the most frequent task for factory floor supervisors. It is done once per shift per line.

1. Open a plan's detail by clicking it in the Plans list or from the dashboard.
2. The entry form is in the Overview tab (first tab), at the top of the detail panel.
3. Select Production Line, Date, Shift (1 = Morning, 2 = Afternoon, 3 = Overtime).
4. Enter Actual Qty produced, Defect Qty, and Worker Count.
5. Optionally select a Production Phase (for WIP tracking) and add notes or defect category.
6. Submit. The system computes:
   • — Target Qty: based on worker count × working hours × effective efficiency (adjusted for learning curve day and working calendar day factor)
   • — Efficiency %: actual/target
   • — DHU %: defects per hundred units
7. Plan risk and projected completion are recalculated and updated instantly.

Production — Line Assignments

Line assignments link a production line to a plan for a date range.

1. Inside a plan's Line Assignments tab, click + Assign Line.
2. Select the line, set start/end dates and allocated worker count.
3. To edit an existing assignment, click Edit on the row — inline editing opens directly in the table.
4. Save or Cancel.

Production — TNA Milestones

TNA (Time & Action) milestones track key dates in an order's lifecycle (fabric booking, PP sample, bulk cutting, etc.). They are auto-generated when a plan is created, or can be managed manually.

• Auto-generate: click Generate Defaults in the Milestones tab to create a standard set based on the ship date.
• Status colours: PENDING = grey, DUE_TODAY = amber, OVERDUE = red, COMPLETED = green.
• Mark a milestone complete by editing it and checking Completed with an actual date.
• The Days Variance column shows how many days early (negative) or late (positive) completion was.
• Bulk date shift: if a ship date changes, use the Shift pending N days control in the tab header to move all incomplete milestone dates forward or backward at once (enter a positive number to push forward, negative to pull back). Completed milestones are not affected.

Production — WIP & Quality (DHU)

• WIP Summary: the WIP tab aggregates actual quantity per production phase. The pie/bar breakdown shows how output is distributed across Cutting, Sewing, Finishing, etc.
• DHU Trend: the Quality tab shows a rolling chart of Defects per Hundred Units over the last 14 days. A rising trend is an early warning signal for quality issues.
• DHU is calculated as: defectQty / actualQty × 100 per entry, then averaged per day.

Production — Logging Downtime

1. Open the plan → Downtime tab → Log Downtime.
2. Select the affected Line, Date, downtime type (MACHINE_BREAKDOWN, POWER_OUTAGE, MATERIAL_SHORTAGE, OPERATOR_ABSENT, OTHER), and duration in minutes.
3. Add a description if needed.
4. Once the issue is resolved, click Resolve to timestamp it.
5. The Summary panel shows total hours lost and breakdown by category.

Production — Attendance Records

Track scheduled vs. actual worker attendance per line per day.

1. Open the plan → Attendance tab → + Record Attendance.
2. Select line, date, scheduled workers, and actual workers.
3. The system calculates Absent Count and Absence Rate % automatically.
4. Records can be upserted (same line+date re-opens for editing).

Production — QC Inspections

Track inline, pre-final, final AQL, and third-party inspection records against a plan.

1. Open the plan → Inspections tab → + Add Inspection.
2. Select inspection type (INLINE / PRE_FINAL / FINAL / THIRD_PARTY), date, inspector name and company (e.g. SGS, QIMA, buyer QC).
3. Fill in AQL level (AQL 1.5 / 2.5 / 4.0), sample size, defects found, and result (PASS / FAIL / CONDITIONAL).
4. If the result is FAIL, toggle Re-Inspection Required and set a re-inspection date.
5. Optionally add a defect breakdown map (e.g. STITCH: 5, MEASUREMENT: 2) in the Remarks field.

Production — Material & Trim Status

Track fabric, trims, accessories, and packing materials from booking through QC approval.

• Open the plan → Materials tab → + Add Material.
• Select material type (FABRIC, LINING, BUTTON, ZIPPER, LABEL, THREAD, POLYBAG, CARTON, etc.), enter supplier and required date.
• Update status as material progresses: PENDING → ORDERED → IN_TRANSIT → RECEIVED → APPROVED (or REJECTED / SHORT).
• The Days Until Required column highlights materials that are overdue in red.
• Record quantity ordered and received, with unit (MTR, KG, PCS, DOZEN).
• On QC clearance, fill in Approved By and Approved Date and change status to APPROVED.

Production — Buyer Change Instructions

Track mid-production buyer instructions — label changes, washing instructions, color adjustments, packing changes, and other requirements.

1. Open the plan → Buyer Changes tab → Add Instruction.
2. Set the instruction date, change type (COLOR_CHANGE, LABEL_CHANGE, WASHING_INSTRUCTION, SIZE_ADJUSTMENT, QC_REQUIREMENT, PACKING_CHANGE, DELIVERY_DATE_CHANGE, or OTHER), title, and description.
3. Optionally set Affected Qty (how many pcs are impacted) and Implementation Deadline.
4. Instructions with a deadline in the past and not yet implemented will appear in red (overdue).
5. Once actioned, click Mark Done, select the implementation date, and save — the instruction is archived as completed.

Production — Sample Approvals

Track buyer approval of fabric swatches, color lab dips, trim samples, size sets, PP samples, and top-of-production samples.

• Open the plan → Samples tab → Add Sample.
• Sample types: FABRIC, COLOR_LAB_DIP, TRIM, BUTTON, LABEL, SIZE_SET, PP_SAMPLE, TOP_OF_PRODUCTION, OTHER.
• Enter sample name, supplier, submitted date, and buyer contact name.
• Mark samples as Critical (red border highlight) if production cannot start without them.
• Update status via Update Status: SUBMITTED → APPROVED (with approver name + date) or REJECTED (with rejection reason) or REVISION_REQUIRED.
• The summary pills at the top show approved / pending / rejected counts at a glance.

Production — Rework Tracking

Log rejected batches and track rework progress. The recovery rate KPI shows what percentage of rejected pcs were successfully reworked vs scrapped.

1. Open the plan → Rework tab → Log Rejection.
2. Enter rejection date, rejected qty, rejection type (INSPECTION_FAIL, BUYER_RETURN, QC_HOLD, SHADE_VARIATION, MEASUREMENT_FAIL, OTHER), and a description.
3. Optionally set a Rework Start Date if rework has begun.
4. When rework finishes, click Mark Complete — enter end date, qty successfully reworked, and qty scrapped.
5. Status transitions: PENDING → IN_REWORK → COMPLETED or SCRAPPED.
6. KPI cards show total rejected qty, reworked qty, scrapped qty, and overall recovery rate % across all rework records.

Production — Defect Root Cause Analysis

Analyse which defect categories are driving quality failures and which lines/days have the worst DHU rates.

• Open the plan → Defect Analysis tab. Data loads automatically from all daily entries.
• Category Breakdown: horizontal bar chart showing each defect category (BROKEN_STITCH, OPEN_SEAM, PANEL_SHADE, etc.) with its count and share %.
• Top Hotspots: table listing the top-5 line × date combinations with highest DHU%, sorted descending. Use this to identify specific lines or shifts causing quality spikes.
• KPI cards: Overall DHU%, worst category, total defect count, and number of categories tracked.
• For this tab to show meaningful data, supervisors must enter Defect Category when logging daily entries — not just defect quantity.

Production — Labour Cost Tracking

Record daily labour costs per shift to compute cost-per-piece and track budget vs actual.

1. Open the plan → Labour Costs tab → Add Entry.
2. Enter date, shift (1/2/3), worker count, regular hours worked, and wage per worker (BDT).
3. For overtime: enter OT hours and OT premium rate (default 1.5×). Total cost is calculated automatically.
4. The summary cards show: Total Cost (BDT), Avg Daily Workers, Cost per Piece (total cost ÷ completed qty), and Total OT Hours.

Production — Lead Time Breakdown

Visualise the full lead time for an order split into pre-production, production, and buffer phases.

• Open the plan → Lead Time tab.
• Click Set Confirmation Date to enter the Order Confirmation Date — this is when the buyer officially confirmed the order, the true lead time anchor.
• Once set, four KPI cards appear: Pre-Production Days (confirmation → production start), Production Days (start → projected completion), Buffer Days (completion → ship date), and Total Lead Time.
• The proportional timeline bar shows the relative size of each phase — pre-prod (grey), production (violet), buffer (green/red depending on buffer days).
• Buffer days colour: green ≥ 7 days, amber 3–6 days, red < 3 days.
• The Key Dates table below shows all four anchor dates with calendar formatting.

Production — Audit Trail

Every significant action on a plan is logged automatically and viewable in the History tab of the plan detail.

• Events logged: PLAN_CREATED, PLAN_UPDATED, STATUS_CHANGED, ENTRY_SUBMITTED, ENTRY_UPDATED, ENTRY_DELETED, LINE_ASSIGNED, LINE_ASSIGNMENT_UPDATED, LINE_ASSIGNMENT_REMOVED.
• Each record shows: timestamp, actor (user who made the change), and a human-readable summary.
• The audit trail is read-only and cannot be modified.

Production — Gantt Timeline

The Timeline tab shows all active plans across all production lines as an interactive Gantt chart.

• Period selector — preset buttons (2W / 4W / 2M / 3M) or custom date pickers set the visible range.
• Zoom slider — drag from 8 px/day (3-month overview) to 36 px/day (day-level detail). Bars, labels and milestones all rescale instantly.
• Scroll to Today button — centres the chart on today's date with one click.
• Risk filter chips — tap LOW / MEDIUM / HIGH / CRITICAL to hide all other plans. Multiple chips can be active at once. Clear button resets filters.
• Status filter chips — filter by DRAFT or ACTIVE independently of risk.
• Bar colours reflect risk level (green / amber / orange / red). The darker fill inside shows completion %.
• Friday shading — light grey column bands mark every Friday (non-working day). Custom holidays from the Working Calendar are not yet overlaid.
• Ship date flag — a small red triangle at the top of each bar marks the exact ship date deadline, separate from where the bar ends.
• TNA milestone diamonds — purple = critical, green = completed, grey = pending.
• Drag to reassign — drag a bar vertically to move the plan to a different line of the same type. The move is saved immediately.
• Click any bar (without dragging) to open the full plan detail.

Production — Factory Analytics

The Analytics tab gives a factory-level view across all plans and lines — not just a single plan. All data comes from submitted daily entries. No data appears until entries are logged.

• Date range — select a preset (30D / 60D / 90D / 180D / 1Y) or pick custom dates. Defaults to the last 180 days.
• KPI cards:
  • — Total Output — total pcs produced across all plans in the date range
  • — Avg Efficiency — factory-wide average efficiency % (green ≥75%, amber ≥60%, red <60%)
  • — Avg DHU — factory-wide average defects per hundred units
  • — On-Time Rate — % of completed plans that finished on or before their ship date
• Daily Output chart — SVG bar chart showing total pcs produced each day. Violet = actual output, dashed line = average target. Bars that hit target appear brighter.
• Line Performance — ranked list of production lines showing avg efficiency %, avg DHU %, and total pcs. Sorted best to worst efficiency.
• Defect Root Causes — horizontal bar chart of defect categories (BROKEN_STITCH, OPEN_SEAM, etc.) with count and share %. Only populated when supervisors select a Defect Category in the daily entry form.

Working Calendar

The calendar tells the system which days are non-working, affecting target calculations, projected completion dates, and risk assessment.

1. Go to Production → Calendar tab.
2. Click Seed Bangladesh Defaults to auto-populate the 8 national gazetted holidays for the selected year, with Friday as the weekly day off.
3. To add custom holidays or adjust settings, click Add Year or Edit on an existing calendar.
4. In the dialog: toggle Friday Off and Sunday Off, then add individual non-working dates using the date picker.
5. Bangladesh default: Friday = day off, Sunday = working day.

Production Lines

Production lines represent physical sewing, cutting, finishing, QC, or other lines on the factory floor.

• Line types: SEWING, CUTTING, FINISHING, PACKING, QC, EMBROIDERY, PRINTING, WASHING.
• Each line has a Worker Capacity (maximum head count) and Shifts per Day.
• Inactive lines (toggle off) are excluded from plan creation dropdowns.
• The Capacity tab shows utilisation % per line for any date range — useful for identifying bottlenecks before assigning a new plan.

Production Profiles

Profiles are reusable planning templates. A WOVEN profile has different parameters than a KNIT or SWEATER profile.

• Product Category: WOVEN, KNIT, SWEATER, DENIM, OUTERWEAR, MIXED.
• Planning Unit: PCS, DOZEN, or BUNDLE.
• Learning Curve Type: LINEAR (straight ramp) or S_CURVE (slow start, fast ramp, smooth plateau — more realistic for trained lines).
• Initial Efficiency %: Day 1 output as a percentage of peak capacity (typically 40–60%).
• Target Efficiency %: Steady-state peak (typically 75–90%).
• Learning Curve Days: How many days until target efficiency is reached.
• Phases: define the production steps (e.g. Cutting → Sewing → Finishing → QC → Packing) with bottleneck and outsource flags.

AI Recommendations & Knowledge Base

The Knowledge Base feeds historical production data into an AI model that suggests efficiency parameters when creating new plans.

• Upload files (CSV/Excel) containing past order records — the system extracts and indexes them.
• Manual records can also be entered: category, quantity, SAM, planned/actual days, efficiencies, etc.
• Verify records to mark them as reliable training data.
• Change Events log factory-level disruptions (line additions, machine upgrades, major retraining) to provide context to the AI.
• Sync Embeddings pushes verified records into the vector store for semantic retrieval.
• When creating a plan, clicking Get AI Recommendation returns suggested efficiency targets, learning curve days, and daily capacity with a confidence level and explanation.

Compliance

• Energy Logs: log electricity and fuel consumption per factory per day/month.
• Worker Logs: record headcount, overtime hours, and incident data per order and factory.
• Carbon Footprint: calculates CO₂ equivalent for an order based on energy logs and transport mode.
• Compliance Reports: generate PDF compliance certificates covering energy, labour, and carbon data for an audit period. Reports are versioned and downloadable.

The Big Picture: Order → Passport

Every Digital Product Passport in Trazir is the end of one pipeline. Understanding the pipeline makes every other screen make sense.

1. A buying-house user creates an Order and adds one or more Styles (SKUs) to it.
2. The buying house assigns a Style to a Factory. The factory accepts the assignment.
3. Documents flow in — a PO, tech pack, certificates, test reports, production logs, inspection reports — either uploaded manually or dropped into the Data Engine, which reads them, classifies them, and attaches each one to the right order and style automatically.
4. Each document (or a typed value, or data already in the platform) satisfies one or more items on the Style's 16-point DPP checklist.
5. When the checklist is complete, the buying house Generates the DPP, then Publishes it.
6. A public, QR-linked Digital Product Passport page goes live for that style at /dpp/:token — printable on the garment's care label.

Roles & Who Can Do What

Trazir has two scopes. Tenant users (the buying house) see every factory in their account. Factory users see only their own factory's data — and only for styles that have been assigned to their factory and accepted.

Getting Set Up: Factories & Users

Tenant Admin tasks, done once at the start.

1. Add your factories. Factories module → Add Factory. Enter name, code, address, and country — the country becomes the "country of manufacture" on every passport produced there, and can satisfy the DPP's Country-of-Origin item on its own.
2. Invite users. Users module → Invite → enter an email and pick a role. Tenant roles get access to the whole account; factory roles are tied to one factory you select at invite time. The person receives an email link, sets a password, and lands in a dashboard scoped to their role.
3. Factory Admins manage their own team. Once a Factory Admin exists, they can invite and manage Factory Users within that one factory without involving the buying house.

Order Management

Tenant Admin / Manager. The commercial record of what the buyer ordered.

• Create an order — Orders module → New Order. Fields: order number, PO number, buyer, season, quantity, unit price & currency, order date, expected ship date, destination country, incoterms, ports of loading/discharge, payment terms, and tolerance %. You can add styles inline while creating.
• Or create it from a PO file — drop the buyer's purchase-order document into the Data Engine and confirm the proposed order + styles (see Data Engine below). Nothing is created without your confirmation.
• Lifecycle — PENDING → IN_PRODUCTION → SHIPPED → CLOSED. The tab bar filters by status; deleted orders move to the Deleted tab and can be restored.
• Expand a row to see the order's Styles and every Document attached to it, plus each style's DPP checklist progress.
• Search by order number, PO number, or season.

Style Management

Tenant Admin / Manager. A Style is one SKU inside an order — and the unit that gets a passport.

• Add or edit styles from the order's expanded row, or inline while creating the order.
• Fields: style number, colour, description, quantity, unit, unit price, and a size breakdown (per-size quantities, e.g. S:1800 · M:3000 · L:3600).
• The style number is important beyond display: it is the key the Data Engine uses to auto-attach uploaded documents to the correct style.
• Every style has its own DPP checklist and its own published passport — two styles in the same order are two separate passports.

Assigning a Style to a Factory

This is the handshake that connects the buying house and the factory for one style.

1. From the order's Styles list → Assign Factory → choose a factory in your tenant, set a target date and process type.
2. The factory sees a pending assignment request on its Home dashboard and on the style → Accept (or reject).
3. Once ACCEPTED:
   • the factory can upload production, QC, and inspection documents against that style;
   • a Production Plan can be created / linked so the buying house sees live production status against its order;
   • the DPP checklist's Factory Assignment item is satisfied, and assignment-level documents start counting toward the checklist.

Data Engine — Turning Documents into Passport Data

Tenant Manager / Factory Admin upload & review; Tenant User read-only. The Data Engine ingests messy supplier files — Excel, PDFs, scanned certificates — normalises them into structured records, and attaches each one to the right order and style so the DPP checklist fills itself.

Uploading

• Data Engine → Upload & Jobs → drag a file in. Order and Style are optional — leave them blank and the engine works it out from the file's contents.
• Supported: .xlsx, .xls, .pdf. An identical file uploaded twice is rejected (content checksum).

Auto category detection & your approval

• The engine classifies the document — Purchase Order, Tech Pack, GOTS Certificate, Physical Test Report, Production Log, and ~35 more.
• After upload a green approval strip shows the detected category. Approve it, or Change to pick the right one. The category is what the DPP checklist reads — an unclassified document earns no checklist credit.

Smart order & style linking

• Exact, unique match on PO number or style number → auto-linked, no action needed.
• Probable match → suggested. The result screen and the Review Queue show a one-click "Confirm link to …" and a "Not this order".
• A Purchase Order that matches no existing order → the engine proposes creating the order and the styles found inside it, with a checkbox list of styles. Confirm to create; nothing is created silently.
• No match at all → the document is still normalised, but stays unlinked with an item in the Review Queue for you to link manually.

After every upload

• Result screen — three panels: Extracted (document type, row counts, "every row accounted for"), Linked to (which order/style, plus a plain-English reason), Needs review (count + jump to queue).
• Review Queue — field-level fixes, link confirmations, and order-creation confirmations in one place, grouped by document.
• Reconciliation — every ingestion reports parsed → normalized → review so no row is ever silently dropped.
• Confidence checks — extracted values are cross-checked against the raw file; anything the engine cannot trace back to the document is flagged for review, everything else passes clean.

DPP Management — The Readiness Checklist

Tenant Admin / Manager. Every Style has a checklist organised into two tiers. The DPP Overview module lists every accepted style-factory assignment with a completion % (of the ESPR tier) and a status of Draft (< 50%), Ready (≥ 50%), or Complete (100%).

• EU ESPR DPP Readiness — data points aligned to the EU Joint Research Centre's "DPP content for textile apparel" study (May 2026), grouped into the ESPR pillars. This is the compliance metric.
• Traceability Pack — supporting documents Trazir tracks for buyer due-diligence (social audit, final inspection, production log, PO, tech pack). Tracked and shown separately; not counted toward the ESPR %.

Each item completes from any one of: an uploaded document of the right category · a value you type in (a "declaration") · data already in the platform (the factory's country, an existing production plan, factory certificate numbers…).

• Open a checklist item → Enter data for a guided mini-form (e.g. robustness score, recycled % + origin, per-step facility), or Upload the supporting document. Either completes the item.
• One document can tick several items when its category feeds more than one pillar.
• Thresholds and which fields are strictly mandatory stay adjustable — the EU textile delegated act that fixes them is expected Q4 2027, with first obligations on ~2028 collections.
• Fastest path to a complete checklist: run every supplier file through the Data Engine, approve the detected categories, then fill the remaining structured fields by hand.

Publishing a Digital Product Passport

A passport moves through three states: Draft (checklist still filling) → Generated (data compiled, not yet public) → Published (live public page).

1. Bring the Style's checklist to 100% — or decide as the buying house to publish a partial passport.
2. In DPP Overview (or the style's DPP panel) → Generate DPP. This compiles style data, order data, factory identity & country, every satisfying document, certifications with numbers and validity, fibre composition, carbon footprint per garment, and the tiered supply chain into one passport record.
3. Review the generated preview.
4. Publish. The assignment's dppStatus flips to PUBLISHED and its DPP token (a UUID) is activated.
5. The public passport is now live at /dpp/:token — no login required. A QR code encoding that URL is available to print on the garment's care label or hangtag.

What the public page shows:

• product name, style / article number, season, colour, fibre composition, country of manufacture;
• certifications (GOTS / GRS / OEKO-TEX / WRAP …) with certificate numbers and validity dates;
• test results (pass / fail) for physical, chemical, and colourfastness testing;
• carbon footprint per garment;
• the tiered supply chain: assembly → fabric → yarn → fibre → trims — all sourced from the ingested documents.

Shipments

• Create shipment records linked to orders.
• Track status: PENDING → BOOKED → IN_TRANSIT → ARRIVED → CLEARED.
• Record booking date, ETD, ETA, port of loading/discharge, vessel, and container details.
• Search shipments by order, factory, date range, or status.

Notifications

• Notifications are pushed in real time when a plan's risk escalates to HIGH or CRITICAL.
• The bell icon in the header shows unread count.
• Click a notification to navigate directly to the relevant plan.
• Mark notifications read individually or all at once.

ASCO — AI Supply Chain Operator

ASCO is the built-in AI assistant. It can answer questions about your orders, factories, production plans, compliance data, and supply chain risks using real data from your tenant.

• Open the ASCO tab from the sidebar.
• Type any question in natural language — e.g. "Which plans are at risk of missing their ship date?" or "Show me energy usage for Factory A in April."
• ASCO uses tool-calling to query live data and streams the response in real time.
• It can generate risk assessments, order summaries, and compliance snapshots.
• Conversations are scoped to your tenant; ASCO cannot see other tenants' data.