STOREKEEPER

FI-094 · v3.0

STOREKEEPER is a local-first field instrument for project Bills of Materials, internal inventory, allocation, purchasing, receiving, kitting, fabrication, portfolio planning, reporting, and project material closeout.

Version 3.0 is the cumulative mature release. It retains the complete v1.0 through v2.9 feature set and concentrates the daily workflow into a clearer command center without removing advanced controls.

Run

Open storekeeper.html in a modern desktop browser. No server, account, package manager, build process, external database, subscription, or internet connection is required for core operation.

The workspace is stored locally using IndexedDB with a localStorage fallback. Use Workspace → Export Full Workspace Backup regularly.

Stamper tools

STOREKEEPER accepts output from:

• BOM-Line Stamper: https://github.com/mbparks/msBOMStamper
• McMaster Stamper: https://github.com/mbparks/msMCStamper

Supported inputs include BOM CSV, Stamper Job JSON, legacy TALLY-compatible job JSON, McMaster shopping-list text, generic mapped CSV, pasted spreadsheet rows, STOREKEEPER project JSON, complete workspace JSON, and STOREKEEPER handoff envelopes.

Every BOM import passes through review before project records change. Original source records and provenance metadata remain attached.

What is new in v3.0

Project Command Center

The Projects overview is now a daily material command center showing:

• BUILD COVERAGE and underlying ready-line counts
• The next best action for the active project
• Uncovered lines
• Open purchase records
• Due-date risks
• Workspace health
• A six-stage project journey
• Common import, allocation, purchasing, and closeout actions
• Current exceptions and recent project activity

Easy Mode project journey

Easy Mode follows six visible stages:

1. Project
2. Import
3. Review
4. Match & Allocate
5. Order & Receive
6. Build & Close

Advanced Mode retains all detailed workbenches, lots, locations, price breaks, allocation strategies, report tools, audit features, portfolio planning, and integrations. Switching modes never changes or removes data.

Project Closeout Workbench

The Closeout tab identifies:

• Unused reservations
• Open purchase records
• Uncovered required material
• Unmatched BOM lines
• Incomplete fabricated items
• Manual total overrides
• Substitutions and alternates
• Issued material
• Returned material
• Recorded scrap

Closeout actions can release reservations, resolve open purchasing records, capture a final BOM snapshot, export a closeout package, and complete the project while preserving accepted exceptions. Reopening a project does not erase the prior closeout record or final BOM snapshot.

Acceptance Center

Reports → Acceptance runs forty isolated functional checks based on the original STOREKEEPER acceptance specification. The suite covers stamper formats, BOM editing, duplicate handling, matching, stock separation, reservations, purchasing calculations, receiving, issuing, returns, exports, reset behavior, provenance, safety controls, and STOREKEEPER branding.

The tests use an in-memory fixture and do not alter project inventory.

Navigation and accessibility

Version 3.0 adds:

• Command palette with project and action search
• Ctrl or Command + K shortcut
• Keyboard shortcuts for major modules
• Collapsible navigation and inspector
• Skip-to-workspace link
• Live announcements for status messages
• Reduced-motion support
• Strong visible focus states
• Mobile bottom navigation
• Mobile navigation and inspector drawers
• Responsive command center, closeout, and acceptance views

Keyboard shortcuts

• Ctrl/Command + K: command palette
• N: new empty project
• I: import stamper file
• B: BOM
• V: Inventory
• P: Purchasing
• R: Reports
• ?: shortcut guide
• Esc: close a dialog or mobile drawer

Complete workflow

Project → Import or Enter → Review → Match Inventory → Allocate → Order → Receive → Issue to Build → Close Out

STOREKEEPER keeps vendor-reported stock completely separate from internal on-hand, reserved, incoming, and available quantities.

Reset behavior

• New Empty Project creates an empty project and resets project-specific workflow state without deleting inventory or other projects.
• Clear Sample Data removes only sample-marked records.
• Clear All Local Data removes the complete workspace only after a backup offer and explicit confirmation.

Backward compatibility

Version 3.0 uses workspace schema version 6.

It migrates schema-version-5 and earlier workspaces by adding project closeout records, final BOM snapshots, acceptance-test history, command and layout settings, and v3.0 interface state without discarding existing projects, BOM lines, inventory, lots, locations, reservations, purchases, transactions, imports, planning data, cost records, fabricated-item plans, portfolio scenarios, reports, recovery snapshots, audit records, or integration settings.

Package contents

• storekeeper.html — complete standalone application
• README.md — operating and release overview
• CHANGELOG.md — cumulative v3.0 changes
• VALIDATION.md — test details and limitations
• ACCEPTANCE-RESULTS.json — machine-readable 40-test result
• samples/ — current stamper and generic import examples

Data ownership

STOREKEEPER is local-first. Core data remains in the browser profile unless the user exports, shares, or explicitly invokes an optional sync action.