Настройка MongoDB для мобильного приложения

Настройка MongoDB для мобильного приложения

MongoDB в контексте мобильных приложений чаще всего означает Atlas — облачный MongoDB с встроенными возможностями для мобильных: Atlas Device SDK (бывший Realm), Atlas Search, Atlas Data API. Прямое подключение к MongoDB из мобильного клиента через нативный драйвер — не практикуется по тем же причинам, что и с PostgreSQL: учётные данные в коде, нет авторизационного слоя.

Две стратегии использования

Стратегия 1: MongoDB как бэкенд-база. Мобильный клиент обращается к API (Node.js + Mongoose, или Atlas App Services), API работает с MongoDB. Стандартная серверная архитектура.

Стратегия 2: Atlas Device SDK (Realm) + Atlas Device Sync. Локальная Realm база на устройстве автоматически синхронизируется с Atlas MongoDB в облаке. Двусторонняя синхронизация без написания sync-логики вручную.

Для большинства проектов — первая стратегия. Вторая оправдана при сложных требованиях к офлайн-режиму.

API с Mongoose на Node.js

// Схема с валидацией
const productSchema = new Schema({
    _id: { type: String, default: () => new ObjectId().toHexString() },
    title: { type: String, required: true, maxlength: 200 },
    categoryId: { type: String, required: true, index: true },
    priceCents: { type: Number, required: true, min: 0 },
    images: [{ url: String, width: Number, height: Number }],
    tags: [{ type: String, index: true }],
    metadata: Schema.Types.Mixed,        // гибкое поле для расширяемых данных
    isActive: { type: Boolean, default: true, index: true },
    createdAt: { type: Date, default: Date.now, index: true }
}, {
    collection: 'products',
    versionKey: false
})

// Compound index для типичных мобильных запросов
productSchema.index({ categoryId: 1, isActive: 1, createdAt: -1 })
productSchema.index({ tags: 1, isActive: 1 })

Самая частая ошибка — забыть index: true на полях, по которым фильтруется. MongoDB без индекса делает collection scan — на 100K документов это секунды вместо миллисекунд.

Агрегационный pipeline для мобильного API

find() с простыми фильтрами — для несложных запросов. Для статистики, сложных выборок, join-а коллекций — aggregation pipeline:

// Каталог с количеством товаров по категориям
const categoriesWithCount = await Category.aggregate([
    { $match: { isActive: true } },
    {
        $lookup: {
            from: 'products',
            let: { categoryId: '$_id' },
            pipeline: [
                { $match: { $expr: { $and: [
                    { $eq: ['$categoryId', '$$categoryId'] },
                    { $eq: ['$isActive', true] }
                ]}}},
                { $count: 'total' }
            ],
            as: 'productCount'
        }
    },
    {
        $project: {
            name: 1,
            slug: 1,
            imageUrl: 1,
            productCount: { $ifNull: [{ $first: '$productCount.total' }, 0] }
        }
    },
    { $sort: { sortOrder: 1 } }
])

Atlas Search для поиска

Полнотекстовый поиск через Atlas Search (Lucene под капотом) быстрее, чем regex или text index:

// Atlas Search index definition (в Atlas Console или через Atlas API)
// {
//   "mappings": {
//     "fields": {
//       "title": [{ "type": "string", "analyzer": "lucene.russian" }],
//       "description": [{ "type": "string", "analyzer": "lucene.russian" }]
//     }
//   }
// }

const searchResults = await Product.aggregate([
    {
        $search: {
            index: 'product_search',
            compound: {
                must: [{
                    text: {
                        query: searchQuery,
                        path: ['title', 'description'],
                        fuzzy: { maxEdits: 1 }
                    }
                }],
                filter: [{ equals: { path: 'isActive', value: true } }]
            }
        }
    },
    { $limit: 20 },
    { $project: { title: 1, priceCents: 1, thumbnailUrl: 1, score: { $meta: 'searchScore' } } }
])

Fuzzy search с maxEdits: 1 — находит «ноутбук» при запросе «ноутьбук». Для мобильного поиска это важно: виртуальная клавиатура добавляет опечатки.

Change Streams для real-time

MongoDB Change Streams — аналог PostgreSQL LISTEN/NOTIFY. Бэкенд подписывается на изменения коллекции, рассылает события мобильным клиентам через WebSocket:

const changeStream = Product.watch([
    { $match: { operationType: { $in: ['insert', 'update', 'delete'] } } }
], { fullDocument: 'updateLookup' })

changeStream.on('change', (change) => {
    if (change.operationType === 'update') {
        const updatedProduct = change.fullDocument
        wsServer.broadcast(`category:${updatedProduct.categoryId}`, {
            type: 'PRODUCT_UPDATED',
            data: updatedProduct
        })
    }
})

Change Streams требуют MongoDB replica set — в Atlas это включено по умолчанию.

Atlas Data API

Для простых CRUD без кастомного бэкенда Atlas предлагает Data API — HTTP-эндпоинты к MongoDB через HTTPS, аутентификация через API-ключи или JWT. Мобильный клиент делает REST-запросы напрямую.

Подходит для прототипов и простых приложений. В production с кастомной бизнес-логикой Data API недостаточно гибок.

Настройка MongoDB Atlas, схем, индексов, Atlas Search и API для мобильного приложения: 1–2 недели. Стоимость рассчитывается индивидуально.