# 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. Какой минимальный объём внедрения (по стоимости или количеству пользователей) вы рассматриваете? **Ответ:** В документации не указаны ограничения по минимальному объёму внедрения или количеству пользователей. Продукт ориентирован как на индивидуальных предпринимателей, так и на малый и средний бизнес, стартапы и фрилансеров. Вы можете начать с одного пользователя и масштабировать решение по мере роста бизнеса.