# Pest Control SaaS - Next.js Business Management Platform

A complete, production-grade **source-code package** for running a pest-control
service business: customers, scheduling, dispatch, field reports, billing, a
customer portal, and a REST API - all in one modern Next.js application.

This is a **source-code product**, not a hosted subscription. You receive the
full project source and run it on your own infrastructure (self-hosted), with
your own Stripe, email, storage, and database accounts.

**Live demo:** https://pest.blastek.net

---

## What you get

- The complete Next.js (App Router) application source code, written in
  TypeScript and organized into clear feature folders.
- Prisma schema with database migrations and a realistic demo-data seed so you
  can explore a fully populated workspace immediately.
- Buyer documentation: setup & installation, environment variables, Stripe
  setup, email (SES) setup, storage (S3) setup, deployment guide, production
  launch checklist, quickstart, and product reference docs.
- Docker and docker-compose files for a one-command local environment.
- `.env` examples for local, Docker, and production configurations.

## Tech stack

- **Framework:** Next.js (App Router) + React, TypeScript
- **UI:** MUI (Material UI) component library and MUI X Data Grid
- **Database/ORM:** PostgreSQL with Prisma (schema + migrations included)
- **Payments:** Stripe (subscriptions; optional Stripe Connect for customer
  payments)
- **Email:** Amazon SES (with a no-op provider for local development)
- **File storage:** Amazon S3 (with a local-disk provider for development)
- **Other:** i18next for translations/RTL, Zod for validation, Docker for local
  development

## Included documentation

- Quickstart and full setup & installation guide
- Environment variables reference
- Stripe setup guide
- Email (SES) setup guide
- File storage (S3) setup guide
- Deployment guide and production launch checklist
- Update & maintenance policy
- Product/feature reference docs

## Support scope

- Help with installation/setup questions and fixes for reproducible bugs in the
  delivered source, per the marketplace's support policy.
- Software updates are provided per the included update & maintenance policy.
- This product does not include a hosted service, uptime SLA, or done-for-you
  deployment.

## License & resale

- Sold under the marketplace license you select at checkout (Regular license for
  use in a single end product/project; Extended license, if offered, for
  broader commercial reuse).
- You may not resell or redistribute the source code itself as a competing
  product or template.
- The marketplace's standard licensing terms apply to this item.

- **CRM & service locations** - customers, multiple locations per customer,

  tags, notes, and a per-customer communication timeline.
- **Leads & estimates** - capture leads, build estimates with line items, send
  an approval link, and convert approved estimates into customers/jobs.
- **Jobs, scheduling & dispatch** - job lifecycle with statuses, a dispatch
  board with manual technician assignment and manual ordering, territories,
  table and calendar views, and a printable day sheet.
- **Visit reports & treatment records** - per-visit checklists, internal and
  customer-visible notes, photo/file attachments, and treatment records that
  capture target pest, product/material, quantity, method, and area treated.
- **Service agreements** - recurring service plans with frequency, renewal
  dates, autopay/auto-invoice flags, and status workflow.
- **Invoicing** - invoices with line items, paid/unpaid status, mark-as-paid,
  and an aging breakdown on the dashboard.
- **Customer portal** - passwordless (email link) access where customers view
  upcoming appointments, invoices, estimates, agreements, visible service
  reports, and can request service.
- **Billing (SaaS subscriptions)** - Stripe-powered plan tiers (monthly/yearly)
  for the workspace subscription, with an optional Stripe Connect path for
  collecting end-customer invoice payments.
- **REST API, API tokens & webhooks** - a versioned REST API, scoped API
  tokens, and outbound webhooks for job/invoice/estimate events.
- **Email automation** - email-only automation rules with delivery logs and
  editable email templates.
- **Reporting** - operational reports for jobs, revenue, renewals, estimates,
  treatments, and payments, with CSV export.
- **Data import** - preview-and-import CSV data.
- **Admin & security** - workspace-scoped multi-tenant data isolation, role and
  permission controls (owner/admin, dispatcher, technician), an audit log, and
  one-time secret reveal for tokens.
- **Internationalization & RTL** - multi-language UI with full right-to-left
  (RTL) support.

Node.js 22.x or newer
npm
PostgreSQL database
Prisma-compatible DATABASE_URL
Stripe account for billing configuration
Amazon SES or SMTP-compatible email service
S3-compatible storage for production file uploads
HTTPS domain for production deployment and APP_URL configuration
Basic knowledge of Node.js / Next.js deployment

Download and unzip the package, then follow the included buyer documentation.
Basic setup:

1. Copy the included .env example file.
2. Configure DATABASE_URL, APP_URL, session secrets, Stripe, email, and storage variables.
3. Run npm install.
4. Run npx prisma generate.
5. Run Prisma migrations.
6. Seed demo/admin data if required.
7. Start locally with the documented development command.
8. For production, build the app and deploy using the included Docker/deployment guidance.

The package includes source code, Prisma schema and migrations, environment examples, Docker/deployment examples, tests, and buyer setup documentation.