📖 AMS User Guide

1. Installation

System Requirements

Operating System	Windows 10 / 11 (64-bit)
RAM	4 GB minimum
Disk Space	500 MB free

Download

Get the latest release from the official download page:

• ⬇ Download Woven Model AMS (Google Drive)

Install via NSIS Installer

1. Download Woven Model AMS Setup.exe from the link above
2. Run the installer and follow the wizard
3. Choose installation directory (default: %LOCALAPPDATA%\Programs\woven-model-ams)
4. Check "Create desktop shortcut" and "Create Start Menu shortcut"
5. Launch AMS from the desktop icon or Start Menu

Portable (No Install)

1. Download the portable ZIP from the link above
2. Extract to any folder (e.g., C:\AMS or a USB drive)
3. Run Woven Model AMS.exe

2. First-Run Setup

1. On first launch, you'll see the Setup page.
2. Enter your desired Username and Password (minimum 8 characters).
3. Click "Create Admin Account".
4. You'll be redirected to the Login page.
5. Enter your credentials and click "Sign In".

If the Setup Page Doesn't Appear

If you see a login page but no admin account exists, you can bootstrap one:

node scripts/create-test-user.cjs

This creates an admin user: admin / admin123.

3. Navigation & Layout

The app has a sidebar on the left with navigation links. The main content area takes up the rest of the window.

Sidebar Menu

Page	Icon	Description
Dashboard	📊	KPI cards, charts, recent activity
Assets	📦	Asset list, search, CRUD
Employees	👥	Employee management
Departments	🏢	Department management
Locations	📍	Location management
Import	📥	Import from Excel/CSV
Reports	📄	Generate and export reports
History	🕐	Asset history & audit logs
Settings	⚙	Backup, users, system config
License	🛡	License key management

4. Managing Assets

Viewing Assets

The Assets page shows a table of all assets. You can:

• Search: by name, asset tag, serial number, or category
• Filter: by status (Available, Assigned, Maintenance, Retired, Lost, Decommissioned)
• Sort: click any column header to sort ascending/descending
• Paginate: use the page controls at the bottom

Creating an Asset

1. Click "+ Add Asset"
2. Fill in the form. Required fields: Name and Category.
3. Optional: Asset Tag, Serial Number, Purchase Date, Warranty Expiry, Purchase Price, Condition, Notes
4. Click "Create Asset"

Editing an Asset

1. Click on an asset row in the table, or click the edit icon
2. Modify any fields
3. Click "Update Asset"

Deleting an Asset

Click the trash icon on an asset row. Confirm the deletion. This action is permanent and removes the asset and its history.

Asset Detail Page

Clicking an asset opens its detail page, which shows:

• All asset fields (name, tag, serial, status, etc.)
• Assignment: Current assigned employee and location
• Attachments: Uploaded files (Professional/Enterprise only)
• Check-Out History: Record of who had this asset and when
• Full History: Every change made to this asset since creation

5. Employees & Departments

Employees

The Employees page lists all people in your organization who can be assigned assets.

• Add: Click "+ Add Employee" — fill in name, email, employee code, department
• Edit: Click an employee row to modify
• Search: by name, email, or employee code

Departments

Departments organize employees and track where assets are used.

• Add: "+ Add Department" — name and department code
• Edit: Click a department row

6. Locations

Locations represent physical places where assets are kept (offices, storage rooms, buildings).

• Add locations with a name and optional code
• Assign assets to locations when they're not checked out to an employee
• Useful for tracking assets across multiple sites

7. Importing Data

The Import page lets you bulk-load assets, employees, departments, or locations from spreadsheets.

Supported Formats

• Excel: .xlsx, .xls
• CSV: .csv

Import Workflow

1. Select Import Type: Assets, Employees, Departments, or Locations
2. Choose your file
3. The app reads the file and shows a column mapping preview
4. Map your spreadsheet columns to AMS fields using the dropdowns
5. Review the preview rows
6. Click "Import"

8. Barcodes & QR Codes

AMS generates barcode and QR code labels for any asset. Available in Professional and Enterprise editions.

Generating a Barcode/QR

1. Navigate to an asset's detail page
2. Click "Generate Barcode" or "Generate QR Code"
3. The code is generated from the asset's tag or ID
4. Print the label and affix it to the physical asset

Scanning

Use any smartphone camera or barcode scanner app to scan the QR code. It will display the asset's ID/tag for quick lookup.

9. Check-In / Check-Out

Track which employee currently has which asset with the check-in/check-out system. Professional and Enterprise only.

Check-Out an Asset

1. Go to the asset's detail page
2. Click "Check Out"
3. Select the employee receiving the asset
4. Optionally set a due date and add notes
5. Click "Confirm Check-Out"

Check-In an Asset

1. Go to the asset's detail page (or find it via Assets list)
2. Click "Check In"
3. Optionally add return notes or update the asset condition
4. Click "Confirm Check-In"

Viewing Check-Out History

Each asset's detail page shows its complete check-out history — who had it, when, and for how long.

10. Reports & Dashboard

Dashboard

The Dashboard provides an at-a-glance overview:

• KPI Cards: Total Assets, Assigned, Available, Maintenance
• Status Chart: Pie/bar chart of asset statuses
• Category Breakdown: Assets by category
• Recent Activity: Latest changes, check-outs, and audits

Reports Page

Generate detailed reports and export them:

• Full Inventory: All assets with filters
• Assigned Assets: Currently checked-out assets with employee details
• Warranty Tracking: Assets with upcoming or expired warranties
• Audit Summary: Activity summary by date range

Export Formats

Format	Available In
Excel (.xlsx)	All editions
CSV	All editions
PDF	Enterprise only

11. History & Audit Trail

Asset History

Every change to an asset is recorded:

• Field changes (old value → new value)
• Who made the change (username)
• When the change was made (timestamp)

View an asset's full history on its detail page under the "History" tab.

Audit Logs

The History page shows the global audit trail — every action in the system:

• Logins and logouts
• Asset creates, updates, deletes
• Check-outs and check-ins
• Imports and exports
• Settings changes

12. Settings & Backups

Auto Backup

The app automatically backs up the database:

• Interval: Every 24 hours (configurable)
• Location: %APPDATA%\woven-model-ams\Backups\
• Max retained: 10 backups (oldest auto-deleted)

Manual Backup

1. Go to Settings
2. In the Backup section, click "Create Backup"
3. The backup file is saved to the Backups folder

Restore from Backup

1. In Settings → Backup, select a backup from the list
2. Click "Restore"
3. Confirm — this replaces your current database with the backup

Session Timeout

Configure how long a user stays logged in before being automatically signed out. Default: 8 hours.

13. License Management

Viewing Your License

Go to the License page (shield icon in the sidebar). You'll see:

• Edition: Community, Professional, or Enterprise
• Status: Active, Expired, or Trial
• Expiry Date: When the license expires (if applicable)
• Feature Gates: Which features are enabled

Activating a License

1. Purchase a license from the Woven Model portal
2. Copy your license key
3. Go to License page in AMS
4. Paste the key and click "Activate"
5. The unlocked features take effect immediately — no restart required

Edition Comparison

Feature	Community	Professional	Enterprise
Max Assets	10	Unlimited	Unlimited
Barcode/QR	❌	✅	✅
Check-In/Out	❌	✅	✅
Attachments	❌	✅	✅
Audit History	❌	✅	✅
Auto Backups	❌	✅	✅
PDF Export	❌	❌	✅
Unlimited Users	❌	❌	✅

14. User Management

User Roles

Role	Permissions
Admin	Full access — all CRUD, user management, settings, backups, license
Manager	Manage assets, check-in/out, reports, imports. Cannot manage users or settings.
User	View and search only. Cannot create/delete assets or modify settings.
Technician	Technician-level access (support/repair workflow).
Auditor	Audit / read access — ideal for compliance reviews.
Read Only	View-only access across the application.

Adding Users (Admin only)

1. Go to Settings → Users (the panel is visible only to admins)
2. Click "+ Add User"
3. Enter username, full name, an optional email, choose a role, and set a password (minimum 8 characters)
4. Click "Create User" — the new user can sign in immediately and their role applies at login

User Limits by Edition

Edition	User Limit
Community	1 user (the initial admin)
Professional	10 users
Enterprise	Unlimited

When the limit is reached, adding another user returns: "Maximum of N user(s) reached for this edition. Upgrade to add more users."

Managing Users

User management APIs are admin-only. Admins can update a user's role, full name, email, active state (enable/disable an account), and reset a password. Always maintain at least one active admin account.