Files
DLE/docs.ru/back-docs/setup-instruction.md

197 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!--
Copyright (c) 2024-2026 Тарабанов Александр Викторович
All rights reserved.
This software is proprietary and confidential.
Unauthorized copying, modification, or distribution is prohibited.
For licensing inquiries: info@hb3-accelerator.com
Website: https://hb3-accelerator.com
GitHub: https://github.com/VC-HB3-Accelerator
-->
[English](https://hb3-accelerator.com/gitea/VC-HB3-Accelerator/Docs/src/branch/main/docs.en/back-docs/setup-instruction.md) | **Русский**
# Инструкция по настройке приложения Digital Legal Entity
## 🚀 Полный процесс инициализации системы
Этот документ описывает полный процесс подготовки приложения к работе с поддержкой блокчейна, смарт-контрактов и системы управления доступом.
---
## Шаг 1: Установка софта
1. Клонируйте репозиторий проекта на ваше локальное устройство
2. Запустите приложение через Docker Compose или локально в зависимости от конфигурации
3. Откройте веб-приложение в браузере: `http://localhost:9000` (production) или `http://localhost:5173` (dev режим)
---
## Шаг 2: Подключение крипто кошелька
1. Убедитесь, что у вас установлен браузерный кошелек (MetaMask, WalletConnect или аналог)
2. В кошельке создайте или импортируйте аккаунт с токеном управления
3. В веб-приложении нажмите на кнопку **"Подключить кошелек"**
4. Выберите тип кошелька и подтвердите подключение
5. После успешного подключения вы увидите адрес вашего аккаунта в верхнем углу
---
## Шаг 3: Добавление RPC провайдеров (Безопасность → RPC провайдеры)
1. Перейдите в **Настройки** → вкладка **Безопасность**
2. Найдите раздел **"RPC провайдеры"**
3. Нажмите кнопку **"Добавить"**
4. Заполните форму для каждой блокчейн сети, которую хотите использовать:
- **Название сети** (например: Ethereum, Polygon, BSC)
- **RPC URL** (ссылка для подключения, пример: `https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY`)
- **ID сети** (Chain ID)
5. Нажмите **"Сохранить"** для каждого провайдера
6. Система автоматически проверит корректность подключения
> ⚠️ **Важно**: Получите API ключи от провайдеров (Alchemy, Infura, Quicknode и т.д.) перед добавлением
---
## Шаг 4: Настройка мультидеплоя смарт контрактов
1. Перейдите в **Настройки** → вкладка **Блокчейн**
2. Заполните форму
3. Нажмите **"Запустить деплой"**
---
## Шаг 5: Завершение деплоя и сохранение адреса контракта
1. Ожидайте завершения деплоя (зависит от сети, обычно 30-120 секунд)
2. После успешного завершения откроется страница **"Управление контрактами"**
3. **Копируйте адрес развернутого контракта** (обычно он выглядит как: `0x742d35Cc6634C0532925a3b844Bc...`)
---
## Шаг 6: Настройка аутентификации через смарт контракт
1. Вернитесь в **Настройки** → вкладка **Аутентификация**
2. В поле **"Адрес смарт контракта"** вставьте адрес, скопированный на шаге 5
3. Установите пороги для управления доступом:
- **Минимальное количество токенов для редактирования** (например: 100 токенов)
- **Минимальное количество токенов для просмотра** (например: 1 токен)
---
## Шаг 7: Настройка ИИ и базы данных
1. Перейдите в **Настройки** → вкладка **ИИ**
2. Откройте подраздел **"База данных"**
3. Замените дефолтные пароли
4. Нажмите **"Сгенерировать новый ключ шифрования"**
- Система автоматически создаст криптографический ключ
- **Сохраните ключ в безопасном месте** (он понадобится для восстановления данных)
---
## Шаг 8: Настройка доступа через интернет (опционально)
**Если вам нужен доступ к веб приложению извне через интернет:**
1. Перейдите в **Настройки** → вкладка **Сервер**
2. На странице **Сервер** выберите **WEB SSH** или иной подходящий сервис
3. Заполните форму для миграции локального приложения на виртуальное устройство с:
- **Публичным IP адресом**
- **Подключением к вашему доменному имени**
4. Нажмите **"Опубликовать"**
5. Дождитесь завершения процесса миграции
> **Примечание**: Этот шаг требует наличия зарегистрированного доменного имени и доступа к DNS настройкам
---
## Шаг 9: Настройка юридических документов для работы с персональными данными
### 9.1 Заполнение юридической информации о компании
1. Перейдите в **CRM** → раздел **Контент**
2. Найдите и откройте форму **"Юридическая информация компании"**
3. Заполните все необходимые поля:
- **Полное наименование организации** (юридическое название)
- **Краткое наименование**
- **Организационно-правовая форма** (ООО, ИП, АО и т.д.)
- **Юридический адрес**
- **Фактический адрес** (если отличается)
- **ИНН / ОГРН / КПП** (регистрационные данные)
- **Контактные данные** (телефон, email, сайт)
- **Ответственное лицо за обработку персональных данных** (ФИО, должность)
- **Применимая юрисдикция** (GDPR, CCPA, российское законодательство и т.д.)
4. Нажмите **"Сохранить"**
> 💡 **Подсказка**: Все введенные данные автоматически подставятся во все шаблоны юридических документов
### 9.2 Работа с шаблонами документов
1. В разделе **Контент** перейдите в подраздел **"Шаблоны"**
2. Выберите необходимые шаблоны документов, требуемые регуляторами:
- **Политика конфиденциальности**
- **Пользовательское соглашение**
- **Согласие на обработку персональных данных**
- **Политика использования cookies**
3. Для каждого шаблона:
- Нажмите **"Предварительный просмотр"** для проверки автоматически заполненных данных
- При необходимости отредактируйте специфичные параметры обработки данных
- Выберите действие:
- **"Опубликовать для публичного использования"** — документ будет доступен на сайте
- **"Опубликовать для внутреннего использования"** — документ доступен только внутри CRM
- **"Распечатать"** — экспорт в PDF для печати или подписания
4. Подтвердите публикацию
5. Система автоматически добавит документы на соответствующие страницы приложения
> ⚠️ **Важно**: Рекомендуется проконсультироваться с юристом перед публикацией документов для обеспечения полного соответствия требованиям законодательства
---
## ✅ Приложение готово к работе!
После завершения всех шагов ваше приложение полностью сконфигурировано и готово к использованию.
**Следующие этапы:**
- 📖 Настройка AI ассистента (см. документ: `setup-ai-assistant.md`)
- 🔐 Управление смарт контрактами (см. документ: `manage-smart-contracts.md`)
---
## 🆘 Рекомендации по безопасности
✓ Сохраняйте адреса контрактов и ключи шифрования в безопасном месте
✓ Используйте мощные пароли для БД
✓ Регулярно создавайте резервные копии конфигурации
✓ Никогда не делитесь приватными ключами кошелька
✓ Используйте HTTPS для доступа к приложению в продакшене
---
## 📝 Что дальше?
После завершения базовой настройки вы можете:
1. Добавлять пользователей и управлять их разрешениями
2. Создавать группы для совместной работы
3. Настраивать AI ассистента для автоматизации задач
4. Управлять смарт контрактами для расширения функциональности
5. Интегрировать внешние сервисы и боты
---
## 📚 Дополнительная документация
### Изучите возможности DLE
- 🤖 **[ИИ-агенты](../ai-assistant.md)** — система создания специализированных агентов под бизнес-процессы
- 💼 **[Блокчейн для бизнеса](../blockchain-for-business.md)** - как токенизация активов решает бизнес-задачи
- 🛡️ **[Безопасность](../security.md)** - многоуровневая защита вашего бизнеса
### Техническая информация
- 🔗 **[Техническая документация по блокчейну](./blockchain-integration-technical.md)** - для разработчиков
- 📋 **[FAQ](https://github.com/VC-HB3-Accelerator/.github/blob/main/ru/FAQ.md)** — часто задаваемые вопросы
- 📝 **[Описание приложения](../application-description.md)** - обзор функциональности
### Поддержка
- 💬 **Чат поддержки**: https://hb3-accelerator.com/
- 📧 **Email**: info@hb3-accelerator.com