v40.0 · Full Documentation

WIM — Watchmaking
Inventory Manager

A complete inventory, procurement, and production tracking system built specifically for watchmakers. Manage parts across multiple calibres, track orders, plan production, and sync across devices in real time.

👋Introduction

WIM is a Progressive Web App (PWA) — it runs entirely in your browser, works offline, and can be installed on any device like a native app. All data is stored locally in your browser's IndexedDB database and optionally synchronized to a cloud server you control.

ARCHITECTURE

PWA + PHP Sync

STORAGE

IndexedDB (Local)

VERSION

v40.0 — "Cloud Sync"

What WIM manages

• Parts inventory — every component for each calibre (movement), by location/box
• Procurement — suggested orders, order batches, delivery tracking with ETAs
• Production — target vs. made, can-make count, bottleneck detection, kit building
• Multi-movement — simultaneous management of multiple watch calibres (e.g. ETA 2824, Sellita SW200)
• Multi-user — role-based access for admin, orderers, and read-only staff
• Cloud sync — real-time sync to your own OVH/PHP server

Key concepts

🚀Quick Start

Get from zero to managing your first calibre in 10 minutes.

1

Open the app

Navigate to https://wim.tl-watchmaking.com in any modern browser. The app installs a service worker automatically for offline use. You can also install it as a PWA via your browser's "Add to Home Screen" or "Install App" option.

2

Create your first Movement

On the landing page, click + New Movement. Enter the calibre name (e.g. "ETA 2824-2"). Set your annual production target and click Create.

3

Set up Locations

Click into your movement, then go to View → Locations. Add each physical storage box or shelf (e.g. "Box 1", "Box 2", "Shelf A"). These become the columns in your inventory table.

4

Add Parts

Click + Add Part in the Inventory tab. Fill in the part name, reference number, quantity needed per watch, and optionally a photo. Repeat for all components of the calibre — or use Import from Excel to bulk-import.

5

Enter initial stock

Click the 📦 Receive button on any part, select "Unregistered Receive", choose the location, and enter your current stock. Repeat for each part and location.

6

Enable Cloud Sync (optional)

Go to the landing page → ☁️ Cloud Sync. Enter your server URL and token (see the Cloud Sync section). Your data will now sync automatically.

🗺️Navigation

https://wim.tl-watchmaking.com

📦 Inventory

🛒 Purchasing

🎯 Production

📊 Activity

🗑️ Written Off

📋 Stock Mgmt

👔 Executive

✅ Actions

← Back to Landing  |  ETA 2824-2  |  🔔 Alerts  |  ☁️ Sync: Synced ✓

Landing Page vs. Movement View

WIM has two levels of navigation:

• Landing page — overview of all movements, global stats, user management, cloud sync, and cross-movement tools
• Movement view — deep-dive into one calibre. Click any movement card on the landing to enter it. Use "← Back" (top-left) to return.

Tabs inside a Movement

📊Dashboard

The landing page dashboard gives you an instant health check across all calibres.

wim.tl-watchmaking.com — Landing

4

Movements

847

Total Parts

12

Activity Today

3

Critical Alerts

STOCK HEALTH

Stacked Bar Chart

LOW STOCK

Doughnut Chart

PRODUCTION

Progress vs Target

Dashboard Charts

• Stock Health by Movement — stacked bar chart showing OK / low / critical parts per calibre at a glance
• Low Stock Count — doughnut chart of how many parts are short per movement
• Production Progress — bar chart of Can Make vs. Annual Target per calibre

Duplicate Reference Detector

The dashboard automatically scans for part references shared across multiple calibres — useful for identifying shared supplier parts. Click any movement tag to navigate directly to that calibre.

Landing Page Actions

☁️ Cloud Sync 👥 Users ⚙️ Settings ⬇️ Backup ⬆️ Restore 📊 Export Excel 🔍 Ctrl+K Search

📦Inventory

The Inventory Table

Each row is one part. Columns are: Name · Reference · Kind · Image · Qty/Watch · [Location columns] · Total Stock · Actions.

STOCK COLOUR CODING

✅ OK — enough for remaining watches ⚠️ Low — below needed quantity 🔴 Critical — below 50% of needed

Stock thresholds are production-based — they auto-calculate from remaining watches × qty/watch, not arbitrary minimums.

Filters & Focus

Part Actions

Inline Stock Entry

In the Stock Management tab, double-click any stock cell to edit the quantity inline. You can also type arithmetic directly: type 12+33 and it will calculate to 45.

Receiving Stock

When clicking 📦 Receive on a part, two modes are available:

• From Pending Order — select an open order to partially or fully receive. Marks the order as received.
• Unregistered Receive — for walk-in deliveries or opening stock. Select location, quantity, and optionally a QC Hold status.

⚠️

QC Hold

Parts received into QC Hold are tracked but not counted toward production stock. Use this for parts awaiting quality inspection.

Part Fields (Edit Modal)

🛒Purchasing Hub

Manage the full order lifecycle: generate suggested orders, group them into batches, track pending deliveries, and record receipts.

Suggested Orders

WIM automatically calculates what needs to be ordered based on:

• Remaining watches to produce (target − made)
• Qty per watch × remaining watches = needed quantity
• Current stock (including compatible alternatives)
• Pending orders already placed
• A configurable alert horizon (default: 4 months ahead)

Parts below their needed quantity appear in the Suggested Orders list with a recommended order quantity.

Order Workflow

1

Review suggested orders

In Purchasing Hub → Suggested, review the auto-generated list. Adjust quantities as needed.

2

Add to Draft / Send

Select items, group into a batch (by supplier), add notes, and mark as "Sent to Supplier".

3

Track pending deliveries

Orders appear in the To Order / Pending list. Set an ETA date on each order. Overdue deliveries are highlighted in red.

4

Receive the delivery

When parts arrive, click 📦 Receive on the part, select "From Pending Order", choose the location, and confirm the quantity. The order status updates automatically.

Order Batch Export

Each order batch can be exported as:

📊 Excel (XLS) 📄 PDF

Quick Order

For ad-hoc orders, use the Quick Order panel: type a reference, set quantity, add notes, and place without going through the suggested list.

The "Covers" Column

In Stock Management, the Covers column shows stock ÷ qty/watch — i.e., how many watches this part alone could support. Color coded:

🟢 Covers ≥ remaining target 🟡 Covers < remaining target 🔴 Covers = 0

"Order By" Date

Calculated automatically: today + (remaining runout rate × stock days) − lead time. If the date is in the past or near, the cell turns red, signalling an urgent order.

🎯Production

Production Targets

Recording Production ("Making a Watch")

When a watch is completed:

1. Click ⌚ Make Watch in the Production tab
2. Select which location to deduct parts from
3. Optionally enter a serial number / batch note
4. Confirm — all parts are decremented, Made +1, activity logged

Undo Last Watch — reverses the last production entry (restores stock, decrements Made).

Can Make Count

The Can Make number is the maximum watches producible with current stock across all locations. It is limited by whichever part has the lowest coverage. Click "Can Make" to see the breakdown and which part is the bottleneck.

Kit Builder

For calibres assembled from sub-kits (e.g. a base plate kit with pre-installed jewels):

• Define an assembly with component parts and their quantities/ratios
• Assembled kits are counted separately ("Kits on Bench")
• When making a watch, choose "Kit on Bench" as the source — parts are deducted from the kit, not individual boxes

Production Forecast

The forecast section shows weeks of stock remaining for each critical part at your current production rate. Cards are colour-coded:

🔴 Under 4 weeks — order immediately 🟡 Under 8 weeks — plan order soon 🟢 8+ weeks — healthy

A summary line identifies the critical bottleneck — the part that will halt production soonest.

📍Locations & Storage

Creating Locations

Locations map to your physical storage (boxes, drawers, shelves). Each movement has its own set of locations — they're fully independent.

1. Inside a movement, click View → Locations
2. Click + Add Location
3. Enter a name (e.g. "Box 1 — Wheel Train"), optional description
4. Toggle Aftersales if parts in this location are reserved for repairs (excluded from production calculations)

💡

Naming tip

Use descriptive names like "Box 1 — Escapements" or "Shelf B — Mainsprings" to make the inventory table self-documenting.

Box Contents View

Click View → Box Contents to see all parts stored in a specific box, total units, and export the list to Excel — useful for physical stock counts.

The "On Bench" Location

A special virtual location for parts currently under assembly. It's separate from physical stock and is included in Can Make calculations. Use it to track parts pulled from boxes that haven't yet become completed watches.

Stock Transfers

To move stock between locations: use Edit Part to manually adjust location quantities. The system records the change in the activity log.

🔩Assemblies & Linked Parts

Assemblies

An assembly is a pre-built sub-unit containing multiple parts (e.g. a riveted pallet fork + pallet stones). When you have 10 assemblies in stock, WIM adds that to each component's stock count automatically.

1

Create an assembly

In a movement, click View → Assemblies → + New Assembly. Give it a name.

2

Add components

Add each part that goes into the assembly. Set the ratio (default 1:1, or e.g. 2 if one assembly contains 2 of this part).

3

Set assembly stock

Use Receive on the assembly entry to add assembled units to stock.

In the inventory table, linked parts are colour-coded: ■ green = this part, ■ blue = linked via assembly, ■ yellow = both.

Compatible Parts

Mark parts as compatible alternatives in the part editor (Compatible With field). WIM will pool compatible stock together when calculating coverage — so if you have 10 of Part A and 5 of compatible Part B, coverage shows 15.

Old / Superseded References

When a supplier changes a part number, add the old reference in Old Part Numbers. The app will find the part when searching by the old reference.

☁️Cloud Sync

WIM can sync your data to a PHP server you control. Multiple users on different devices see the same data in near real-time.

✅

Your server is already configured

The sync endpoint is live at https://wim.tl-watchmaking.com/wim-sync.php. Use the credentials below.

Your Sync Credentials

SYNC URL

https://wim.tl-watchmaking.com/wim-sync.php

SECRET TOKEN

Ask the administrator 

🔒

Keep this token private

Anyone with this token can read and overwrite all your inventory data. Do not share it publicly or commit it to a public repository.

Enabling Cloud Sync

1

Open Cloud Sync settings

On the landing page, click ☁️ Cloud Sync.

2

Enter URL and Token

Paste the Sync URL and Secret Token from above. Click Save.

3

Test the connection

Click Test Connection. You should see a green confirmation with server diagnostics (PHP version, disk writable, current version number).

4

Enable sync

Toggle Enable Cloud Sync to ON. The app will now auto-sync every 5 seconds when online.

How Sync Works

Presence Indicators

When multiple users are connected, you'll see avatar bubbles near the sync indicator. Each avatar shows initials and role colour:

🔴 Admin 🟡 Orderer 🟢 Standard user

A user is shown as online if they've sent a heartbeat within the last 30 seconds.

Server Files

🖥️

First time setting up a server?

See the Server Setup & Deployment section for full step-by-step instructions — OVH Manager, Cyberduck, file structure, permissions, and troubleshooting.

After Updating Files — Clear Cache

After uploading new JS files to the server, run this in the browser console (F12) to force a fresh load:

(async () => {

  const regs = await navigator.serviceWorker.getRegistrations();

  for (const r of regs) await r.unregister();

  const keys = await caches.keys();

  for (const k of keys) await caches.delete(k);

  location.reload(true);

})();

💻Using WIM as a Standalone App

WIM works entirely without a server. In standalone mode, all your data lives in your browser — no internet connection required once the app is loaded, no account needed, no subscription.

How data is stored

All inventory data is saved in your browser's IndexedDB — a built-in, persistent, structured database that browsers provide for web apps. Unlike cookies or localStorage, IndexedDB has virtually no size limit and survives browser restarts.

• Data is stored per browser, per device — Chrome on your laptop and Chrome on your desktop are two separate databases
• Data persists across browser restarts, sleep, and restarts
• Data is not sent anywhere unless you explicitly enable Cloud Sync
• Storage location: managed by the browser internally — you cannot browse to a folder and see a file

⚠️

Clearing browser data will erase WIM data

If you use your browser's "Clear site data", "Clear browsing data", or reset the browser, your IndexedDB is wiped.

Always keep a regular JSON backup

(Landing page → Backup). Without Cloud Sync, this is your only recovery option.

Installing WIM as a desktop app (PWA)

You can install WIM on your computer or phone so it opens like a native app — its own window, its own icon, no browser chrome.

1

Open WIM in Chrome or Edge

Navigate to https://wim.tl-watchmaking.com.

2

Look for the install icon

In Chrome: click the ⊕ icon in the address bar (right side). In Edge: click the … menu → Apps → Install this site as an app.

3

Confirm installation

Click Install. WIM appears in your Start menu / Applications folder and opens in its own window. The data store is shared between the installed app and the browser tab.

4

On mobile (iOS / Android)

Safari on iPhone: tap Share → Add to Home Screen. Chrome on Android: tap ⋮ → Add to Home Screen. The app installs with a full-screen icon.

Offline use

Once WIM has been loaded at least once, the service worker caches all app files. After that:

• The app works fully offline — open it without any internet connection
• All edits are saved locally in real time
• When internet returns, Cloud Sync (if enabled) will push changes automatically
• If Cloud Sync is not enabled, the app stays local indefinitely

Moving data to another device (standalone)

Since IndexedDB is browser-local, moving to a new computer requires a manual transfer:

1

On the old device

Landing page → ⬇️ Backup → save the wim-backup-[date].json file (e.g. to a USB drive or email it to yourself).

2

On the new device

Open WIM → Landing page → ⬆️ Restore → select the backup file. All data loads instantly.

Recommended backup schedule

💡

Standalone vs. Cloud Sync

Standalone is perfect for a single user on one main device. If you want multiple people to see the same data, or want your phone and laptop in sync, enable Cloud Sync — your data stays in IndexedDB locally, and the server acts as a shared relay.

🖥️Server Setup & Deployment

This section covers deploying WIM to a web server so it's accessible from any browser on any device. You need this to use Cloud Sync or to share the app with team members. The instructions below are specific to OVH shared hosting and Cyberduck FTP client.

What you need

• An OVH web hosting plan (or any PHP 7.4+ shared host)
• Cyberduck — free FTP client (cyberduck.io)
• The WIM project files from your computer

Step 1 — Get your FTP credentials from OVH

1

Log into OVH Manager

Go to manager.ovhcloud.com and sign in.

2

Find your hosting

Left menu: Web Cloud → Hosting plans → click your plan name.

3

Go to FTP-SSH tab

Click the FTP-SSH tab. Note down: FTP server (e.g. ftp.cluster0XX.hosting.ovh.net), Login (your FTP username), and FTP directory (usually / or /www/).

4

Get your password

If you don't remember it, click Create or change the password on the FTP-SSH tab to set a new one.

Step 2 — Set up a subdomain (optional but recommended)

A dedicated subdomain like wim.yourdomain.com keeps WIM separate from your main website.

1. In OVH Manager: Web Cloud → Hosting plans → your plan → Multisite
2. Click Add a domain or subdomain
3. Enter the subdomain (e.g. wim) and set its root folder (e.g. /wim)
4. Enable SSL/HTTPS (free Let's Encrypt certificate)
5. Click Confirm — DNS propagation takes a few minutes

Step 3 — Connect Cyberduck to OVH

1

Open a new connection

In Cyberduck, click Open Connection (top left).

2

Fill in the connection details

• Protocol: FTP (File Transfer Protocol)
• Server: your OVH FTP server address (from Step 1)
• Port: 21
• Username: your FTP login
• Password: your FTP password

3

Click Connect

Cyberduck connects and shows your remote file tree. Navigate to the folder for your subdomain (e.g. /wim/).

4

Show hidden files

In Cyberduck menu: View → Show Hidden Files. This makes .htaccess visible — you need this to upload it.

Step 4 — Upload the project files

Your server folder structure must look exactly like this:

/wim/  (subdomain root)

  ├── index.html

  ├── sw.js  (service worker)

  ├── manifest.json  (PWA manifest)

  ├── wim-sync.php  (cloud sync endpoint)

  ├── .htaccess  (protects .json files)

  ├── css/

  │   └── styles.css

  └── js/

      ├── app.js

      ├── ui_components.js

      ├── store.js

      ├── utils.js

      ├── data_models.js

      └── features/

          ├── inventory.js

          ├── orders.js

          ├── production.js

          ├── history.js

          └── imports.js

Select all files from your local wim_modular/ folder and drag them into Cyberduck. Confirm any overwrite prompts.

Step 5 — Set directory permissions

The PHP sync script needs write access to the folder to create the data JSON files.

1. Right-click the /wim/ folder in Cyberduck → Info
2. Click the Permissions tab
3. Set to 755 (owner: read/write/execute, group+others: read/execute)
4. Check Apply to enclosed items if available

Step 6 — Verify everything works

Troubleshooting

👥Users & Permissions

WIM has a full login system with username + password authentication. Each person has their own account; all actions in the activity log are attributed to their name. Access is controlled by role.

The Login Screen

When you open WIM, a login screen appears before any data is shown. Enter your username and password, then click Login. Alternatively, click Continue as Guest for read-only access with no credentials required.

SESSION BEHAVIOUR

• Sessions are stored in sessionStorage — they survive page refreshes but are cleared when you close the browser tab or window
• You will need to log in again each time you open a new browser session
• No credentials are stored in localStorage or cookies — they live only in the active tab

Roles

ADMIN

Full access to everything — manage users, settings, delete data, view the full activity log and the Executive tab.

USER / ORDERER

Can create orders, receive stock, edit parts, and record production. Cannot manage users or access admin settings.

VIEWER / GUEST

Read-only view of inventory and orders. Can browse, filter, and search — cannot modify any data.

Credentials

Passwords are managed by the app administrator. If you don't know your credentials or need an account created, contact:

📧

Tristan Ledard — WIM Administrator

tristan.ledard@tl-watchmaking.com

Adding a new user

1

Go to the landing page → 👥 Users

You must be logged in as Admin. Click the Users button in the top toolbar.

2

Click + Add User

Enter the username (lowercase, no spaces — e.g. marc) and select their role.

3

Tell them their password

Their password is set by the administrator. Contact tristan.ledard@tl-watchmaking.com to request or communicate credentials — passwords are never displayed in the app.

4

First login creates the account

The first time they log in, if their username isn't in the database yet, WIM prompts to confirm account creation. They click Yes and their profile is saved.

Guest access

The Continue as Guest button on the login screen grants immediate read-only access with no credentials. Use this to let visitors browse the inventory without an account. Guests can see all parts and orders but cannot edit anything, place orders, or export data.

Permission Matrix

Admin lockout recovery

If the sole admin account is accidentally misconfigured, WIM tracks the last admin login date. After 30 days without any admin login, the system allows recovery on the next login attempt. Alternatively, restore a JSON backup from before the change was made.

📤Import & Export

Export

Import Parts (Bulk)

To add many parts at once from an Excel spreadsheet:

1. Go to View → Import in a movement
2. Download the template (shows expected column headers)
3. Fill in your parts data
4. Upload the file — parts are created automatically

Required columns: Name, Reference. Optional: Qty/Watch, Neutres, Notes, Compatible With, Old Part Numbers, Lead Time.

BOM Update (Bulk Metadata Edit)

To update existing part metadata from a spreadsheet (without touching stock):

1. Go to View → BOM Update
2. Upload an Excel file with updated part data
3. Preview the diff — WIM shows exactly what will change
4. Apply — non-destructive update (stock counts unchanged)

Restore from Backup

On the landing page → Restore → upload a previously downloaded JSON backup. This replaces the entire database.

⚠️

Restore is destructive

Restoring from a backup replaces all current data. Always download a fresh backup before restoring.

🔔Alerts & Monitoring

How Alerts Work

WIM continuously monitors stock versus production needs and surfaces shortages. Alerts are production-based — they factor in your remaining target, not arbitrary minimums.

ALERT CALCULATION

Alert horizon = 4 months (configurable)

Watches in horizon = remaining target × (horizon / 12)

Needed stock = watches in horizon × qty per watch

Shortage = max(0, needed_stock − current_stock − pending_orders)

Alert Levels

Silencing Alerts

Per-part alerts can be deactivated in the part editor. Useful for discontinued parts or parts with alternative supply paths not tracked in WIM.

Critical Alerts Modal

Click 🔔 Critical Alerts (bell icon, top right) to see a consolidated list of all critical shortages across all movements — a quick health check before placing orders.

Configuring Alert Horizon

Go to ⚙️ Settings (Admin) → adjust Alert Horizon (in months). A 4-month horizon means: "alert me if I'll run out within 4 months at current production rate".

🏥Health Check

The Health Check scans your database for integrity issues and flags anything that needs attention.

What it checks

• Parts with missing references
• Orphaned location references (location deleted but stock still assigned)
• Assembly components referencing non-existent parts
• Duplicate references within the same movement
• Duplicate references across movements (Duplicate Reference Detector)
• Parts with zero qty/watch but non-zero stock
• Negative stock values

Run it from the landing page → movement card menu → Health Check. Issues are listed with severity and a description. Some can be auto-repaired; others require manual review.

📋Activity Log

Every action in WIM is logged with timestamp, user, and details. Admins see the full log; standard users see the last 20 entries.

Activity Types

Filters

Filter the log by: Activity type · Username · Date. Use Clear Filters to reset.

⌨️Keyboard Shortcuts

Global Search (Ctrl+K)

The global search finds parts across all movements simultaneously. Results show part name, movement, reference, live stock status, and a thumbnail. Click any result to navigate directly to that part in its movement.

📖Field Reference

Complete reference of all data fields tracked per part.

WIM — Watchmaking Inventory Manager v40.0  ·  Built with Claude AI

Manual generated March 2026  ·  wim.tl-watchmaking.com