🤖 1C AI Stack

AI-Powered Development Platform для 1С

Комплексная AI-экосистема для автоматизации разработки, тестирования и сопровождения проектов на платформе 1С:Предприятие.

Статус: Production Ready (99% готовности) | Версия: 5.0

🎯 Основные возможности

🔍 Семантический поиск кода

Поиск по смыслу, а не по тексту

Вопрос: "где мы рассчитываем налоги?"
→ Находит все функции с расчетами, даже если слово "налог" не упоминается
→ Векторный поиск через Qdrant
→ Результат за 1-2 секунды

💻 Генерация BSL кода

AI создает код по описанию

Запрос: "создай функцию для расчета скидки по объему покупки"
→ AI генерирует ready-to-use BSL код
→ С документацией и обработкой ошибок
→ Следует best practices 1С

🔗 Анализ зависимостей

Граф связей функций и модулей

Запрос: "покажи что использует функция РассчитатьСкидку"
→ Все вызываемые функции
→ Все места где используется
→ Визуализация в Neo4j

🎤 Голосовые запросы (NEW!)

Говорите вместо ввода текста

🎤 "Найди функцию расчета НДС"
→ Speech-to-Text через OpenAI Whisper
→ Обработка как обычный запрос
→ Поддержка RU + EN языков

📸 OCR документов (NEW!)

Распознавание текста из сканов

📸 Фото договора/накладной/акта
→ OCR через Chandra (83% точность - best in class!)
→ AI извлекает структуру (номер, дата, контрагент, сумма)
→ Готовые данные для ввода в 1С

🌍 Мультиязычность (NEW!)

Работает на русском и английском

RU: "найди функцию..."
EN: "find function..."
→ Полная локализация UI
→ 400+ переводов
→ Легко добавить новые языки

📦 Marketplace (NEW!)

Экосистема расширений

Публикация плагинов
→ Поиск и установка
→ Рейтинги и отзывы
→ Community contributions

🤖 8 AI-Агентов

Специализированные ассистенты

1. AI Architect - архитектурные решения
2. Developer Agent - генерация кода
3. QA Engineer - генерация тестов
4. DevOps Agent - CI/CD оптимизация
5. Business Analyst - анализ требований
6. SQL Optimizer - оптимизация запросов
7. Tech Log Analyzer - анализ логов 1С
8. Security Scanner - поиск уязвимостей

⚡ Быстрый старт

Вариант 1: Telegram Bot (самый простой)

Готово! Бот работает в Telegram.

Полная инструкция →

Вариант 2: Full Stack (с Docker)

Доступно:

• Telegram Bot
• MCP Server: http://localhost:6001
• API: http://localhost:8000
• Neo4j Browser: http://localhost:7474
• Grafana: http://localhost:3000

Полная инструкция →

🔌 Интеграции

Telegram Bot

Zero friction - работает сразу

• Команды:
  /search
  ,
  /generate
  ,
  /deps
• Естественные вопросы
• Голосовые сообщения
• Фото и PDF документы (OCR)

MCP Server (Model Context Protocol)

Для IDE: Cursor, VSCode, Claude Desktop

EDT Plugin

Для Eclipse 1C:EDT

• Semantic Search View
• AI Assistant View
• Code Optimizer View
• Metadata Graph View

REST API

Для кастомных интеграций

🏗️ Архитектура

┌─────────────────── 1C AI STACK ──────────────────────┐
│                                                       │
│  USER INTERFACES:                                    │
│  ├─ Telegram Bot (with Voice + OCR)                 │
│  ├─ MCP Server (Cursor, VSCode)                     │
│  ├─ EDT Plugin (Eclipse)                            │
│  └─ REST API                                        │
│                                                       │
│  AI LAYER:                                           │
│  ├─ AI Orchestrator (intelligent routing)           │
│  ├─ 8 Specialized AI Agents                         │
│  ├─ OpenAI API (GPT-4, Whisper STT)                 │
│  ├─ Ollama (Qwen3-Coder for BSL)                    │
│  └─ Chandra OCR (document recognition)              │
│                                                       │
│  DATA LAYER:                                         │
│  ├─ PostgreSQL (metadata, users, stats)             │
│  ├─ Neo4j (dependency graph)                        │
│  ├─ Qdrant (vector search)                          │
│  ├─ Elasticsearch (full-text search)                │
│  └─ Redis (caching, rate limiting)                  │
│                                                       │
│  INFRASTRUCTURE:                                     │
│  ├─ Docker Compose (local dev)                      │
│  ├─ Kubernetes (production)                         │
│  ├─ CI/CD (GitHub Actions)                          │
│  └─ Monitoring (Prometheus, Grafana, ELK)           │
│                                                       │
└───────────────────────────────────────────────────────┘

📚 Документация

Для начинающих:

• 📗 Getting Started - пошаговая установка
• ❓ FAQ - частые вопросы
• 🎥 Video Guides - видео туториалы

Для продвинутых:

• 🏗️ Architecture - архитектура системы
• 🤖 AI Agents - работа с AI
• 🔧 Configuration - настройка
• 🔌 API - REST API и MCP

Специальные темы:

• 🎤 Voice Queries - голосовые запросы
• 📸 OCR Integration - распознавание документов
• 🌍 i18n Guide - мультиязычность
• 🧠 BSL Fine-tuning - обучение модели

Полный индекс: DOCS_INDEX.md

🎯 Use Cases

1. Разработчик 1С

• Быстрый поиск кода в больших конфигурациях
• Генерация типовых функций
• Анализ зависимостей перед изменениями
• Code review через AI

2. Тимлид

• Онбординг новых разработчиков (быстрые ответы на вопросы)
• Контроль качества кода (автоматический review)
• Визуализация архитектуры (граф зависимостей)
• Документация кодовой базы

3. Архитектор

• Анализ технического долга
• Поиск anti-patterns
• Рефакторинг suggestions
• Architecture decision records

4. Бухгалтер / Менеджер

• OCR сканов документов → автоввод в 1С
• Распознавание накладных/актов/счетов
• Проверка заполненности реквизитов
• Миграция архивов в электронный вид

🛠️ Технологический стек

Backend:

• Python 3.11+ (FastAPI, asyncio)
• PostgreSQL 15 - основная БД
• Neo4j 5.x - граф зависимостей
• Qdrant - векторный поиск
• Elasticsearch 8.x - полнотекстовый поиск
• Redis 7 - кеширование

AI/ML:

• OpenAI API (GPT-4, Whisper STT)
• Ollama - локальные LLM
• Qwen3-Coder - генерация BSL
• Chandra OCR - распознавание документов
• LangChain - AI orchestration
• MLflow - ML experiments tracking

Frontend:

• React + TypeScript (web portal)
• Telegram Bot API (aiogram 3.4)
• Eclipse RCP (EDT plugin)

Infrastructure:

• Docker + Docker Compose - контейнеризация
• Kubernetes - оркестрация
• GitHub Actions - CI/CD
• Prometheus + Grafana - мониторинг
• ELK Stack - логирование

📊 Статус проекта

Готовность: 99%

Production Ready! 🚀

💡 Killer Features

1. Voice + OCR + AI = Уникальная комбинация

Никто в 1С сегменте не предлагает:

• 🎤 Голосовые запросы
• 📸 OCR документов
• 🤖 AI обработка
• 📦 Все в одном боте!

2. Мультиязычность

Международный рынок:

• 🇷🇺 Русский (полный)
• 🇬🇧 English (полный)
• 🌍 Легко добавить KZ, UK, BY

3. Multiple IDE Integration

Работает везде:

• Telegram (mobile + desktop)
• Cursor (AI-first IDE)
• VSCode (популярный)
• EDT (профессиональный для 1С)

4. Open Source + Extensible

Marketplace для расширений:

• Community plugins
• Custom AI agents
• Integrations
• Themes

🚀 Quick Demo

Telegram Bot:

1. /start
   → Привет! Я AI-помощник для 1С

2. /search расчет НДС
   → [10 результатов с релевантностью 95%+]

3. /generate функция для отправки email
   → [Готовый BSL код с документацией]

4. 🎤 Голосовое: "где мы работаем с документами?"
   → [Семантический поиск по голосу]

5. 📸 Фото накладной
   → [OCR: номер, дата, таблица товаров извлечены]

🏗️ Deployment Options

1. Cloud (рекомендуется для старта)

Railway.app:

DigitalOcean App Platform:

2. Docker Compose (рекомендуется для dev)

3. Kubernetes (для production)

4. Minimal (без Docker)

Подробнее: DEPLOYMENT_INSTRUCTIONS.md

🤝 Contributing

Contributions приветствуются!

Как помочь:

• 🐛 Сообщайте о багах (Issues)
• 💡 Предлагайте идеи (Discussions)
• 📝 Улучшайте документацию
• 🌍 Добавляйте переводы
• 🔌 Создавайте плагины

Процесс:

1. Fork проекта
2. Создайте feature branch
3. Commit изменения
4. Откройте Pull Request

Contributing Guide →

📖 Roadmap

✅ Реализовано (2024):

• ✅ Telegram Bot с AI
• ✅ MCP Server (Cursor/VSCode)
• ✅ EDT Plugin (базовый)
• ✅ Voice Queries (Speech-to-Text)
• ✅ Multi-language (RU + EN)
• ✅ Marketplace API
• ✅ OCR Integration (Chandra)
• ✅ 8 AI Agents
• ✅ Full infrastructure (Docker, K8s, CI/CD)
• ✅ Enterprise security (OAuth2, RBAC, Audit)

🎯 Q1 2025:

• Public Launch (1000+ users)
• BSL Fine-tuned model
• EDT Plugin full release
• Beta testing всех features

🚀 Q2-Q3 2025:

• 5,000+ users
• International expansion
• Enterprise clients
• Plugin marketplace активность

Полный Roadmap →

🌟 Highlights

Что делает этот проект особенным:

1. First-in-class - первый AI инструмент для 1С такого уровня
2. Production Ready - 99% готовности, не proof-of-concept
3. Comprehensive - полный стек (от Telegram до Kubernetes)
4. Innovative - Voice + OCR + AI (уникальная комбинация)
5. Open Source - MIT license, free для всех
6. Well Documented - 100+ документов, примеры, guides
7. Tested - 15,000+ строк тестов
8. International - RU + EN support

📊 Metrics

Проект:

• 50,000+ строк кода
• 15,000+ строк тестов
• 100+ документов
• 18 Docker сервисов
• 8 AI агентов
• 5 интеграций (Telegram, MCP, EDT, REST, Web)
• 2 языка (RU + EN)

Performance:

• 99.9% uptime target
• <2 сек средний ответ
• 85%+ code quality
• 83% OCR accuracy (Chandra)
• 95% voice recognition (Whisper)

📝 License

MIT License - используйте свободно!

См. LICENSE для полного текста лицензии.

📜 Disclaimers & Legal

Торговые марки

Этот проект использует следующие торговые марки исключительно для обозначения совместимости и технической интеграции:

• 1С:Предприятие - зарегистрированная торговая марка фирмы "1С"
• OpenAI, GPT-4, Whisper - торговые марки OpenAI, Inc.
• Neo4j - торговая марка Neo4j, Inc.
• PostgreSQL - торговая марка PostgreSQL Global Development Group
• Qdrant - торговая марка Qdrant Solutions GmbH
• Docker - торговая марка Docker, Inc.
• Kubernetes - торговая марка The Linux Foundation

Данный проект НЕ является официальным продуктом перечисленных компаний и не связан с ними. Все торговые марки принадлежат их соответствующим владельцам.

Использование 1С:Предприятие

Для работы с конфигурациями 1С:Предприятие у вас должна быть легальная лицензия на платформу 1С:Предприятие, приобретенная через официальные каналы фирмы "1С".

Данный проект:

• ✅ НЕ включает платформу 1С:Предприятие
• ✅ НЕ включает коммерческие конфигурации 1С
• ✅ Предоставляет только инструменты разработки
• ✅ Требует наличия легальной лицензии 1С у пользователя

Коммерческие API

Некоторые функции требуют API ключей от коммерческих сервисов:

• OpenAI API - для генерации кода, голосовых запросов (Whisper STT)
  • Требует регистрации и оплаты на https://platform.openai.com/
  • Альтернатива: Можно использовать локальные модели (Qwen, Whisper local, Vosk)

Все коммерческие зависимости опциональны. Проект может работать с open-source альтернативами.

Лицензии сторонних компонентов

Проект использует только открытые библиотеки с совместимыми лицензиями:

• MIT License (большинство зависимостей)
• Apache License 2.0 (aiohttp, prometheus-client)
• BSD License (httpx, click)

Полный список зависимостей см. в

Все зависимости проверены на совместимость с MIT License.

🙏 Credits

Open Source проекты:

• Chandra OCR - Document OCR
• Qwen - Base LLM
• aiogram - Telegram framework
• Neo4j - Graph database
• Qdrant - Vector search

1С Community:

• BSL Language Server
• OpenYellow.org
• Infostart.ru

📞 Контакты

• 💬 GitHub Discussions - Вопросы и обсуждения
• 🐛 Issues - Баги и feature requests
• ⭐ GitHub - Поставьте звезду!

🚀 Getting Started

Новичок? Начните здесь:

1. Getting Started Guide
2. FAQ
3. Quick Start

Разработчик? Смотрите:

1. Architecture
2. Contributing
3. API Docs

DevOps? Читайте:

1. Deployment
2. Kubernetes
3. Monitoring

⭐ Если проект полезен - поставьте звезду на GitHub!

🚀 Ready to start? → GETTING_STARTED.md