Шаблон бэкенда CRM приложения
PHP — Схема, API и AI руководство

Ключевые выводы

Обзор

Приложения PHP и Laravel могут использовать Back4app в качестве бэкенда CRM без выполнения миграций или управления базой данных. Вызывайте REST конечные точки (GET /classes/Deal?where=..., POST /classes/Contact) с помощью Guzzle или cURL; отправляйте X-Parse-Session-Token после входа в систему.

Пять классов общие для всех клиентов. Ваш код PHP Parse обрабатывает JSON-ответы и сопоставляет их с вашим доменом; Back4app управляет хранением, аутентификацией и реальным временем. Добавляйте поля из панели управления или API, не трогая код схемы PHP.

Почему стоит создать ваш PHP CRM бэкенд с Back4app?

Back4app предоставляет PHP приложениям готовый CRM бэкенд, чтобы вы могли сосредоточиться на Laravel или вашем существующем стеке.

• •Интеграция REST: Используйте Guzzle или cURL для вызова Back4app REST конечных точек для Контакта, Компании, Сделки, Активности; код в стиле PSR и типовые подсказки.
• •Нет миграций базы данных: Схема хранится на Back4app; добавляйте поля из панели управления или API, не трогая ваш слой схемы PHP.
• •Гибкость развертывания: Запускайте ваше PHP приложение на любом хосте; Back4app обрабатывает аутентификацию, хранение и реальное время для CRM.

Идеально подходит для проектов Laravel или автономных проектов PHP, которым нужен управляемый CRM бекенд.

Основные преимущества

Готовый к производству CRM-бэкенд, чтобы вы могли быстрее разрабатывать и сосредоточиться на своем приложении.

Технический стек

Все, что поддерживает этот шаблон CRM-приложения, на одном взгляде.

ER диаграмма

Диаграмма «Сущность-связь» для модели данных CRM приложения PHP.

erDiagram
    _User {
        String objectId PK
        String username
        String email
        String password
        Date createdAt
        Date updatedAt
    }

    Company {
        String objectId PK
        String name
        String website
        String industry
        String address
        String notes
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Contact {
        String objectId PK
        String name
        String email
        String phone
        Pointer company FK
        String notes
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Deal {
        String objectId PK
        String title
        Number amount
        String stage
        Pointer contact FK
        Pointer company FK
        Date expectedCloseDate
        String notes
        Pointer assignedTo FK
        Date createdAt
        Date updatedAt
    }

    Activity {
        String objectId PK
        String type
        String subject
        String description
        Date dueDate
        Date completedAt
        Pointer relatedTo FK
        Pointer createdBy FK
        Date createdAt
        Date updatedAt
    }

    Company ||--o{ Contact : "has"
    Company ||--o{ Deal : "has"
    Contact ||--o{ Deal : "has"
    _User ||--o{ Deal : "assignedTo"
    _User ||--o{ Activity : "createdBy"
    Contact ||--o{ Activity : "relatedTo"
    Deal ||--o{ Activity : "relatedTo"
    _User ||--o{ Company : "createdBy"
    _User ||--o{ Contact : "createdBy"

Поток интеграции

Последовательность Auth-to-CRUD: как ваше PHP приложение взаимодействует с Back4app — вход в систему, затем запрос контактов и сделок, обновление воронки.

sequenceDiagram
  participant User
  participant App as PHP App
  participant Back4app as Back4app REST API

  User->>App: Login
  App->>Back4app: POST /login (username, password)
  Back4app-->>App: sessionToken
  App-->>User: Logged in

  User->>App: Load contacts and deals
  App->>Back4app: GET /classes/Deal or GET /classes/Contact (X-Parse-Session-Token)
  Back4app-->>App: results[]
  App-->>User: Show pipeline

  User->>App: Create deal or contact
  App->>Back4app: POST /classes/Deal or POST /classes/Contact
  Back4app-->>App: objectId, createdAt
  App-->>User: Updated list

Словарь данных

Полная справка по полям для каждого класса в схеме.

Безопасность и разрешения

Как владение, ACL и разрешения на уровне классов защищают данные в этой схеме CRM.

Схема (JSON)

Сырая определение схемы JSON — скопируйте и используйте в вашем Back4app приложении или импортируйте через API.

{
  "classes": [
    {
      "className": "Contact",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "name": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": false
        },
        "phone": {
          "type": "String",
          "required": false
        },
        "company": {
          "type": "Pointer",
          "targetClass": "Company",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Company",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "name": {
          "type": "String",
          "required": true
        },
        "website": {
          "type": "String",
          "required": false
        },
        "industry": {
          "type": "String",
          "required": false
        },
        "address": {
          "type": "String",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Deal",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "title": {
          "type": "String",
          "required": true
        },
        "amount": {
          "type": "Number",
          "required": false
        },
        "stage": {
          "type": "String",
          "required": false
        },
        "contact": {
          "type": "Pointer",
          "targetClass": "Contact",
          "required": false
        },
        "company": {
          "type": "Pointer",
          "targetClass": "Company",
          "required": false
        },
        "expectedCloseDate": {
          "type": "Date",
          "required": false
        },
        "notes": {
          "type": "String",
          "required": false
        },
        "assignedTo": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Activity",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "type": {
          "type": "String",
          "required": false
        },
        "subject": {
          "type": "String",
          "required": false
        },
        "description": {
          "type": "String",
          "required": false
        },
        "dueDate": {
          "type": "Date",
          "required": false
        },
        "completedAt": {
          "type": "Date",
          "required": false
        },
        "relatedTo": {
          "type": "Pointer",
          "required": false
        },
        "createdBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "_User",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "username": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "password": {
          "type": "String",
          "required": true
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    }
  ]
}

API Playground

Попробуйте REST и GraphQL конечные точки для схемы CRM. Ответы из приведенных выше примерных данных — учетная запись Back4app не требуется.

Использует ту же схему CRM (Контакт, Компания, Сделка, Активность), что и этот шаблон.

Пошаговая интеграция PHP

Подключитесь к вашему Back4app бэкенду из приложения PHP с использованием SDK Back4app PHP.

1. Шаг 1: Установите SDK Back4app PHP

   Добавьте SDK Back4app для вашего стека (например, npm, pubspec или менеджер пакетов).

   PHP

   Копировать

   1

   composer require guzzlehttp/guzzle

2. Шаг 2: Инициализируйте Back4app в вашем приложении

   Инициализируйте SDK Back4app при запуске приложения с вашим идентификатором приложения и URL-адресом сервера.

   PHP

   Копировать

   1

   2

   3

   4

   5

   // Initialize (e.g. bootstrap or config)
   $baseUrl = 'https://parseapi.back4app.com';
   $appId = getenv('PARSE_APP_ID');
   $restKey = getenv('PARSE_REST_KEY');
   $sessionToken = null; // set after login

3. Шаг 3: Запросите контакты и сделки

   Используйте SDK для получения объектов Контакта и Сделки; фильтруйте сделки по этапу для воронки.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   15

   16

   17

   18

   19

   20

   21

   22

   23

   24

   25

   // GET /classes/Deal or /classes/Contact
   function getDeals(string $baseUrl, string $appId, string $restKey, ?string $sessionToken, string $stage = 'qualified'): array {
       $client = new \GuzzleHttp\Client();
       $headers = [
           'X-Parse-Application-Id' => $appId,
           'X-Parse-REST-API-Key'   => $restKey,
           'Content-Type' => 'application/json',
       ];
       if ($sessionToken) $headers['X-Parse-Session-Token'] = $sessionToken;
       $res = $client->get($baseUrl . '/classes/Deal?where=' . urlencode(json_encode(['stage' => $stage])) . '&order=expectedCloseDate', ['headers' => $headers]);
       $body = json_decode($res->getBody()->getContents(), true);
       return $body['results'] ?? [];
   }
   function getContacts(string $baseUrl, string $appId, string $restKey, ?string $sessionToken): array {
       $client = new \GuzzleHttp\Client();
       $headers = [
           'X-Parse-Application-Id' => $appId,
           'X-Parse-REST-API-Key'   => $restKey,
           'Content-Type' => 'application/json',
       ];
       if ($sessionToken) $headers['X-Parse-Session-Token'] = $sessionToken;
       $res = $client->get($baseUrl . '/classes/Contact', ['headers' => $headers]);
       $body = json_decode($res->getBody()->getContents(), true);
       return $body['results'] ?? [];
   }

4. Шаг 4: Создайте контакт или сделку

   Создайте новый Контакт или Сделку с обязательными полями и указателями (компания, контакт, назначено), затем сохраните.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   15

   16

   17

   18

   19

   20

   21

   22

   23

   24

   25

   26

   27

   28

   29

   30

   // POST /classes/Deal or /classes/Contact
   function createDeal(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $title, string $stage = 'lead', ?float $amount = null): array {
       $client = new \GuzzleHttp\Client();
       $body = ['title' => $title, 'stage' => $stage];
       if ($amount !== null) $body['amount'] = $amount;
       $res = $client->post($baseUrl . '/classes/Deal', [
           'headers' => [
               'X-Parse-Application-Id' => $appId,
               'X-Parse-REST-API-Key'   => $restKey,
               'X-Parse-Session-Token'  => $sessionToken,
               'Content-Type' => 'application/json',
           ],
           'json' => $body,
       ]);
       return json_decode($res->getBody()->getContents(), true);
   }
   function createContact(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $name, ?string $email = null, ?string $phone = null): array {
       $client = new \GuzzleHttp\Client();
       $headers = [
           'X-Parse-Application-Id' => $appId,
           'X-Parse-REST-API-Key'   => $restKey,
           'X-Parse-Session-Token'  => $sessionToken,
           'Content-Type' => 'application/json',
       ];
       $body = ['name' => $name];
       if ($email !== null) $body['email'] = $email;
       if ($phone !== null) $body['phone'] = $phone;
       $res = $client->post($baseUrl . '/classes/Contact', ['headers' => $headers, 'json' => $body]);
       return json_decode($res->getBody()->getContents(), true);
   }

5. Шаг 5: Обновите стадию сделки и действия

   Обновите Deal.stage при перемещении в воронке; создайте и перечислите Activity по relatedTo.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   15

   16

   17

   18

   19

   20

   21

   22

   23

   // PUT /classes/Deal/{objectId} — update stage
   // DELETE /classes/Deal/{objectId}
   function updateDealStage(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $objectId, string $stage): void {
       $client = new \GuzzleHttp\Client();
       $client->put($baseUrl . '/classes/Deal/' . $objectId, [
           'headers' => [
               'X-Parse-Application-Id' => $appId,
               'X-Parse-REST-API-Key'   => $restKey,
               'X-Parse-Session-Token'  => $sessionToken,
               'Content-Type' => 'application/json',
           ],
           'json' => ['stage' => $stage],
       ]);
   }
   function deleteDeal(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $objectId): void {
       $client = new \GuzzleHttp\Client();
       $headers = [
           'X-Parse-Application-Id' => $appId,
           'X-Parse-REST-API-Key'   => $restKey,
           'X-Parse-Session-Token'  => $sessionToken,
       ];
       $client->delete($baseUrl . '/classes/Deal/' . $objectId, ['headers' => $headers]);
   }

Часто задаваемые вопросы

Распространенные вопросы о шаблоне бэкенда CRM приложения.