README: refresh to current product surface; retire direct-DB migration guide

Overview and plugin list cover all twelve plugins (geenforce, network
subnets, measuring tools, warranty, USB); naming examples use living
tables/columns instead of retired pctypes/isvnc; API params match the
implementation (perpage, dir, assettype); import section points at the
IMPORT-API surface and the wjf reference loader. DATA_MIGRATION_GUIDE
is now a pointer stub (its direct-DB approach is superseded).

README.md

@@ -7,14 +7,20 @@ A modern rewrite of the classic ASP/VBScript ShopDB application using Flask (Pyt
 ShopDB tracks and manages:
 - **Machines** - CNC equipment, CMMs, inspection systems, etc.
 - **PCs** - Shopfloor computers, engineering workstations
-- **Printers** - Network printers with Zabbix integration
-- **Applications** - Software deployed across the shop floor
+- **Printers** - Network printers with Zabbix supply integration
+- **Network devices** - Switches, routers, and the subnet browser
+- **Measuring tools** - Gage-lab instruments with calibration tracking
+- **Applications** - Software deployed across the shop floor, with per-PC install tracking
+- **Employees** - Directory, recognition and training notifications
+- **Warranties** - Coverage records with Dell warranty lookups
+- **USB devices** - CMMC check-in/out tracking
 - **Knowledge Base** - Documentation and troubleshooting guides
+- **GE-Enforce manifests** - Imaging/software manifest editing and fleet compliance
 
 ## Tech Stack
 
 **Backend:**
-- Python 3.x with Flask
+- Python 3.12 with Flask
 - SQLAlchemy ORM
 - MySQL 5.7+ database (5.6 works with extra utf8mb4 config; see docs/DEPLOY.md)
 - JWT authentication
@@ -59,13 +65,13 @@ To maintain consistency with the legacy ShopDB database and codebase, the follow
 ### Database
 
 - **Table names:** Lowercase, single word, no underscores or dashes
-  - Examples: `machines`, `pctypes`, `machinetypes`, `businessunits`
+  - Examples: `assets`, `computers`, `printers`, `businessunits`
 - **Column names:** Lowercase, single word, no underscores or dashes
-  - Examples: `machineid`, `machinenumber`, `pctypeid`, `isactive`, `createddate`
+  - Examples: `assetid`, `assetnumber`, `hostname`, `isactive`, `createddate`
 - **Foreign keys:** Referenced table name + `id`
-  - Examples: `locationid`, `vendorid`, `modelnumberid`, `pctypeid`
+  - Examples: `locationid`, `vendorid`, `modelnumberid`, `computertypeid`
 - **Boolean columns:** Prefixed with `is` or `has`
-  - Examples: `isactive`, `isshopfloor`, `isvnc`, `iswinrm`, `islicenced`
+  - Examples: `isactive`, `isshopfloor`, `iscolor`, `isdhcp`, `islicenced`
 
 ### Code
 
@@ -77,9 +83,9 @@ To maintain consistency with the legacy ShopDB database and codebase, the follow
 ### API
 
 - **Endpoints:** Lowercase, plural nouns
-  - Examples: `/api/machines`, `/api/pctypes`, `/api/locations`
+  - Examples: `/api/machines`, `/api/computers`, `/api/locations`
 - **Query parameters:** Lowercase, single word
-  - Examples: `?type=pc`, `?locationid=5`, `?isactive=true`
+  - Examples: `?locationid=5`, `?isactive=true`, `?assettype=computer`
 
 ## Style Guidelines
 
@@ -92,7 +98,7 @@ To maintain consistency with the legacy ShopDB database and codebase, the follow
 
 ### Prerequisites
 
-- Python 3.8+
+- Python 3.12
 - Node.js 18+
 - MySQL 5.7+ (5.6 works with extra utf8mb4 config; see docs/DEPLOY.md)
 
@@ -158,12 +164,10 @@ npm run build        # production build into frontend/dist (served by Flask)
 Complete first-run setup at `/setup`, or run `flask seed admin` for a headless
 admin account.
 
-To import data from the legacy ShopDB MySQL database (one-time, see
-`migrations/DATA_MIGRATION_GUIDE.md`):
-
-```bash
-python scripts/import_from_mysql.py
-```
+To import a site's legacy data, use the HTTP import surface: an admin API
+token plus [docs/IMPORT-API.md](docs/IMPORT-API.md) drive the whole migration
+through documented endpoints (`X-Import-Mode` preserves original timestamps).
+`scripts/site_imports/wjf/` is the West Jefferson reference loader.
 
 For the full per-site deployment runbook see [docs/DEPLOY.md](docs/DEPLOY.md);
 for every environment variable and Setting key see [docs/CONFIG.md](docs/CONFIG.md).
@@ -192,31 +196,36 @@ The REST API follows standard conventions:
 | PUT | `/api/machines/:id` | Update machine |
 | DELETE | `/api/machines/:id` | Soft delete machine |
 
+Each asset plugin exposes the same CRUD pattern on its own prefix
+(`/api/computers`, `/api/printers`, `/api/network`, `/api/measuringtools`),
+and cross-cutting asset endpoints live under `/api/assets`.
+
 Query parameters for list endpoints:
 - `page` - Page number (default: 1)
-- `per_page` - Items per page (default: 25)
+- `perpage` - Items per page
 - `sort` - Sort field
-- `order` - Sort direction (asc/desc)
+- `dir` - Sort direction (asc/desc)
 - `search` - Search term
-- `type` - Filter by asset type (computer, printer, machine, network_device)
+- `assettype` - Filter by asset type (computer, printer, machine, networkdevice, measuringtool)
 
 ## Plugin System
 
 ShopDB supports plugins for extending functionality. See `CONTRIBUTING.md` for plugin development guidelines.
 
-The image bundles eleven plugins; only the ones a site installs are loaded:
+The image bundles twelve plugins; only the ones a site installs are loaded:
 
-- **computers** - Shopfloor PCs and workstations
+- **computers** - Shopfloor PCs and workstations, collector fleet ingest
 - **employees** - Employee directory
+- **geenforce** - GE-Enforce imaging/software manifests and fleet compliance
 - **machines** - CNC, CMM, and other shop-floor machines
 - **measuringtools** - Gage-lab instruments with calibration tracking
 - **knowledgebase** - Documentation and troubleshooting guides
-- **network** - Network devices
+- **network** - Network devices and subnets
 - **notifications** - Shopfloor notifications and recognition feed
 - **printers** - Extended printer management with Zabbix integration
 - **slides** - TV/kiosk slideshows
 - **usb** - CMMC USB check-in/out tracking
-- **warranty** - Dell warranty lookups
+- **warranty** - Warranty records with Dell lookups
 
 ## Legacy Migration