Home/Docs/Getting Started
Getting Started

Introduction & Overview

Engineered for service contractors, field crews, and operational clarity.

3 min read Updated 2026

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.

Pro Tip
Press Ctrl + K anywhere on this page to instantly search features, directus schema definitions, or status workflows.

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

  1. 1
    Create a Proposal

    Build line items and dispatch a digital signing URL directly to your client via email or SMS.

  2. 2
    Customer Acceptance & Digital Signature

    The client signs on their smartphone. The PNG signature is saved straight to the Signatures folder in Directus.

  3. 3
    Dispatch & En Route Alerts

    Click "Notify Customer" when heading to the site to trigger automated SMS dispatch via n8n & Twilio.

  4. 4
    Completion Photos & Sign-off

    Upload proof-of-work photos to mark the job complete. Photos auto-route to the Completed Projects folder.

Getting Started

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

LayerTechnologyDescription
Frontend UISvelteKit 5 + TailwindCSSUltra-fast client application deployed on Cloudflare Pages.
Headless BackendDirectus CMS 10/11PostgreSQL relational database with instant REST and GraphQL APIs.
Automation Enginen8n WorkflowsWebhook triggers for Twilio SMS, customer emails, and contract agreements.
Edge WorkersCloudflare WorkersServerless API proxies, OAuth token exchanges, and data erasure handlers.
Directus Storage Schema
Job scope items and operator assignments are stored both in relational fields and backed up in [META_JSON] structures within notes for total data durability.
Getting Started

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.
Proposals & Estimates

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 JSON Data Structure
{
  "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"
}
Proposals & Estimates

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]).

Server-Side Encapsulation
Signature processing and folder routing are executed server-side via /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":

  1. The canvas signature is converted to a PNG file blob server-side.
  2. The PNG file is saved to directus_files and automatically assigned to the Signatures folder.
  3. The generated File UUID is stored in estimates.signature_image.
  4. The estimate status automatically updates to approved.
Proposals & Estimates

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.

Jobs & Dispatch

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.

Jobs & Dispatch

Job Status Lifecycle

Understanding status transitions and automated workflow triggers.

Scheduled

Job is set on the workweek calendar.

En Route

Crew is traveling. SMS sent to client.

In Progress

Work is underway on site.

Completed

Photos uploaded & job closed.

Photo Requirement
The "Complete Job" button is disabled until at least one proof-of-work photo is uploaded in the Work Order modal.
Jobs & Dispatch

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.

Field Operations & Photos

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.

Field Operations & Photos

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.

Field Operations & Photos

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.
Automations & Integrations

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!".

Automations & Integrations

n8n Workflow Hooks

Connecting CRM events to external communication flows.

Event triggers dispatch payloads to n8n webhooks for automated email delivery and contract archiving.

Automations & Integrations

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.

Settings & Privacy

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.

Settings & Privacy

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.

ESC

Type to search Guidis Tech CRM guides, features & workflows...