<!--
  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