๐๏ธ What's In the Console
| Module | What It Does | Who Uses It |
|---|---|---|
| Import Manager | Track overseas shipments, process supplier invoices, allocate to Fishbowl POs, generate receiving worksheets | Jaya |
| TruSim Admin | Manage TruSim golf screen orders, verify customers, update order status, view saved quotes | Jaya, Chase, Nicole |
| Customer Onboarding | Review new customer applications, approve/deny accounts, trigger payment emails | Jaya |
| User Management | Add/remove staff access, set card permissions โ superadmin only | Nik, Jaya |
๐ Signing In
- Go to canwil-import-manager-production.up.railway.app
- Sign in with Google (recommended) or email + password
- You only see the cards your account has access to
- If a card is missing, contact Nik or Jaya to update your access
๐ Navigation
- The top nav bar shows all modules you have access to
- Each module card on the dashboard shows live stats
- The Import Manager is at /app, TruSim Admin at /trusim-admin, Customer Onboarding at /customers
โ๏ธ Morning Check (5 min)
- Open TruSim Admin โ check the stats row at the top. Any Pending Approval or Pending Review numbers?
- Check Customer Onboarding โ any new applications or form submissions since yesterday?
- Check your email for overnight notifications โ new orders, new applications, trade reference replies
- Action anything that needs a response before the business day starts
๐ When a New TruSim Order Comes In
- You receive an email notification with the order summary
- Click the โ Open Order link in the email, or go to TruSim Admin and find the order
- If status is โ Pending Verification โ check Fishbowl, then verify or mark as new
- If status is Submitted โ review the spec, approve when ready for production
๐ฅ When a New Customer Form Arrives
- You receive a notification at accounting@canwiltextiles.com and jaya@canwiltextiles.com
- Go to Customer Onboarding โ find the record
- Review: company info, payment method chosen, contacts, billing address
- Send CC auth form or wire instructions if applicable (buttons are in the record)
- Approve once payment is confirmed
๐ฆ Import Manager โ When a Shipment Arrives
- Open Import Manager โ find the container by BOL number or supplier name
- Upload the supplier invoice PDF โ AI extracts line items automatically
- Review and confirm extracted items, update quantities if needed
- Add landed costs (freight, drayage, broker fees)
- Run Allocate to POs โ system matches items to open Fishbowl POs using FIFO
- Download the Receiving Worksheet and hand to warehouse
๐ Full Order Status Flow
๐๏ธ Action Buttons in the Order Drawer
Click any order row to open the drawer. Action buttons appear once an order is Submitted:
| Button | What It Does | When to Use |
|---|---|---|
| โ Approve | Moves order to Approved status | After reviewing spec โ order is correct, ready for production |
| ๐ญ In Production | Marks as actively being manufactured | When the cut sheet goes to the production floor |
| ๐ฆ Mark Shipped | Marks as shipped, customer notified | When the order leaves the facility โ add tracking in notes |
| โ Mark Delivered | Final status, closes the order | When confirmed received by customer |
| โธ On Hold | Pauses the order | Payment issue, missing info, customer request |
| โ Cancel | Cancels the order permanently | Customer cancelled โ add reason in notes |
๐ What's in the Order Drawer
- Order number (TS-YYYYMMDD-XXXX) and submission timestamp
- Customer info โ name, company, email, phone
- Configuration โ product type, dimensions, fabric, attachment method, edge finishing
- Ship To (navy) โ delivery address
- Ship Notes (orange) โ any special instructions from the customer
- Signature โ customer's digital signature confirming specs
- Technical drawing โ live SVG spec sheet captured at order time
- Notes field โ internal production notes (not visible to customer)
๐ How to Verify
- Find the order with โ VERIFY badge in TruSim Admin
- Click the row to open the order drawer
- Look up the customer's company name and email in Fishbowl
- Choose one of the two verification actions (see below)
โ Found in Fishbowl โ Existing Customer
- Click "โ Verified โ Existing Customer" in the drawer
- Order automatically moves to Submitted
- Action buttons appear โ you can now approve, move to production, ship
- This customer is now flagged โ all future orders skip verification
๐ NOT Found โ New Customer
- Click "โ Not Found โ Treat as New"
- System emails the customer a link to complete their new account form
- Order status moves to Awaiting Form
- Wait for the customer to submit the form
- Review in Customer Onboarding โ approve when payment is confirmed
- Their pending order automatically moves to Submitted upon approval
๐ Reviewing an Application
- Go to Customer Onboarding from the nav or dashboard
- Click any customer row to open their record
- Review: company name, billing address, payment method, contact info
- Scroll down to see the Activity Log โ full timeline of emails sent, status changes, notes
- Check for any linked TruSim orders in the Linked Orders section
โ Approving a Customer
- Open the customer record
- Change Status to Approved
- Click Save
- Customer receives an approval email automatically
- Any pending TruSim orders automatically move to Submitted
- Customer's yellow access banner disappears on their next login
โ Denying a Customer
- Change Status to Denied and click Save
- System automatically cancels any pending TruSim orders
- Customer receives a standard denial email
- Contact the customer directly if you need to explain the decision
๐ณ Credit Card
- Customer selects Credit Card on their application form
- Open the record in Customer Onboarding
- Click Send CC Auth Form โ customer receives the authorization form by email
- Customer completes and returns form to accounting@canwiltextiles.com
- Once received and confirmed, approve the account
๐ฆ Wire / ACH
- Customer selects Wire on their form
- Click Send Wire Instructions in the record โ customer receives banking details by email
- Customer initiates payment
- Accounting confirms receipt
- Approve the account once wire is confirmed
๐ NET 30 (Trade Credit)
- Customer fills out three trade references on their application
- Reference request emails are sent automatically when they submit
- References reply by email or via the online reference form
- You receive a notification when each reference reply comes in
- Once two or more satisfactory references are received, approve the account
๐ What You Can See
- Quote name โ customer's label for the configuration
- Customer email โ who saved it
- Tab โ which configurator tab (Impact Screen, Sidewall Drape, Gap Filler)
- Dimensions โ width ร height
- Date saved
๐ Searching & Filtering
- Use the search bar to filter by customer email or quote name
- Use the tab filter (All / Impact Screen / Sidewall Drape / Gap Filler) to narrow by product type
๐ง Three Notification Lists
| List | When It Fires | Recommended Recipients |
|---|---|---|
| Access Request Notifications | When someone requests configurator access | Chase, Jaya |
| Order Submission Notifications | When a customer submits an order | Jaya, Nicole |
| Order Report Recipients | Full order email with direct link to open the order in admin | Jaya, Chase |
โ Adding or Removing Emails
- Type an email address in the field and press Enter or click Add
- Click ร next to any address to remove it
- Click Save Settings โ takes effect immediately
๐๏ธ Container Lifecycle
๐ ๏ธ Toolbar Buttons
| Button | What It Does |
|---|---|
| โป Refresh | Reload all containers and parts data from Firestore |
| ๐ Sync Logs | View history of nightly Fishbowl CSV imports โ timestamps, part counts, any errors |
| ๐ Import Invoice | Upload a supplier PDF invoice โ AI extracts all line items automatically |
| + New Container | Manually create a new container/shipment record |
๐ Search & Filter
- Search by container number, BOL number, or supplier name
- Filter by Status dropdown to see only active, in-transit, or closed containers
- Parts data (fabric codes, costs, roll widths) syncs nightly from Fishbowl at 6am
โก AI Invoice Extraction
- Open the container record or click ๐ Import Invoice from the toolbar
- Upload the supplier invoice PDF
- AI reads the PDF and extracts: part numbers, descriptions, quantities, unit prices, total amounts
- Review the extracted items โ they pre-fill the container line items
- Correct any misread values (fabric codes are the most common mismatch)
- Click Save to confirm the items
๐ After Extracting
- Verify quantities match the packing list
- Check that HTS codes are assigned (used for landed cost calculation)
- Add any line items the AI missed (handling charges, certificates, etc.)
- Proceed to add landed costs once line items are confirmed
๐ฆ Running an Allocation
- Open the container record โ confirm all line items are entered and quantities are correct
- Add all landed costs (ocean freight, drayage, broker fees, insurance) โ these get prorated by weight
- Click Allocate to POs
- System matches each fabric part to open Fishbowl POs using oldest-PO-first (FIFO)
- Review the allocation โ each PO shows quantity assigned and landed cost per yard
- Adjust if any PO assignments need to be split or reassigned
- Click Download Receiving Worksheet โ hand to warehouse for Fishbowl entry
๐ฐ Landed Cost Breakdown
- Ocean Freight โ prorated across all parts by gross weight
- Drayage โ trucking from port to warehouse, prorated by weight
- Broker Fees โ customs broker charges, prorated by declared value
- Insurance โ cargo insurance, prorated by value
โ Adding a New Staff Member
- Dashboard โ click ๐ User Management card (superadmin only)
- Fill in: Name, Email, Department, Role
- Check which cards they should see: Import Onboarding TruSim
- Click Save โ user is created immediately
- They sign in via Google (same email) or set a password via the login page
โ๏ธ Editing Access
- Find the staff member in the user list
- Click Edit
- Check or uncheck card access as needed
- Click Save โ takes effect on their next page load
๐๏ธ Removing a Staff Member
- Find them in the user list
- Click Remove
- They lose access immediately on their next page load
๐ฅ Emails You Receive
| Email Subject | Triggered By | Action Needed |
|---|---|---|
| New TruSim Access Request | Customer requested configurator access | Review + approve in Customer Onboarding |
| New TruSim Order โ TS-XXXXXX | Customer submitted an order | Open TruSim Admin โ verify customer |
| New Customer Application | Form submitted at /onboarding | Review in Customer Onboarding |
| Trade Reference Received | Reference submitted their reply | Review, count toward NET 30 approval |
| Onboarding Form Received | TruSim customer completed the new account form | Review + approve in Customer Onboarding |
๐ค Emails the System Sends to Customers
| When Sent | |
|---|---|
| Access request received | When a customer submits the access request form |
| Account approved | When you approve them in Customer Onboarding |
| New customer onboarding form | When you click "Not Found โ Treat as New" on their first order |
| CC Authorization Form | When you click Send CC Auth Form in the record |
| Wire Instructions | When you click Send Wire Instructions in the record |
| Trade reference request | Sent automatically to their references when they apply |
| Order status update | When order moves to Shipped or Delivered |
Order Stuck at Pending Verification
Check that the customer's email on the order exactly matches Fishbowl. If they are a real Canwil customer, click Verified โ Existing Customer. If you're unsure, check with Chase or Jaya before clicking.
Customer Didn't Get Their Email
Ask the customer to check spam. Emails come from accounting@canwiltextiles.com. If it's not in spam, contact Nik โ the Resend logs will show whether it was delivered.
Customer's Yellow Warning Banner Won't Go Away
They have a pending order or account status issue. Check TruSim Admin for their orders โ the order needs to reach Submitted status. If their onboarding was just approved, the banner disappears on their next login/refresh.
Staff Member Can't See a Card
Go to User Management โ Edit their account โ check the correct cards are enabled โ Save. Takes effect on their next page load.
Invoice AI Didn't Extract Correctly
Edit the line items manually after extraction โ change part numbers, quantities, and prices as needed. If the AI consistently misreads a supplier's invoice format, let Nik know so the prompt can be updated.
Parts Not Showing in Import Manager
Parts sync from Fishbowl nightly at 6am via CSV export. If you're seeing missing or outdated parts, check with Nik โ it's likely a Fishbowl export issue. Do not re-enter parts manually.
๐ Escalation Contacts
| Issue | Contact |
|---|---|
| System down, broken page, error message | Nik โ nik@canwiltextiles.com |
| Customer billing dispute or payment issue | Jaya โ jaya@canwiltextiles.com |
| Order status questions from customers | Chase or Nicole |
| Configurator access questions | Chase โ chase@canwiltextiles.com |
| Production floor questions | Alma |