Files
DLE/SOFT_DESCRIPTION.md

407 lines
37 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

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.

# DApp for Business
## Краткое описание
**DApp for Business** — это современное веб3-приложение, позволяющее предпринимателям использовать цифровое юридическое лицо для обслуживания клиентов, приема безналичных платежей, безопасного управления активами и прозрачного учета с помощью смарт-контрактов и искусственного интеллекта.
---
## Основные возможности
- Создание и управление цифровым юридическим лицом на блокчейне
- Прием безналичных платежей (криптовалюта, стейблкоины)
- Безопасное хранение и управление бизнес-активами через смарт-контракты
- Прозрачный учет операций и автоматизация отчетности
- Интеграция с ИИ для анализа данных и автоматизации бизнес-процессов
- Управление клиентской базой и сервисами через децентрализованное приложение
---
## Целевая аудитория
- Индивидуальные предприниматели
- Малый и средний бизнес
- Стартапы, работающие с цифровыми активами
- Фрилансеры, желающие автоматизировать бизнес-процессы
---
## Преимущества
- Полная прозрачность и доверие благодаря блокчейну
- Автоматизация рутинных задач с помощью ИИ
- Безопасное управление активами без посредников
- Гибкая интеграция с внешними сервисами и кошельками
- Масштабируемость и независимость от традиционных банковских систем
---
## Технические требования
- Операционная система: Linux, macOS, Windows (рекомендуется WSL2 для Windows)
- Docker
- Node.js (v16+)
- Yarn
- Браузер с поддержкой Web3 (например, MetaMask)
---
## Установка и запуск
1. Клонируйте репозиторий:
```bash
git clone https://github.com/your-org/dapp-for-business.git
cd dapp-for-business
```
2. Установите зависимости:
```bash
yarn install
```
3. Запустите приложение в Docker:
```bash
docker-compose up --build
```
4. Откройте приложение в браузере по адресу: [http://localhost:3000](http://localhost:3000)
---
## Быстрый старт
1. Зарегистрируйте цифровое юридическое лицо через интерфейс приложения.
2. Подключите криптокошелек (MetaMask или другой Web3-кошелек).
3. Настройте параметры бизнеса и добавьте клиентов.
4. Начните принимать платежи и управлять активами через смарт-контракты.
---
## Структура проекта
- `frontend/` — клиентская часть на Vue.js (исходный код, конфиги, сборка, nginx)
- `backend/` — серверная логика, API, работа с БД, интеграция со смарт-контрактами
- `vector-search/` — сервис поиска и работы с векторными данными (Python, FastAPI)
- `webssh-agent/` — сервис для работы с SSH-агентом через веб-интерфейс (Node.js)
- `scripts/` — bash-скрипты для автоматизации (миграции, обновления DNS и др.)
- `md/` — дополнительная документация и технические описания
- `docs/` — документация и примеры
- `docker-compose.yml`, `Dockerfile` — конфигурация контейнеризации и сборки
- `setup.sh`, `clean-logs.sh` — вспомогательные скрипты для установки и обслуживания
---
## Часто задаваемые вопросы (FAQ)
- **Как подключить кошелек?**
Используйте MetaMask или любой другой Web3-кошелек, следуя инструкции в интерфейсе приложения.
- **Какие криптовалюты поддерживаются?**
Поддерживаются основные токены стандарта ERC-20 и стейблкоины.
- **Безопасно ли хранить активы в приложении?**
Все операции выполняются через проверенные смарт-контракты, код которых открыт и доступен для аудита.
---
## Особенности развертывания и автономной работы
- Программное обеспечение с ИИ может работать полностью автономно на локальном устройстве без доступа к интернету после установки.
- С локального устройства возможно открыть доступ к сервису для интернет-пользователей (например, через проброс портов или настройку прокси).
- Приложение может быть установлено и сразу в облачный сервис (VPS, облачные платформы и т.д.) для круглосуточного доступа из любой точки мира.
---
## Управление настройками и доступом
- Управление всеми настройками приложения осуществляется через удобный веб-интерфейс.
- Доступ к настройкам получает только пользователь, чей криптокошелек содержит специальный админ-токен управления смарт-контрактом.
- После первого входа в приложение администратор может изменить стандартный админ-токен, создав собственный токен через специальную форму для деплоя смарт-контракта прямо в интерфейсе приложения.
- Таким образом, ваш кошелек — это ваш смарт-контракт, ваши токены, ваш управляемый доступ и ваши активы: только вы контролируете все ключевые параметры и права.
- Для получения бесплатных обновлений приложения в течение 5 лет администратору необходимо отправить первичный админ-токен на собственный смарт-контракт, созданный в приложении (операция выполняется через интерфейс).
> **Примечание:** Все смарт-контракты приложения построены на базе проверенных и безопасных библиотек OpenZeppelin.
---
## Инструкция по заполнению формы «Блокчейн-настройки»
1. **Создание нового DLE (Digital Legal Entity)**
- **Имя DLE**: Введите уникальное название вашей цифровой организации (например, My DLE).
- **Символ токена управления (GT)**: Укажите короткое обозначение токена (3-5 латинских символов, например, MDGT).
2. **Выбор кода деятельности (ISIC)**
- Последовательно выберите секцию, раздел, группу и класс деятельности из выпадающих списков.
- После выбора нужного кода нажмите «Добавить код деятельности». Можно добавить несколько кодов.
3. **Партнёры**
- Для каждого партнёра укажите:
- **Адрес партнёра** (Ethereum-адрес, например, 0x...).
- **Сумму GT для партнёра** (количество токенов управления).
- Для добавления нового партнёра используйте кнопку «Добавить партнёра».
- Для удаления — «Удалить партнёра».
4. **RPC-конфигурации**
- В разделе «Добавить новую RPC конфигурацию» выберите сеть из списка или укажите пользовательский ID и Chain ID.
- Введите RPC URL (например, https://...).
- При необходимости воспользуйтесь предложенным URL.
- Нажмите «Добавить RPC» для сохранения конфигурации.
5. **Выбор сети для деплоя**
- В выпадающем списке выберите блокчейн-сеть, в которую будет развёрнут смарт-контракт вашей организации.
6. **Приватный ключ для деплоя**
- Введите приватный ключ деплоера (будет использоваться только для развертывания смарт-контракта).
7. **Пользовательские настройки газа (опционально)**
- Если требуется, включите опцию «Использовать пользовательские настройки газа» и укажите лимит газа, максимальную и приоритетную комиссию.
8. **Сохранение и деплой**
- После заполнения всех полей проверьте введённые данные.
- Нажмите кнопку деплоя (или «Сохранить»), чтобы развернуть смарт-контракт и завершить настройку.
**Важно:**
- Доступ к настройкам имеют только пользователи с админ-токеном в кошельке.
- После деплоя вы сможете управлять организацией через смарт-контракт и веб-интерфейс.
---
## Управление DLE и модульными смарт-контрактами
После создания смарт-контракта с админ-токеном управления в разделе CRM приложения появляется интерфейс для управления функциями смарт-контракта и добавления модульных смарт-контрактов.
### Как управлять DLE через интерфейс
1. **Переход к управлению DLE**
- В разделе CRM нажмите на блок "Управление DLE" и кнопку "Подробнее" или перейдите по адресу `/dle-management`.
2. **Выбор DLE**
- В списке отобразятся все созданные вами DLE. Выберите нужную организацию для управления.
3. **Основная информация**
- Вкладка "Основная информация" содержит сведения о названии, символе токена, местонахождении, кодах деятельности, дате создания и адресах смарт-контрактов (токен, таймлок, Governor). Можно скопировать адреса или открыть их в обозревателе блокчейна.
4. **Предложения**
- На вкладке "Предложения" можно создавать новые предложения для управления DLE (например, изменение параметров, добавление участников и др.).
- Для создания предложения заполните заголовок и описание, затем отправьте на голосование.
- Участвуйте в голосовании по предложениям ("За" или "Против"). Статус предложения обновляется автоматически.
5. **Управление (Governance)**
- Вкладка "Управление" позволяет просматривать и изменять параметры управления: порог предложения, кворум, задержку и период голосования.
6. **Модули**
- Вкладка "Модули" предназначена для подключения дополнительных модульных смарт-контрактов (например, токенизация активов, мультиподпись, дивиденды, стейкинг, приём платежей и др.).
- Для установки модуля нажмите "Установить" напротив нужного модуля. Для удаления — "Удалить".
- Для модуля "Прием платежей" выберите токены, которые будут приниматься, и сохраните настройки.
7. **Удаление DLE**
- При необходимости можно удалить DLE (доступно только администратору). Будьте внимательны: действие необратимо.
**Важно:**
- Все действия с DLE и модулями доступны только пользователям с админ-токеном в кошельке.
- Управление DLE реализовано через смарт-контракты на базе OpenZeppelin, что обеспечивает безопасность и прозрачность операций.
---
## Настройка и использование ИИ-моделей
После установки приложения администратор может:
- Добавить ключи своих ИИ-моделей по подписке (например, OpenAI, Gemini и др.) в настройках приложения.
- Скачать одну из доступных ИИ-моделей и развернуть её локально на своём устройстве для автоматизации обслуживания клиентов бизнеса без рисков утечки конфиденциальных данных.
Для дообучения добавленных моделей деталям вашего бизнеса предусмотрена возможность:
- Создавать собственные таблицы в установленной базе данных через веб-интерфейс приложения.
- Заполнять эти таблицы данными, которые ИИ-ассистент сможет использовать для генерации персонализированных сообщений клиентам бизнеса как в чате приложения, так и в других каналах коммуникации (например, email, Telegram и др.).
Это позволяет максимально адаптировать ИИ-ассистента под специфику вашего бизнеса и обеспечить безопасность корпоративных данных.
---
## Интерактивный обмен контентом, публикация и интеграция с ИИ
- Пользователи могут создавать и публиковать веб-страницы (о компании, продуктах, статьи) с помощью удобной формы.
- Каждая страница получает уникальный URL, оптимизирована для SEO и доступна для поиска в интернете и ИИ-системах.
- После публикации страницы можно делиться ими в корпоративном чате: появляется интерактивная карточка с кнопкой для просмотра содержимого, а также возможностью задать вопрос по содержимому страницы.
- Страницы автоматически интегрируются с RAG: разбиваются на смысловые блоки, векторизуются и используются ИИ-ассистентом для поиска и генерации ответов.
- При публикации можно выбрать интеграцию с RAG и добавить Q&A по теме страницы для последующего поиска.
- Возможна публикация страниц в соцсетях и блогах (Medium, LinkedIn, Instagram, Telegram и др.) через API с выбором платформ.
- Все компоненты реализованы с учётом безопасности и приватности данных, поддерживается удаление и редактирование страниц.
- Используются современные RAG-фреймворки (LlamaIndex, LangChain) и актуальные модели для векторизации (OpenAI, Sentence Transformers и др.).
- Страницы открыты для индексации поисковыми системами и ИИ-ботами, что обеспечивает максимальную видимость и доступность информации.
---
## Управление контактами в CRM
В разделе "Контакты" CRM администраторы приложения могут:
- Отслеживать и управлять всеми выбранными контактами через удобную таблицу.
- Использовать фильтры быстрого поиска по имени, email, Telegram, кошельку, типу контакта, дате и тегам.
- Применять кнопки быстрых действий для массовой рассылки сообщений, импорта контактов, удаления выбранных записей.
- Просматривать подробную информацию о каждом контакте, редактировать имя, email, Telegram, кошелек, язык общения.
- Добавлять и удалять теги для контакта, а также создавать новые теги прямо из интерфейса.
- Блокировать и разблокировать пользователей, полностью удалять контакт.
- Вести чат с каждым контактом прямо в интерфейсе приложения, использовать ИИ-ассистента для генерации ответов.
- Все изменения и действия с контактами доступны только администраторам.
Это позволяет эффективно управлять клиентской базой, быстро находить нужные контакты и автоматизировать коммуникации с помощью встроенных инструментов.
## Контакты и поддержка
- Email: info@hb3-accelerator.com
- Telegram: @yourproject_support
- Сайт: [https://hb3-accelerator.com](https://hb3-accelerator.com)
---
## Лицензия
MIT License
---
офер:
Привет! Я **Алекс** из венчурного фонда **HB3 Accelerator**.
Если ваша компания:
* использует **CRM** для обслуживания клиентов и имеет штат **продавцов и бухгалтеров**;
* нуждается в **безналичных платежах без лимитов, ограничений и с низкими комиссиями**;
* ценит **прозрачный учёт и свободное управление активами**,
то я буду рад предложить вам **программное обеспечение с ИИ и смарт-контрактами**.
примеры вопросов оо клиентов:
1. Как ваш софт интегрируется с уже существующими CRM-системами? Например, у нас сейчас используется 1С и Bitrix24.
2. Какие конкретно задачи автоматизирует ваш ИИ? Это только аналитика или он может, например, помогать продавцам в реальном времени?
3. Как обеспечивается безопасность и прозрачность работы со смарт-контрактами? Кто их разрабатывает и кто несёт ответственность в случае ошибки?
4. Какой у вас опыт внедрения подобных решений в СНГ? Есть ли кейсы в моей отрасли (например, розничная торговля)?
5. Какой порядок внедрения: сколько времени занимает интеграция, кто обучает персонал?
6. Какие комиссии по безналичным платежам и с какими банками/платёжными системами вы работаете?
7. Какой уровень поддержки вы предоставляете после внедрения?
ответ:
### Наше комплексное решение для вашего бизнеса
Наше программное обеспечение включает **встроенную CRM-систему**, куда вы можете легко загрузить необходимые контакты из ваших текущих CRM для **омниканального обслуживания**.
**ИИ-ассистент**, интегрированный в наш софт, способен обучаться работе с сегментами ваших клиентов и поставщиков. Обучение происходит на основе правил, которые вы устанавливаете и загружаете в **векторную базу данных**. Эта база надёжно хранит ваши конфиденциальные данные либо на **локальном**, либо на **облачном сервере**.
Мы — **молодой стартап**, представляющий свой первый технологический продукт. Внедрение нашего решения занимает от **нескольких часов до одного года**, в зависимости от сложности интеграции.
---
### Условия сотрудничества
Мы предоставляем **5 лет обновлений** для вашего программного обеспечения.
Кроме того, если **в течение первого года** мы не сможем настроить софт под индивидуальные потребности вашего бизнеса, вы можете получить **возврат 70% от стоимости**.
вопросы:
Какой у вас опыт работы с интеграцией в 1С и Bitrix24? Есть ли готовые модули или потребуется доработка под нас?
Как реализована миграция данных из старых CRM? Кто этим занимается — ваша команда или наши специалисты?
Какой стек технологий вы используете для ИИ и смарт-контрактов? На каких блокчейн-платформах строится ваша система?
Какой SLA по поддержке и реагированию на инциденты? Есть ли круглосуточная поддержка?
Как лицензируется продукт: это подписка, разовая покупка или гибридная модель?
Какой порядок оплаты: аванс, поэтапно, после внедрения?
Как вы обеспечиваете соответствие требованиям законодательства РФ/СНГ по хранению и обработке персональных данных?
Есть ли демо-доступ или пилотный проект, чтобы мы могли протестировать систему на реальных данных?
ответы :
---
### Особенности нашего решения
Мы не занимаемся интеграциями с **устаревшими CRM-системами**. Однако ваши сотрудники смогут легко выполнить **миграцию данных** при поддержке нашего **ИИ-ассистента**.
Наш **ИИ-ассистент** обеспечивает **круглосуточную поддержку**. Инциденты с нашей стороны **исключены**, поскольку приобретаемое вами программное обеспечение является **полностью локальным решением**.
---
### Безопасность и конфиденциальность данных
Хранение персональных данных **соответствует требованиям законодательства**. Все данные **зашифрованы** и хранятся **на вашей территории**.
---
### Технологический стек
Вот основные технологии, которые мы используем в нашем **backend-решении**:
* **Искусственный интеллект и машинное обучение:** `@anthropic-ai/sdk`, `@google/genai`, `@langchain/community`, `@langchain/core`, `@langchain/ollama`, `langchain`, `openai`
* **Блокчейн и смарт-контракты:** `@openzeppelin/contracts`, `ethers`, `siwe`, `viem`
* **Веб-сервер и API:** `express`, `cors`, `helmet`, `express-rate-limit`
* **Базы данных:** `pg`, `connect-pg-simple`
* **Безопасность:** `csurf`, `express-session`, `session-file-store`, `cookie`
* **Обработка электронной почты:** `imap`, `mailparser`, `nodemailer`
* **Мессенджеры:** `node-telegram-bot-api`, `telegraf`, `ws`
* **Утилиты и вспомогательные библиотеки:** `archiver`, `axios`, `cron`, `dotenv`, `multer`, `node-cron`, `semver`, `winston`
* **Инструменты разработки:** `nodemon`, `eslint`, `prettier`, `hardhat`, `mocha`, `chai`, `typescript`
вопросы:
1. Как реализована поддержка и обновления: если решение полностью локальное, как будут устанавливаться апдейты и исправления? Это делается через удалённый доступ, или вы предоставляете инструкции для нашей IT-команды?
2. Какой механизм резервного копирования и восстановления данных предусмотрен в вашем решении?
3. Если потребуется интеграция с внешними сервисами (например, платёжные шлюзы, государственные системы учёта), возможно ли это реализовать на вашей платформе?
4. Какой минимальный и рекомендуемый состав IT-специалистов нужен для поддержки вашего ПО на стороне клиента?
5. Какой порядок лицензирования используемых вами open-source библиотек и SDK? Нет ли рисков для конечного пользователя?
6. Предусмотрена ли возможность кастомизации интерфейса и бизнес-логики под наши процессы?
7. Какой минимальный объём внедрения (по стоимости или количеству пользователей) вы рассматриваете?
ответ: Конечно! Вот ответы на вопросы предпринимателя, составленные на основе документации к продукту DApp for Business:
---
### 1. Как реализована поддержка и обновления: если решение полностью локальное, как будут устанавливаться апдейты и исправления? Это делается через удалённый доступ, или вы предоставляете инструкции для нашей IT-команды?
**Ответ:**
Обновления предоставляются бесплатно в течение 5 лет. Программное обеспечение устанавливается и работает полностью локально, без необходимости постоянного интернет-доступа. Для установки обновлений вы можете использовать предоставленные bash-скрипты (`setup.sh`, `clean-logs.sh`) и инструкции из документации. При необходимости можно открыть доступ к сервису для интернет-пользователей (например, через проброс портов или прокси), но это не обязательно. Все инструкции по обновлению и обслуживанию доступны вашей IT-команде, удалённый доступ не требуется.
---
### 2. Какой механизм резервного копирования и восстановления данных предусмотрен в вашем решении?
**Ответ:**
В документации прямо не описан отдельный модуль резервного копирования, однако, поскольку все данные хранятся локально (или на вашем облачном сервере), вы полностью контролируете процесс бэкапа. Используются стандартные базы данных (`pg` — PostgreSQL), для которых легко настраиваются регулярные резервные копии с помощью штатных инструментов PostgreSQL или через Docker-скрипты. Также можно использовать bash-скрипты из папки `scripts/` для автоматизации резервного копирования и восстановления.
---
### 3. Если потребуется интеграция с внешними сервисами (например, платёжные шлюзы, государственные системы учёта), возможно ли это реализовать на вашей платформе?
**Ответ:**
Да, гибкая интеграция с внешними сервисами и кошельками поддерживается. Приложение масштабируемо и не зависит от традиционных банковских систем. В разделе "Модули" можно подключать дополнительные смарт-контракты, в том числе для приёма платежей, токенизации активов и других задач. Также реализована возможность публикации и интеграции с внешними платформами через API (например, соцсети, мессенджеры, внешние сервисы учёта).
---
### 4. Какой минимальный и рекомендуемый состав IT-специалистов нужен для поддержки вашего ПО на стороне клиента?
**Ответ:**
Для базовой эксплуатации достаточно одного системного администратора или DevOps-специалиста, знакомого с Docker, Linux и базовыми инструментами Node.js/PostgreSQL. Вся установка и обслуживание автоматизированы скриптами и не требуют глубоких знаний в программировании. Для расширенной кастомизации или интеграции с внешними сервисами может потребоваться разработчик с опытом работы с Node.js, смарт-контрактами (Solidity) и API.
---
### 5. Какой порядок лицензирования используемых вами open-source библиотек и SDK? Нет ли рисков для конечного пользователя?
**Ответ:**
Программное обеспечение распространяется по лицензии MIT, что гарантирует отсутствие ограничений для конечного пользователя. Все используемые библиотеки (например, OpenZeppelin, LangChain, Express, PostgreSQL и др.) также имеют открытые лицензии (MIT, Apache 2.0 и аналогичные), что исключает юридические риски для вашего бизнеса.
---
### 6. Предусмотрена ли возможность кастомизации интерфейса и бизнес-логики под наши процессы?
**Ответ:**
Да, архитектура приложения модульная и предусматривает возможность кастомизации. Вы можете добавлять собственные таблицы в базу данных через веб-интерфейс, подключать новые модули смарт-контрактов, настраивать параметры бизнеса, интегрировать свои ИИ-модели и дообучать их на ваших данных. Интерфейс реализован на Vue.js и может быть доработан под ваши задачи.
---
### 7. Какой минимальный объём внедрения (по стоимости или количеству пользователей) вы рассматриваете?
**Ответ:**
В документации не указаны ограничения по минимальному объёму внедрения или количеству пользователей. Продукт ориентирован как на индивидуальных предпринимателей, так и на малый и средний бизнес, стартапы и фрилансеров. Вы можете начать с одного пользователя и масштабировать решение по мере роста бизнеса.