ваше сообщение коммита

2026-02-20 14:18:08 +03:00
parent 8702a355a1
commit 24e560fc83
44 changed files with 8354 additions and 95 deletions
--- a/docs.ru/back-docs/setup-instruction.md
+++ b/docs.ru/back-docs/setup-instruction.md
@@ -0,0 +1,197 @@
+<!--
+  Copyright (c) 2024-2025 Тарабанов Александр Викторович
+  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](../../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](../FAQ.md)** - часто задаваемые вопросы
+- 📝 **[Описание приложения](../application-description.md)** - обзор функциональности
+
+### Поддержка
+- 💬 **Чат поддержки**: https://hb3-accelerator.com/
+- 📧 **Email**: info@hb3-accelerator.com