FixFlow Work Order Tracker

Open on Windows:
1. Double-click index.html, or open it in Chrome/Edge.
2. Your work orders save in that browser on that device.

Open on Android from your Windows computer:
1. Keep this whole folder together.
2. Right-click start-server.ps1 and choose Run with PowerShell.
3. On your Android phone, connect to the same Wi-Fi.
4. Open the Android URL shown in the PowerShell window.
5. In Chrome, use Add to Home screen if you want it to feel like an app.

Install as an app:
1. Host FixFlow online with HTTPS or run it on localhost.
2. Open FixFlow in Chrome, Edge, or Android Chrome.
3. Use the Install app button on the home screen, or use the browser menu and choose Install app / Add to Home screen.
4. FixFlow opens in its own app window with its own icon.
5. Once installed, FixFlow automatically hides its Install buttons on PC, phone, and tablet.

Completed work totals:
- The home page shows total labor hours from completed tickets.
- Parts count shows how many completed tickets required parts.
- Total cost shows the combined parts cost of completed tickets.

Desktop dashboard:
- Desktop users get a top-left tab dropdown for Home, Active, Completed, Parts, and permitted Admin/Clients pages.
- The home page shows active order totals, quote/outsource tracking, active technicians, SLA compliance, dispatch tracking, status charts, and technician insights.

Assignment email:
- The app saves the last logged-in desktop email on that device.
- New or reassigned tickets with an assignment email recipient open a ready-to-send email draft.
- FixFlow asks for permission before opening the desktop email app for an assignment message.
- The draft includes the saved desktop email so the recipient can see who assigned the ticket.
- Browser apps cannot silently send email; the desktop's email app must send the opened draft.

Parts Index:
- The home page includes a Full Parts Index button.
- Admin and Manager sessions can add, update, and remove parts from FixFlow Admin.
- The work-order Parts needed dropdown uses the shared Parts Index.
- Cleaning Supplies, Filters, HVAC Parts, Plumbing Parts, Electrical Parts, Hardware Parts, Paint and Patching, and other categories each have their own expandable dropdown.
- Admin and Managers must select the destination sub-tab/category when adding a new part.
- Work Area is not required when adding parts; the category/sub-tab controls where each part appears.

Clients and demo companies:
- Only Main Admin and Super Admin logins show and can open the Clients button.
- Three separate demo companies are included: Northstar Manufacturing, Harborview Properties, and Greenfield Health Center.
- Each company has separate work orders and Parts Index data.
- Each company card and company home page shows its fictional client/executive name.
- See MICROSERVICES-ARCHITECTURE.txt for the future service architecture.
- Company-specific demo credentials are listed in DEMO-CREDENTIALS.txt.
- Company and client names are hidden on the public login screen and only shown after authenticated login.

Apple installation:
- iPhone/iPad: Open the hosted FixFlow website in Safari, tap Share, then Add to Home Screen.
- Mac: Open the hosted website in Safari and choose File, then Add to Dock. Chrome also supports Install app.
- FixFlow supports Apple safe areas, standalone display, and an Apple home-screen icon.

Laptop installation:
- Windows laptop: Open in Edge or Chrome and choose Install app.
- MacBook: Use Safari Add to Dock or Chrome Install app.
- Chromebook: Open in Chrome and choose Install app.

Open from anywhere:
1. Upload this folder to Netlify, Vercel, GitHub Pages, or another static web host.
2. See DEPLOY-WEBSITE.txt for exact hosting steps.
3. Once hosted, FixFlow can be opened from Android, Windows, or any internet connection.

Cross-device cloud storage:
1. Create and connect a Supabase project.
2. See SUPABASE-SETUP.txt for the table, policies, and cloud-config.js setup.
3. After setup, work orders sync across devices using the same website.

Access monitoring:
- The login/home page identifies FixFlow as a product of Conrad van Deventer.
- FixFlow shows an alpha notice before the app opens.
- Users can give permission for weekly usage summary emails to vandeventer2016@gmail.com.
- The weekly summary counts app opens and reports the app host, browser timezone, locale, and last opened time.
- When Supabase is configured, consented access and installation events are recorded for the owner.
- Work-order create, edit, status change, delete, and import events are also recorded.
- Email updates can be sent to vandeventer2016@gmail.com by connecting notificationWebhookUrl in cloud-config.js to a private server-side email webhook.
- Optional approved-email restriction is controlled in cloud-config.js.
- Automatic email alerts require a Supabase webhook/Edge Function and an email provider. See SUPABASE-SETUP.txt.

FixFlow Admin:
- Cloud sync, cloud setup, and deployment tools are kept out of the installed main app.
- Open fixflow-admin.html separately to manage cloud sync and deployment.
- FixFlow Admin shares the same local data and cloud-config.js as the main FixFlow app.
- FixFlow Admin has its own install manifest and can be installed as a separate application.
- The three admin codes are listed in ADMIN-CODES.txt.
- Using an admin code on the main login page reveals the Admin button.
- Admin is hidden for normal logins and direct Admin access redirects to the main login.
- Main Admin codes must match their configured Main Admin email.
- Main Admins can generate email-linked Manager codes with limited user-management and log access.
- Conrad's protected FFADMIN-1994 Super Admin can change or remove other Main Admin access.
- Super Admin Reset access replaces the selected Main Admin's old login with a new email/admin ID and code.
- The Interactive Demo Administrator opens a blank sandbox with 24 priced demo parts and can view every Admin section but cannot change Admin settings, users, codes, access, cloud data, or parts.
- Only the protected FFADMIN-1994 Super Admin sees the Update online app button.
- Only the protected FFADMIN-1994 Super Admin sees the home-page mode switch for demo mode and regular mode.
- Update online app refreshes the installed app cache on that device.
- Update online app also calls the Vercel deploy function when VERCEL_DEPLOY_HOOK_URL is configured in Vercel.
- FixFlow update numbers count upward by replacing the trailing number, such as fixflow-2 becoming fixflow-3.
- Send update to all users publishes a cloud update notice. Online users and installed app users see a refresh prompt and can load the newest FixFlow version.
- The update notice requires the app_updates table from SUPABASE-SETUP.txt.
- For one-click Vercel deployment, add VERCEL_DEPLOY_HOOK_URL in Vercel Project Settings > Environment Variables. Do not put deploy tokens or hook secrets in browser files.

Normal-user registration:
- New users can register their own email and personal access code from the login page.
- Registered normal users can create, edit, complete, wait, and reopen tickets.
- Permanent ticket deletion is restricted to Main Admin and Manager sessions.

Remember login:
- Users can optionally remember their email and access code on the current device.
- Do not enable this option on shared or public devices.
- Admin and Clients navigation is only available to the protected FFADMIN-1994 Super Admin after the separate Admin vault code is entered.

Data:
- The app stores work orders in the browser using local storage.
- Use the download button to export a JSON backup.
- Use the upload button to import a backup on another device.
- Online hosting makes the app reachable from anywhere, but this no-server version still stores data per browser/device.
- Cloud storage makes work orders shared across browsers/devices once Supabase is configured.

Files:
- index.html is the app.
- styles.css controls layout for phone and desktop.
- app.js handles orders, search, filters, exports, and imports.
- fixflow-icon.svg and fixflow-icon.ico are the main app icons.
- fixflow-admin-icon.svg, fixflow-admin-icon-192.png, fixflow-admin-icon-512.png, and fixflow-admin-icon.ico are the black Super Admin/Admin app icons.
- fixflow-icon-192.png and fixflow-icon-512.png are install icons for Android and Windows.
- fixflow-apple-touch.png is the Apple iPhone/iPad/Mac icon.
- create-desktop-shortcut.ps1 creates the main FixFlow shortcut.
- create-admin-desktop-shortcut.ps1 creates the black-icon FixFlow Admin shortcut.
- manifest.webmanifest and sw.js support install/offline behavior when served over http://localhost or a local network.
- cloud-config.js connects FixFlow to Supabase cloud storage.