GraphQL Шаблон

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

Q: Что такое Back4app?

Back4app является бэкендом для CRM-приложений. Для GraphQL вы получаете типизированную схему и запросы и мутации для контактов, сделок и активностей — никакого сервера для написания или хостинга.

Q: Почему использовать Back4app для API CRM GraphQL?

Back4app предоставляет GraphQL конечную точку для вашей CRM-схемы: запросите контакты, сделки (с фильтром по этапу) и активности в одном запросе; мутации для createDeal, updateDeal, createActivity.

Q: Как мне запросить сделки по этапу в GraphQL?

Используйте запрос сделок с аргументом where, например, deals(where: { stage: "qualified" }) { edges { node { objectId title amount stage } } }.

Q: Как мне обновить этап сделки через GraphQL?

Используйте мутацию updateDeal с id сделки и полями: { stage: "won" }. Резолвер обновляет Сделку в Back4app.

Готовая к производству GraphQL CRM схема бэкенда и Стартовый комплект на Back4app: Контакт, Компания, Сделка, Активность, этапы воронки, ER-диаграмма, словарь данных, JSON-схема, API-площадка и однонажатийный AI агент для развертывания за минуты.

Создано с помощью AI-агента

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

На этой странице вы получите готовую к производству схему CRM, однонажатийный AI-подсказку и пошаговый код GraphQL — так вы сможете выпустить приложение CRM без создания бэкенда.

Разверните за считанные минуты — Вставьте подсказку AI Agent и получите работающее приложение с контактами, компаниями, сделками и конвейером.
Безопасно по умолчанию — ACL и доступ на основе ролей, чтобы пользователи видели только свои назначенные сделки и данные.
GraphQL-родной SDK — Типизированные объекты, async/await, оффлайн-фиксация и Live Queries для обновлений конвейера.
REST + GraphQL — Обе API сгенерированы автоматически; фильтруйте сделки по этапу, перечисляйте активности по relatedTo.
Пять классов — _User (встроенный), Компания, Контакт, Сделка (конвейер), Активность (задачи/события).

Что такое шаблон бэкенда CRM приложения GraphQL?

Back4app — это бэкенд как услуга (BaaS), идеальный для CRM приложений: управляемая база данных, синхронизация в реальном времени, доступ на основе ролей и SDK для 13+ технологий. Шаблон бэкенда CRM приложения — это предустановленная, готовая к производству схема бэкенда на Back4app. Он предоставляет вам пять классов (_User, Company, Contact, Deal, Activity), этапы воронки, REST и GraphQL API, а также подсказку AI Agent в один клик — так вы можете подключить фронтенд GraphQL и развернуть работающее CRM приложение за минуты вместо дней. Выберите вашу технологию ниже для пошаговой интеграции SDK.

Лучше всего для:

Команды продажСоздатели CRMБыстрое прототипированиеПолевые представителиЗапуски MVPКоманды выбирают BaaS для CRM

Обзор

Back4app предоставляет вашу схему CRM через GraphQL: запрашивайте контакты, сделки (с условием: { stage }) и активности; изменяйте с помощью createDeal, updateDeal, createContact, createActivity. Один конечный пункт, типизированная схема и аутентификация на основе сессий.

Те же пять классов — _User, Company, Contact, Deal, Activity — поддерживают как REST, так и GraphQL. Используйте вашего любимого клиента GraphQL (Apollo, urql), чтобы запрашивать только необходимые поля и поддерживать синхронизацию между пайплайном и списками контактов.

Основные функции CRM

GraphQL CRM бэкенд: конечные точки для Контакта, Компании, Сделки и Активности с заголовками аутентификации и кодами состояния. Управление воронкой и ACL из коробки.

Управление контактами

Храните и управляйте контактами с именем, электронной почтой, телефоном, компанией и заметками. Идеально подходит для приложений GraphQL.

Управление компаниями

Отслеживайте компании по имени, веб-сайту, отрасли и адресу. Связано с контактами и сделками.

Конвейер сделок

Конвейер продаж с этапами, суммой, ожидаемой датой закрытия и назначением. Создан для бэкендов GraphQL.

Отслеживание активности

Записывайте звонки, электронные письма, встречи и заметки, связанные с контактами и сделками. Работает с SDK GraphQL.

Пользователь и разрешения

Встроенная модель пользователя и указатели для владения и назначения. ACL из коробки для GraphQL.

Почему стоит создавать ваш CRM GraphQL API с Back4app?

Back4app предоставляет конечную точку GraphQL, чтобы вы могли запрашивать и изменять Контакт, Компанию, Сделку и Действие с помощью одной конечной точки.

•Единая конечная точка: POST на конечную точку GraphQL с запросами и изменениями; запрашивайте только те поля, которые вам нужны.
•Типизированная схема: Типы Контакт, Компания, Сделка и Действие генерируются из вашей схемы Back4app; используйте их в вашем клиенте для безопасных по типу запросов.
•Конвейер и действия: Запрашивайте сделки по этапу и действия по relatedTo; изменения для обновления этапа сделки и создания действий.

Идеально подходит для команд, использующих клиентов GraphQL (Apollo, urql) для CRM или панелей мониторинга.

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

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

Разрабатывайте быстрее, без кода бэкенда

REST и API GraphQL и готовая схема — подключите свое приложение и вперед.

Безопасно по умолчанию

ACL и разрешения на уровне класса; ограничить по assignedTo и createdBy.

Поток в реальном времени

Live Queries через WebSockets для мгновенных обновлений сделок и активности.

Встроенная аутентификация

Регистрация пользователей, вход в систему и управление сессиями из коробки.

Работает в оффлайне

Локальная привязка сохраняет контакты и сделки доступными в оффлайне и синхронизирует их при повторном подключении.

Развертывание за минуты

Используйте AI Agent для создания и развертывания вашего CRM-приложения из этого шаблона.

Готовы попробовать?

Позвольте AI Agent от Back4app создать бэкенд вашего CRM-приложения, подключить фронтенд GraphQL и развернуть — все из одного запроса.

Создавайте с AI Agent Попробуйте API Playground

Бесплатно для начала — 50 запросов AI Agent в месяц, без необходимости в кредитной карте

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

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

Фронтенд

GraphQL

Бэкенд

Back4app

База данных

MongoDB

Аутентификация

Аутентификация и контроль доступа

API

REST и GraphQL

Развертывание

AI-агент / Панель управления

ER диаграмма

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

ER Диаграмма

Просмотреть источник диаграммы

Mermaid

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: как ваше GraphQL приложение взаимодействует с Back4app — вход в систему, затем запрос контактов и сделок, обновление воронки.

ER Диаграмма

Просмотреть источник диаграммы

Mermaid

sequenceDiagram
  participant User
  participant Client as GraphQL Client
  participant Back4app as Back4app Cloud

  User->>Client: Login
  Client->>Back4app: mutation { logIn(username, password) }
  Back4app-->>Client: Session token
  Client-->>User: Logged in

  User->>Client: Load contacts and deals
  Client->>Back4app: query { deals { edges { node { objectId title stage } } } }
  Back4app-->>Client: Deal list
  Client-->>User: Show pipeline

  User->>Client: Create deal or contact
  Client->>Back4app: mutation { createDeal(input: { ... }) }
  Back4app-->>Client: Deal (objectId)
  Client-->>User: Updated list

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

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

Поле	Тип	Описание	Обязательно
objectId	String	Auto-generated unique identifier	авто
name	String	Full name of the contact
email	String	Email address	—
phone	String	Phone number	—
company	Pointer<Company>	Company this contact belongs to	—
notes	String	Free-form notes	—
createdBy	Pointer<_User>	User who created this contact	—
createdAt	Date	Auto-generated creation timestamp	авто
updatedAt	Date	Auto-generated last-update timestamp	авто

9 поля в Contact

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

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

ACL на уровне строк

Используйте ACL и указатели (assignedTo, createdBy), чтобы пользователи видели и редактировали только свои назначенные сделки и связанные данные.

Разрешения на уровне классов

CLP ограничивают, какие роли или пользователи могут создавать, читать, обновлять или удалять объекты на уровне класса.

Владение на основе указателей

Deal.assignedTo и Activity.createdBy ссылаются на _User; Cloud Code может обеспечивать видимость и редактирование по ролям.

Схема (JSON)

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

JSON

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

{
  "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
        }
      }
    }
  ]
}

Создайте с помощью AI Agent

Используйте Back4app AI Agent, чтобы создать реальное CRM приложение из этого шаблона: он создаст фронтенд, бэкенд (эту схему, аутентификацию и API) и развернет его — без ручной настройки. Подсказка ниже описывает этот стек CRM, чтобы Агент мог сгенерировать готовое к производству приложение за один раз.

Back4app AI Agent

Готовы к созданию

Создайте приложение CRM на Back4app с этой точной схемой и поведением.

Схема:
1. _Пользователь (используйте встроенный Back4app): имя пользователя (Строка, обязательно), электронная почта (Строка, обязательно), пароль (Строка, обязательно); objectId, createdAt, updatedAt (система).
2. Компания: название (Строка, обязательно), веб-сайт (Строка), отрасль (Строка), адрес (Строка), заметки (Строка), создано (Указатель на _Пользователь); objectId, createdAt, updatedAt (система).
3. Контакт: имя (Строка, обязательно), электронная почта (Строка), телефон (Строка), компания (Указатель на Компанию), заметки (Строка), создано (Указатель на _Пользователь); objectId, createdAt, updatedAt (система).
4. Сделка: название (Строка, обязательно), сумма (Число), стадия (Строка; например, лид, квалифицированный, предложение, переговоры, выиграно, проиграно), контакт (Указатель на Контакт), компания (Указатель на Компанию), ожидаемая дата закрытия (Дата), заметки (Строка), назначено (Указатель на _Пользователь); objectId, createdAt, updatedAt (система).
5. Активность: тип (Строка; например, звонок, электронная почта, встреча, заметка), тема (Строка), описание (Строка), срок (Дата), завершено (Дата), связано с (Указатель на Контакт или Сделку), создано (Указатель на _Пользователь); objectId, createdAt, updatedAt (система).

Безопасность:
- Установите ACL, чтобы только аутентифицированные пользователи могли получать доступ к данным; используйте правила на основе ролей или владельца, где это уместно (например, назначено, создано).
- Используйте разрешения на уровне класса, чтобы только аутентифицированные пользователи могли создавать/читать/обновлять/удалять эти классы.

Аутентификация:
- Регистрация (имя пользователя, электронная почта, пароль) и вход; поддержка выхода/сессии.

Поведение:
- Полный CRUD для Компании, Контакта, Сделки и Активности.
- Список сделок с фильтром по стадии и сортировкой по ожидаемой дате закрытия или updatedAt (вид воронки).
- Список активностей по связанным с (Контакт или Сделка).
- Опционально: обновления в реальном времени Live Queries для Сделки и Активности для обновлений панели управления/воронки.
- Опционально: оффлайн-фиксация для мобильных устройств (Контакты, Сделки, Активности).

Доставка:
- Создайте приложение Back4app с вышеуказанной схемой, ACL и любым необходимым облачным кодом.
- Сгенерируйте фронтенд и подключите его к этому бэкенду; разверните, чтобы приложение работало от начала до конца.

Нажмите кнопку ниже, чтобы открыть Агента с предзаполненной подсказкой этого шаблона.

Развернуть за минуты50 бесплатных запросов / месяцКредитная карта не требуется

API Playground

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

Загрузка песочницы…

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

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

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

Запрос контактов и сделок
Отправьте GraphQL-запрос для получения контактов или сделок (с токеном сессии в заголовках).
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
```
query GetDeals {
  deals {
    edges {
      node {
        objectId
        title
        done
        dueDate
        priority
        createdAt
      }
    }
  }
}
```

Создать сделку

Используйте мутацию createDeal с переменными: название, этап, сумма и связанный контакт/компания.

GraphQL

mutation CreateDeal($title: String!, $stage: String, $amount: Float) {
  createDeal(input: {
    fields: {
      title: $title
      stage: $stage
      amount: $amount
    }
  }) {
    deal {
      objectId
      title
      stage
      amount
      createdAt
    }
  }
}

mutation CreateContact($name: String!, $email: String, $phone: String) {
  createContact(input: {
    fields: { name: $name email: $email phone: $phone }
  }) {
    contact { objectId name createdAt }
  }
}

Обновление и удаление

Мутации UpdateDeal и DeleteDeal с objectId.

GraphQL

mutation UpdateDeal($objectId: ID!, $stage: String) {
  updateDeal(input: {
    objectId: $objectId
    fields: { stage: $stage }
  }) {
    deal { objectId stage }
  }
}

mutation DeleteDeal($objectId: ID!) {
  deleteDeal(input: { objectId: $objectId }) { success }
}

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

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

Что такое Back4app?

Почему использовать Back4app для API CRM GraphQL?

Как мне запросить сделки по этапу в GraphQL?

Как мне обновить этап сделки через GraphQL?

Доверяют разработчики по всему миру

Присоединяйтесь к сообществу, строящему будущее приложений

Готовы создать свое CRM-приложение?

Начните свой проект GraphQL за считанные минуты. Кредитная карта не требуется.

Строить с ИИ-агентом

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

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

Что такое шаблон бэкенда CRM приложения GraphQL?

Обзор

Основные функции CRM

Управление контактами

Управление компаниями

Конвейер сделок

Отслеживание активности

Пользователь и разрешения

Почему стоит создавать ваш CRM GraphQL API с Back4app?

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

Разрабатывайте быстрее, без кода бэкенда

Безопасно по умолчанию

Поток в реальном времени

Встроенная аутентификация

Работает в оффлайне

Развертывание за минуты

Готовы попробовать?

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

ER диаграмма

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

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

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

ACL на уровне строк

Разрешения на уровне классов

Владение на основе указателей

Схема (JSON)

Создайте с помощью AI Agent

API Playground

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

Запрос контактов и сделок

Создать сделку

Обновление и удаление

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

Доверяют разработчики по всему миру

Готовы создать свое CRM-приложение?

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