Глава 1: Знакомство с NocoBase

1.1 Быстрое знакомство

Прежде всего, мы рекомендуем Вам быстро попробовать NocoBase, чтобы оценить его возможности. Вы можете воспользоваться онлайн-Demo: укажите электронную почту и нужную информацию и нажмите кнопку активации. Вы получите тестовую систему сроком на 2 дня со всеми коммерческими плагинами:

Получив официальное письмо от NocoBase, можете сразу приступить к изучению и оценить гибкость и мощь платформы. В тестовой системе можно делать что угодно — никаких ограничений нет.

1.2 Базовый интерфейс NocoBase

Добро пожаловать в NocoBase! При первом использовании UI может показаться непривычным, и Вы не будете знать, с чего начать. Не волнуйтесь, мы шаг за шагом познакомимся с основными областями функциональности и поможем Вам быстро приступить к работе.

1.2.1 Конфигурация интерфейса

При первом входе в NocoBase Вы увидите простой и понятный главный экран. В правом верхнем углу находится кнопка Конфигурация интерфейса; по нажатию на неё система переключится в режим конфигурации UI. Это основная рабочая область для построения страниц системы.

Режим конфигурации UI

Шаги:

  1. Войдите в режим конфигурации: нажмите кнопку «Конфигурация интерфейса» в правом верхнем углу.
  2. Добавьте страницу меню:
    • Нажмите «Добавить пункт меню».
    • Введите название (например, «Тестовая страница») и подтвердите.
    • Система автоматически создаст и откроет новую тестовую страницу.

demov4-001.gif

  1. Создайте блок:
    • На тестовой странице нажмите кнопку «Создать блок».
    • Из списка типов выберите блок данных, например «Табличный блок».
    • Подключите таблицу данных, например встроенную таблицу «Пользователи».
    • Выберите поля, которые хотите отобразить, и подтвердите.
  2. Готово! Перед Вами табличный блок со списком пользователей.

Создание блока

Не правда ли, очень просто? Дизайн блоков NocoBase вдохновлён Notion, но возможностей у них значительно больше — они позволяют строить более сложные системы. В следующих главах мы подробнее рассмотрим разные типы блоков, оставайтесь с нами!

1.2.2 Менеджер плагинов

Plugin — важный инструмент расширения возможностей NocoBase. В Менеджере плагинов Вы можете просматривать, устанавливать, включать и отключать плагины под разные бизнес-задачи.

Plugin позволяют расширять функциональность платформы и реализовывать удобные или неожиданные интеграции, упрощая Вашу работу и разработку.

Менеджер плагинов

Шаги:

  1. Просмотр установленных плагинов: нажмите «Менеджер плагинов» — Вы увидите список всех установленных плагинов.
  2. Активация плагина:
    • Найдите нужный плагин, например «Редактор тем».
    • Нажмите кнопку «Включить», чтобы активировать его.
  3. Тестирование плагина:
    • После активации «Редактора тем» в личном меню в правом верхнем углу можно быстро менять тему системы. Смена темы
    • В центре настроек Вы увидите интерфейс редактора тем, в котором можно настраивать цвета, шрифты и другие параметры. Редактор тем

1.2.3 Страница настроек

Страница настроек объединяет различные параметры системы и некоторых плагинов и позволяет управлять всеми аспектами NocoBase.

Страница настроек

Часто используемые разделы:

1.2.4 Информация о версии и поддержка

В правом верхнем углу UI Вы увидите информацию о версии NocoBase. Если в процессе использования возникнут вопросы, Вы можете обратиться к главной странице и руководству пользователя за помощью.

Информация о версии

1.2.5 Меню личного кабинета

Меню личного кабинета находится в правом верхнем углу UI. В нём можно изменить личные данные, переключить роль и выполнить ряд важных системных действий. Некоторые Plugin также расширяют возможности этого меню.

Меню личного кабинета

1.3 Установка NocoBase

Если Вы решили использовать NocoBase всерьёз, его нужно установить на свой компьютер или сервер. NocoBase предлагает несколько способов установки — выберите подходящий и легко начните путь no-code-разработки.

1.3.1 Способы установки

  1. Установка через Docker (рекомендуется)

    • Преимущества: быстро и просто, подходит пользователям, знакомым с Docker.
    • Выбор версии:
      • main и latest: на сегодня самые стабильные версии, подходят большинству пользователей.
      • next: бета-версия для тех, кто хочет попробовать новые возможности. Эта версия может быть не до конца стабильной — рекомендуется использовать её после резервного копирования важных данных.
    • Шаги:
  2. Установка через Create-NocoBase-App

    • Подходит: фронтенд-разработчикам и пользователям, знакомым с npm.
    • Шаги:
  3. Установка из исходников

    • Подходит: разработчикам, которым нужна глубокая кастомизация NocoBase.
    • Шаги:

1.3.2 Подробное руководство по установке (на примере Docker)

Какой бы способ установки Вы ни выбрали, подробные шаги и пояснения можно найти в документации по установке NocoBase. Ниже — краткие шаги установки через Docker, чтобы Вы могли быстро начать:

  1. Установка Docker: убедитесь, что на Вашей системе установлен Docker. Если нет — скачайте его с официального сайта Docker и установите.

  2. Получение файла Docker Compose:

    • Откройте терминал или командную строку.
    • Создайте каталог nocobase и файл конфигурации Docker Compose.
mkdir nocobase
cd nocobase
vim docker-compose.yml
  1. Откройте docker-compose.yml и вставьте указанную ниже конфигурацию, скорректируйте при необходимости и сохраните файл.
version: "3"

networks:
  nocobase:
        driver: bridge

services:
  app:
        image: registry.cn-shanghai.aliyuncs.com/nocobase/nocobase:latest
        networks:
          - nocobase
        depends_on:
          - postgres
        environment:
          # Секретный ключ приложения, используется для генерации Token и т. п.
          # При изменении APP_KEY старые Token становятся недействительными.
          # Можно использовать произвольную случайную строку — главное, не разглашать её.
          - APP_KEY=your-secret-key
          # Тип БД, поддерживаются postgres, mysql, mariadb, sqlite
          - DB_DIALECT=postgres
          # Хост БД, можно заменить на IP уже имеющегося сервера БД
          - DB_HOST=postgres
          # Имя БД
          - DB_DATABASE=nocobase
          # Пользователь БД
          - DB_USER=nocobase
          # Пароль БД
          - DB_PASSWORD=nocobase
          # Часовой пояс
          - TZ=Asia/Shanghai
        volumes:
          - ./storage:/app/nocobase/storage
        ports:
          - "13000:80"
        # init: true

  # Если используется существующая БД, postgres можно не запускать
  postgres:
        image: registry.cn-shanghai.aliyuncs.com/nocobase/postgres:16
        restart: always
        command: postgres -c wal_level=logical
        environment:
          POSTGRES_USER: nocobase
          POSTGRES_DB: nocobase
          POSTGRES_PASSWORD: nocobase
        volumes:
          - ./storage/db/postgres:/var/lib/postgresql/data
        networks:
          - nocobase
  1. Запуск NocoBase:
    • В каталоге nocobase выполните команду для запуска сервиса:
docker-compose up -d
  • Команда скачает необходимые образы и запустит сервис NocoBase.
  1. Доступ к NocoBase:
    • Откройте браузер и перейдите по адресу http://localhost:13000 (адрес может отличаться в зависимости от конфигурации) — Вы увидите страницу входа NocoBase.

После выполнения этих шагов Вы успешно установили и запустили NocoBase! Далее, следуя руководству, Вы сможете приступить к построению собственной системы.


Надеемся, что этих шагов достаточно, чтобы Вы освоились с базовым UI и процессом установки NocoBase. В следующей главе (Глава 2: Проектирование системы управления задачами) мы продолжим знакомство с возможностями NocoBase и поможем Вам построить полноценное приложение. Сделаем следующий шаг и начнём новое путешествие в мир no-code-разработки!