Introduction & Overview
Engineered for service contractors, field crews, and operational clarity.
Welcome to the official Guidis Tech CRM Documentation. Guidis Tech CRM is a high-performance multi-tenant operations platform built for field service businesses, forestry contractors, and specialty trades.
Core Capabilities
The CRM unites the entire job lifecycle into a seamless workflow:
Estimates & Bidding
Line-item pricing, automated taxes, discounts, and superceded change orders.
Digital Signature Links
Send 1-click links to customers with auto-converted signature uploads.
Dispatch Scheduler
Track jobs from Scheduled → En Route → In Progress → Completed.
Directus Media Library
Automated image uploads routed directly into Signatures & Completed Projects folders.
Key Workflows
- 1Create a Proposal
Build line items and dispatch a digital signing URL directly to your client via email or SMS.
- 2Customer Acceptance & Digital Signature
The client signs on their smartphone. The PNG signature is saved straight to the Signatures folder in Directus.
- 3Dispatch & En Route Alerts
Click "Notify Customer" when heading to the site to trigger automated SMS dispatch via n8n & Twilio.
- 4Completion Photos & Sign-off
Upload proof-of-work photos to mark the job complete. Photos auto-route to the Completed Projects folder.
System Architecture
Modern multi-tenant stack built with SvelteKit, Cloudflare Workers, and Directus CMS.
Guidis Tech CRM leverages an enterprise decoupled architecture designed for rapid responsiveness and extreme scalability.
Tech Stack Overview
| Layer | Technology | Description |
|---|---|---|
| Frontend UI | SvelteKit 5 + TailwindCSS | Ultra-fast client application deployed on Cloudflare Pages. |
| Headless Backend | Directus CMS 10/11 | PostgreSQL relational database with instant REST and GraphQL APIs. |
| Automation Engine | n8n Workflows | Webhook triggers for Twilio SMS, customer emails, and contract agreements. |
| Edge Workers | Cloudflare Workers | Serverless API proxies, OAuth token exchanges, and data erasure handlers. |
[META_JSON] structures within notes for total data durability.Roles & Permissions
Configuring access controls for administrators, field operators, and office managers.
Access control is managed via Directus System Roles. Each staff member is assigned permissions based on operational responsibility.
Role Matrix
- Administrator: Full read/write/delete access across all collections, financial settings, and API developer credentials.
- Dispatch & Operations Manager: Can manage estimates, modify jobs, update status lifecycles, and assign field operators.
- Field Operator / Crew Member: Mobile access to view assigned work orders, read site hazards, update status to In Progress, and upload jobsite photos.
Creating Line-Item Bids
Building itemized estimates with subtotal, tax rate, and discount calculations.
Estimates allow you to present professional proposals to clients with dynamic itemization.
Key Proposal Fields
{
"estimate_number": "EST-2026-0814",
"customer_id": 42,
"title": "Tree Removal & Forestry Mulching",
"line_items": [
{ "description": "Oak Tree Removal", "quantity": 1, "unit_price": 1200, "total": 1200 },
{ "description": "Stump Grinding", "quantity": 2, "unit_price": 250, "total": 500 }
],
"subtotal": 1700,
"tax_rate": 0.07,
"total_amount": 1819,
"status": "sent"
}Customer Digital Signatures
1-click customer signing links with auto-converted signature uploads.
Clients review and sign proposals via a mobile-friendly link (/signing/[estimateId]).
/api/estimates/[id]/sign. No internal folder names or CMS paths are exposed to the client browser.Signature Workflow
When a client draws their signature and clicks "Accept & Sign Proposal":
- The canvas signature is converted to a PNG file blob server-side.
- The PNG file is saved to
directus_filesand automatically assigned to the Signatures folder. - The generated File UUID is stored in
estimates.signature_image. - The estimate status automatically updates to
approved.
Revisions & Change Orders
Superceding existing estimates and maintaining versioned change histories.
When scope changes occur on approved projects, click "Revise & Create Change Order" in the estimate modal.
This automatically sets the existing estimate status to superceded and creates a draft copy ready for client review.
Work Order Details Modal
Centralized operational hub for dispatchers and field operators.
The Work Order Details modal displays customer contact information, property navigation links, line-item scope, assigned operators, and site safety warnings.
Job Status Lifecycle
Understanding status transitions and automated workflow triggers.
Job is set on the workweek calendar.
Crew is traveling. SMS sent to client.
Work is underway on site.
Photos uploaded & job closed.
Assigning Field Crew Operators
Smart typable operator tag selector with instant filtering.
In the Edit Job modal, type any crew member's name into the operator input field. Press Enter or click a suggested operator tag to assign them to the job.
Site Hazards & Access Codes
Highlighting safety warnings, gate codes, and utility locate confirmations.
Flag critical site safety items in the Edit Job modal (e.g. Overhead Power Lines, Unrestrained Pets, Septic Field). These warnings appear highlighted in red on the Work Order modal for field operators.
Capturing Proof of Work
Staging and uploading site photos before completing jobs.
Field crews can upload multiple jobsite photos directly from their smartphone camera. Photos preview instantly and save straight to Directus.
Directus Folder Routing
Automatic media organization into Signatures and Completed Projects folders.
All uploads from the CRM are automatically organized in your Directus File Library:
- Signatures Folder: Stores all customer proposal signature PNG images.
- Completed Projects Folder: Stores all proof-of-work jobsite photos uploaded upon job completion.
Twilio Customer SMS Rescue
Automated text messages for en route alerts and missed call recovery.
Clicking "Notify Customer" triggers an automated SMS: "Hey [Customer Name], our crew is on the way to your property!".
n8n Workflow Hooks
Connecting CRM events to external communication flows.
Event triggers dispatch payloads to n8n webhooks for automated email delivery and contract archiving.
Meta / Facebook Integration
Facebook Single Sign-On, Page DM syncing, and social post scheduling.
Connect your company Facebook Page to sync incoming DMs directly into your CRM communications hub and schedule social media posts.
Company Credentials & Tax
Managing business identity, default tax rates, and OAuth keys.
Configure company name, business phone, default tax percentages, and Google/Facebook developer credentials in Settings.
Audit Logging & GDPR Erasure
Tracking system activity and fulfilling customer data erasure requests.
Every action (create, update, delete) is logged in the CRM Audit Trail. Data deletion requests are fulfilled via our GDPR Self-Service Portal.