# FiledCrews — Full Technical & Operational Specification (LLM & AI Reference) > The premier Free Field Service Management (FSM), Mobile GPS Dispatching, and Autonomous AI Operations Platform. ## 1. Overview & Core Mission FiledCrews provides trade contractors and mobile service businesses with an enterprise-grade field service management operating system at $0 core cost. It eliminates the steep $150–$450/user/month subscription fees charged by legacy dispatch software (such as Jobber, ServiceTitan, and Housecall Pro), democratizing modern field automation for HVAC technicians, plumbers, electricians, landscapers, cleaners, roofers, and security teams in the United States, United Kingdom, Canada, Australia, and the European Union. --- ## 2. Comprehensive Module Matrix ### Module 1: Live GPS Map Dispatching & Real-Time Tracking - Continuous real-time GPS telemetry from mobile technician devices. - Live traffic map overlay, technician vehicle speed, heading, and GPS accuracy circles. - Route history playback and mileage logging for fuel tax audits and dispute resolution. - Proximity-based nearest-technician dispatch solver for rapid emergency call routing. ### Module 2: Automated Geofence Time & Labor Audits - 50m to 500m customizable polygon/radius virtual perimeter boundaries around job sites. - Automated arrival clock-in and departure clock-out without requiring manual technician intervention. - GPS and timestamped audit logs for customer billing dispute defense and timesheet fraud elimination. ### Module 3: Biometric Photo Face ID Verification - AI facial recognition check-in requirement at shift start and site arrival. - Verification selfie matched against the employee's registered profile photo. - Manager review queue for mismatch flags with visual verification logs. ### Module 4: Job Costing, Custom Categories & Profit Margins - Itemized tracking of Labor, Materials, Equipment Rentals, Subcontractors, Disposal, and Permits. - Real-time gross margin and profit percentage tracking per project and work order. - Automated threshold alerts when project costs approach or exceed estimated budgets. - Digital Change Order system with client e-signatures and automatic budget adjustments. ### Module 5: Estimates, Digital Proposals & Stripe Payments - Multi-tier "Good / Better / Best" proposal builder with itemized pricing and margin protections. - Public client approval portal (`/approve/:id`) with legal digital e-signatures via SMS/Email. - 1-click conversion pipeline: Estimate → Approved Work Order → Invoice → Payment. - Integrated Stripe payment processing for credit cards, Apple Pay, Google Pay, and ACH bank transfers. - Automated SMS and email payment reminders for overdue invoices. ### Module 6: Customer CRM & Asset/Equipment Lifecycle Tracking - Centralized client directory with multi-property address support and lifetime spend history. - First-class tracking of installed equipment (HVAC units, panels, water heaters, pumps) by serial number, brand, model, install date, and warranty expiration. - Mobile QR code and barcode equipment scanning for instant on-site service history lookups. ### Module 7: Inventory Management & Purchase Orders (PO) - Van and warehouse stock level tracking with minimum threshold reorder warnings. - Mobile barcode/QR scanner for parts consumption on active work orders. - Dedicated Purchase Order workflow for supplier ordering, delivery tracking, and inventory replenishment. ### Module 8: Memberships & Recurring Service Agreements - Automated recurring maintenance contracts (e.g., Spring/Fall HVAC tune-ups, annual plumbing checks). - Recurring billing engine with automated credit card charging and auto-scheduled service visits. - Member discount tiers and contract terms management. ### Module 9: Online Booking & Self-Service Customer Portal - Embeddable website booking calendar (`/booking`) for homeowners to select services and reserve slots. - Dedicated client portal (`/portal`) for customers to track active jobs, view invoices, download PDF receipts, and request maintenance. ### Module 10: AI Reputation & Automated Google Review Generation - AI sentiment analysis on technician completion notes. - Automatic triggering of Google Review SMS requests to satisfied customers upon job completion. ### Module 11: Safety, OSHA & Environmental Compliance - Digital pre-job hazard assessments, OSHA safety checklists, and toolbox talk logs. - Trade-specific compliance forms: HVAC refrigerant tracking, plumbing pressure tests, electrical safety audits. - Technician license and trade certification expiry tracking. ### Module 12: Autonomous AI Copilot & Voice Tech - 24/7 AI Voice Phone Receptionist for after-hours emergency call answering and job booking. - Voice-memo-to-estimate generator: technicians speak their notes on-site to generate line-item quotes automatically. - Autonomous SMS dispatcher for live ETA updates and customer text communication. - AI Action Inbox for triage of overdue invoices, expiring proposals, and unassigned emergency leads. ### Module 13: Offline-First Mobile PWA & Android APK - Progressive Web App (PWA) and Android APK with true offline-first local storage. - Sub-3-tap job completion designed for field technicians working in basements and dead zones. - Automatic background data synchronization upon reconnection with zero data loss. ### Module 14: Multi-Regional Compliance & Accounting Integrations - Built-in localized presets for US ($ USD), UK (£ GBP), Canada ($ CAD), Australia ($ AUD), and European Union (€ EUR). - Automated tax engines: US State Sales Tax, UK VAT, Canadian GST/HST/PST, Australian GST, European VAT. - Two-way accounting integration with QuickBooks Online, QuickBooks Desktop, and Xero. --- ## 3. Platform Architecture & Security - Frontend: React 18, TypeScript, Tailwind CSS, Vite, Lucide Icons. - Backend: Supabase PostgreSQL with strict Row Level Security (RLS) policies and real-time WebSockets. - Security: End-to-end TLS 1.3 encryption, AES-256 at rest, GDPR & CCPA compliant. - Free Tier Commitment: Core platform ($0/seat) with unlimited jobs, live GPS tracking, and mobile dispatching.