ai-mini-box-core 5.0.0__tar.gz

ai_mini_box_core-5.0.0/.gitignore

@@ -0,0 +1,15 @@
+# TAUSIK
+.tausik/
+
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.env
+*.db
+migrations/versions/
+!migrations/versions/.gitkeep
+data/
+.DS_Store

ai_mini_box_core-5.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kibertum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai_mini_box_core-5.0.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: ai-mini-box-core
+Version: 5.0.0
+Summary: AI mini box core — system core for small business automation
+Project-URL: Homepage, https://github.com/Kibertum/ai-mini-box
+Project-URL: Repository, https://github.com/Kibertum/ai-mini-box
+Project-URL: Documentation, https://github.com/Kibertum/ai-mini-box
+License: MIT License
+        
+        Copyright (c) 2026 Kibertum
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.12
+Requires-Dist: alembic>=1.13
+Requires-Dist: cryptography>=42
+Requires-Dist: loguru>=0.7
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest-xdist>=3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AI mini box
+
+[![CI](https://github.com/Kibertum/ai-mini-box/actions/workflows/tests.yml/badge.svg)](https://github.com/Kibertum/ai-mini-box/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/ai-mini-box-core)](https://pypi.org/project/ai-mini-box-core/)
+[![Python](https://img.shields.io/pypi/pyversions/ai-mini-box-core)](https://pypi.org/project/ai-mini-box-core/)
+[![License](https://img.shields.io/github/license/Kibertum/ai-mini-box)](LICENSE)
+
+Системное ядро для автоматизации малого бизнеса. Управление контактами, продуктами, заказами, сообщениями через единый CLI и плагинную систему сервисов.
+
+## Установка
+
+```bash
+pip install ai-mini-box-core
+```
+
+Для разработки — с тестовыми зависимостями:
+
+```bash
+git clone https://github.com/Kibertum/ai-mini-box
+cd ai-mini-box
+pip install -e packages/core[dev]
+pip install -e packages/demo[dev]    # пример сервиса
+```
+
+## Быстрый старт
+
+```bash
+# Инициализация проекта
+ai-mini-box init
+
+# Проверка БД
+ai-mini-box check-db
+
+# Настройка
+ai-mini-box config show
+ai-mini-box config set telegram_bot_token "your_token"
+ai-mini-box config set poll_interval 15
+ai-mini-box config unset poll_interval
+```
+
+## Команды CLI
+
+| Команда | Описание |
+|---------|----------|
+| `init` | Создать config.json, БД, директории data/ |
+| `check-db` | Проверить подключение к БД и схему |
+| `config show` | Показать конфигурацию (с группировкой по секциям) |
+| `config set <key> <value>` | Установить значение (чувствительные поля шифруются) |
+| `config unset <key>` | Сбросить на значение по умолчанию |
+
+Плагины (сервисы) регистрируют свои команды через entry points:
+
+| Команда (из demo) | Описание |
+|---|---|
+| `demo-list` | Список контактов |
+| `demo-get <id>` | Контакт по ID |
+| `demo-add <name> <phone>` | Добавить контакт |
+
+Опции: `--verbose`, `--help` доступны для всех команд.
+
+## Архитектура
+
+```
+ai_mini_box/
+├── core/                  # Слой домена
+│   ├── models.py          # Pydantic-модели (Contact, Product, Message, Order)
+│   ├── repositories.py    # ABC репозиториев + QueryBuilder
+│   ├── container.py       # RepoContainer + AppContext (DI)
+│   └── exceptions.py      # Кастомные исключения
+├── infrastructure/        # Слой инфраструктуры
+│   ├── database.py        # SQLAlchemy engine, session, get_db()
+│   ├── config.py          # JsonConfigManager с шифрованием
+│   ├── logger.py          # Loguru-логгер
+│   ├── orm_models.py      # SQLAlchemy ORM-модели
+│   ├── mapping.py         # Мапперы Pydantic ↔ ORM
+│   └── repositories/      # SQLAlchemy-реализации репозиториев
+└── cli.py                 # Typer CLI + плагинная загрузка
+```
+
+**Слои:** `core/` (Pydantic + ABC) → `infrastructure/` (SQLAlchemy + файлы) → `tools/` (CLI-сервисы через entry points).
+
+## Разработка сервиса
+
+См. [docs/developer-guide.md](docs/developer-guide.md).
+
+## Сервисы (инструменты)
+
+Проект включает 30 спецификаций сервисов в `tool-*.md` — от телеграм-бота и email до CRM-синхронизации и юристов. Каждый сервис — отдельный Python-пакет, подключаемый через entry point `ai_mini_box.tools`.
+
+## Тестирование
+
+```bash
+pytest packages/core/tests/ packages/demo/tests/ -v
+```
+
+Текущий статус: **72 теста, все зелёные** (63 core + 9 demo).
+
+## Лицензия
+
+MIT

ai_mini_box_core-5.0.0/README.md

@@ -0,0 +1,100 @@
+# AI mini box
+
+[![CI](https://github.com/Kibertum/ai-mini-box/actions/workflows/tests.yml/badge.svg)](https://github.com/Kibertum/ai-mini-box/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/pypi/v/ai-mini-box-core)](https://pypi.org/project/ai-mini-box-core/)
+[![Python](https://img.shields.io/pypi/pyversions/ai-mini-box-core)](https://pypi.org/project/ai-mini-box-core/)
+[![License](https://img.shields.io/github/license/Kibertum/ai-mini-box)](LICENSE)
+
+Системное ядро для автоматизации малого бизнеса. Управление контактами, продуктами, заказами, сообщениями через единый CLI и плагинную систему сервисов.
+
+## Установка
+
+```bash
+pip install ai-mini-box-core
+```
+
+Для разработки — с тестовыми зависимостями:
+
+```bash
+git clone https://github.com/Kibertum/ai-mini-box
+cd ai-mini-box
+pip install -e packages/core[dev]
+pip install -e packages/demo[dev]    # пример сервиса
+```
+
+## Быстрый старт
+
+```bash
+# Инициализация проекта
+ai-mini-box init
+
+# Проверка БД
+ai-mini-box check-db
+
+# Настройка
+ai-mini-box config show
+ai-mini-box config set telegram_bot_token "your_token"
+ai-mini-box config set poll_interval 15
+ai-mini-box config unset poll_interval
+```
+
+## Команды CLI
+
+| Команда | Описание |
+|---------|----------|
+| `init` | Создать config.json, БД, директории data/ |
+| `check-db` | Проверить подключение к БД и схему |
+| `config show` | Показать конфигурацию (с группировкой по секциям) |
+| `config set <key> <value>` | Установить значение (чувствительные поля шифруются) |
+| `config unset <key>` | Сбросить на значение по умолчанию |
+
+Плагины (сервисы) регистрируют свои команды через entry points:
+
+| Команда (из demo) | Описание |
+|---|---|
+| `demo-list` | Список контактов |
+| `demo-get <id>` | Контакт по ID |
+| `demo-add <name> <phone>` | Добавить контакт |
+
+Опции: `--verbose`, `--help` доступны для всех команд.
+
+## Архитектура
+
+```
+ai_mini_box/
+├── core/                  # Слой домена
+│   ├── models.py          # Pydantic-модели (Contact, Product, Message, Order)
+│   ├── repositories.py    # ABC репозиториев + QueryBuilder
+│   ├── container.py       # RepoContainer + AppContext (DI)
+│   └── exceptions.py      # Кастомные исключения
+├── infrastructure/        # Слой инфраструктуры
+│   ├── database.py        # SQLAlchemy engine, session, get_db()
+│   ├── config.py          # JsonConfigManager с шифрованием
+│   ├── logger.py          # Loguru-логгер
+│   ├── orm_models.py      # SQLAlchemy ORM-модели
+│   ├── mapping.py         # Мапперы Pydantic ↔ ORM
+│   └── repositories/      # SQLAlchemy-реализации репозиториев
+└── cli.py                 # Typer CLI + плагинная загрузка
+```
+
+**Слои:** `core/` (Pydantic + ABC) → `infrastructure/` (SQLAlchemy + файлы) → `tools/` (CLI-сервисы через entry points).
+
+## Разработка сервиса
+
+См. [docs/developer-guide.md](docs/developer-guide.md).
+
+## Сервисы (инструменты)
+
+Проект включает 30 спецификаций сервисов в `tool-*.md` — от телеграм-бота и email до CRM-синхронизации и юристов. Каждый сервис — отдельный Python-пакет, подключаемый через entry point `ai_mini_box.tools`.
+
+## Тестирование
+
+```bash
+pytest packages/core/tests/ packages/demo/tests/ -v
+```
+
+Текущий статус: **72 теста, все зелёные** (63 core + 9 demo).
+
+## Лицензия
+
+MIT

ai_mini_box_core-5.0.0/ai_mini_box/__main__.py

@@ -0,0 +1,3 @@
+from .cli import app
+
+app()

ai_mini_box_core-5.0.0/ai_mini_box/cli.py

@@ -0,0 +1,178 @@
+import importlib.metadata
+import json
+import os
+from pathlib import Path
+
+import typer
+
+from ai_mini_box.infrastructure.database import get_db, init_db
+
+app = typer.Typer(
+    name="ai-mini-box",
+    help="AI mini box — automation of small business",
+    no_args_is_help=True,
+    pretty_exceptions_short=os.environ.get("AI_BOX_VERBOSE") != "1",
+)
+
+
+@app.callback()
+def main_callback(
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose output"),
+):
+    if verbose:
+        os.environ["AI_BOX_VERBOSE"] = "1"
+config_app = typer.Typer(help="Manage configuration")
+app.add_typer(config_app, name="config")
+
+
+@app.command()
+def init(
+    force: bool = typer.Option(False, "--force", help="Overwrite existing config"),
+    config_path: str = typer.Option("data/config.json", "--config", help="Config path"),
+    db_path: str = typer.Option("data/app.db", "--db", help="Database path"),
+):
+    """Initialize project: create config, database, directories."""
+    from ai_mini_box.infrastructure.config import JsonConfigManager
+
+    dirs = [Path("data"), Path("data/backup"), Path("data/models"), Path("data/training")]
+    for d in dirs:
+        d.mkdir(parents=True, exist_ok=True)
+        typer.echo(f"  Created: {d}")
+
+    cfg_path = Path(config_path)
+    if not cfg_path.exists() or force:
+        manager = JsonConfigManager(cfg_path)
+        manager.save(manager.load())
+        typer.echo(f"  Created: {cfg_path}" + (" (overwritten)" if force else ""))
+
+    init_db(db_path)
+    typer.echo(f"  Created: {db_path}")
+    typer.echo("Done.")
+
+
+@app.command()
+def check_db():
+    """Check database connection and schema."""
+    try:
+        from sqlalchemy import text
+
+        with get_db() as session:
+            result = session.execute(text("SELECT 1"))
+            val = result.scalar()
+            if val == 1:
+                typer.echo("  Database: connected")
+            from ai_mini_box.infrastructure.database import Base
+
+            tables = list(Base.metadata.tables.keys())
+            typer.echo(f"  Tables: {', '.join(tables) if tables else 'none'}")
+    except Exception as e:
+        typer.echo(f"  Database: ERROR - {e}")
+        raise typer.Exit(code=1)
+
+
+@config_app.command(name="show")
+def config_show(
+    config_path: str = typer.Option("data/config.json", "--config", help="Config path"),
+):
+    """Show current configuration grouped by sections."""
+    from ai_mini_box.infrastructure.config import AppConfig, JsonConfigManager, SENSITIVE_FIELDS
+
+    manager = JsonConfigManager(config_path)
+    config = manager.load()
+
+    env_overrides = _detect_env_overrides(config)
+
+    groups: dict[str, list[tuple[str, Any, bool]]] = {}
+    for key in AppConfig.model_fields:
+        section = AppConfig.guess_section(key)
+        value = getattr(config, key)
+        is_env = key in env_overrides
+        masked = _mask_value(key, str(value)) if key in SENSITIVE_FIELDS and value else str(value)
+        groups.setdefault(section, []).append((key, masked, is_env))
+
+    for section in sorted(groups, key=_section_order):
+        typer.echo(typer.style(f"[{section}]", bold=True, fg=typer.colors.CYAN))
+        for key, value, is_env in groups[section]:
+            suffix = typer.style(" (env)", dim=True, fg=typer.colors.YELLOW) if is_env else ""
+            typer.echo(f"  {key} = {value}{suffix}")
+
+
+@config_app.command(name="set")
+def config_set(
+    key: str = typer.Argument(..., help="Config key"),
+    value: str = typer.Argument(..., help="Config value"),
+    config_path: str = typer.Option("data/config.json", "--config", help="Config path"),
+):
+    """Set a config value."""
+    from ai_mini_box.infrastructure.config import JsonConfigManager, SENSITIVE_FIELDS
+
+    manager = JsonConfigManager(config_path)
+    try:
+        manager.set(key, value)
+    except ValueError as e:
+        typer.echo(typer.style(f"Error: {e}", fg=typer.colors.RED))
+        raise typer.Exit(code=1)
+
+    label = f"{key} = {value}"
+    if key in SENSITIVE_FIELDS:
+        label = f"{key} = ***"
+    typer.echo(typer.style(f"  Updated: {label}", fg=typer.colors.GREEN))
+
+
+@config_app.command(name="unset")
+def config_unset(
+    key: str = typer.Argument(..., help="Config key to reset to default"),
+    config_path: str = typer.Option("data/config.json", "--config", help="Config path"),
+):
+    """Reset a config key to its default value."""
+    from ai_mini_box.infrastructure.config import JsonConfigManager
+
+    manager = JsonConfigManager(config_path)
+    try:
+        changed = manager.unset(key)
+    except ValueError as e:
+        typer.echo(typer.style(f"Error: {e}", fg=typer.colors.RED))
+        raise typer.Exit(code=1)
+
+    if changed:
+        typer.echo(typer.style(f"  Reset: {key} to default", fg=typer.colors.GREEN))
+    else:
+        typer.echo(f"  {key} already at default")
+
+
+def _mask_value(key: str, value: str) -> str:
+    if len(value) <= 4:
+        return "****"
+    return value[:2] + "*" * (len(value) - 5) + value[-3:]
+
+
+def _detect_env_overrides(config) -> set[str]:
+    from ai_mini_box.infrastructure.config import AppConfig
+
+    overrides = set()
+    prefix = "AI_BOX_"
+    for field_name in AppConfig.model_fields:
+        env_key = f"{prefix}{field_name.upper()}"
+        if os.environ.get(env_key) is not None:
+            overrides.add(field_name)
+    return overrides
+
+
+_SECTION_ORDER = {
+    "Telegram": 1, "Email": 2, "LLM": 3, "Schedule": 4,
+    "WhatsApp": 5, "Notifications": 6, "SMS": 7,
+    "YooKassa": 8, "Tinkoff": 9, "Sber": 10, "General": 11,
+}
+
+
+def _section_order(s: str) -> int:
+    return _SECTION_ORDER.get(s, 99)
+
+
+for ep in importlib.metadata.entry_points(group="ai_mini_box.tools"):
+    try:
+        register_func = ep.load()
+        if callable(register_func):
+            register_func(app)
+    except Exception as e:
+        typer.echo(f"Warning: failed to load tool {ep.name}: {e}", err=True)

ai_mini_box_core-5.0.0/ai_mini_box/core/container.py

@@ -0,0 +1,40 @@
+from dataclasses import dataclass, field
+from typing import Optional
+
+from sqlalchemy.orm import Session
+
+from ai_mini_box.infrastructure.repositories import (
+    SqliteContactRepo,
+    SqliteMessageRepo,
+    SqliteOrderRepo,
+    SqliteProductRepo,
+)
+
+
+class RepoContainer:
+    def __init__(self, session: Session):
+        self._session = session
+        self.contacts = SqliteContactRepo(session)
+        self.products = SqliteProductRepo(session)
+        self.messages = SqliteMessageRepo(session)
+        self.orders = SqliteOrderRepo(session)
+
+
+@dataclass
+class AppContext:
+    repos: RepoContainer
+    config_path: str = "data/config.json"
+    verbose: bool = False
+
+    _instance: Optional["AppContext"] = field(default=None, repr=False)
+
+    @classmethod
+    def init(cls, repos: RepoContainer, **kwargs) -> "AppContext":
+        cls._instance = cls(repos=repos, **kwargs)
+        return cls._instance
+
+    @classmethod
+    def get(cls) -> "AppContext":
+        if cls._instance is None:
+            raise RuntimeError("AppContext not initialized. Call AppContext.init() first.")
+        return cls._instance

ai_mini_box_core-5.0.0/ai_mini_box/core/exceptions.py

@@ -0,0 +1,15 @@
+class AppError(Exception):
+    def __init__(self, message: str, exit_code: int = 1):
+        self.message = message
+        self.exit_code = exit_code
+        super().__init__(message)
+
+
+class NotFoundError(AppError):
+    def __init__(self, entity: str, id: int):
+        super().__init__(f"{entity} with id {id} not found", exit_code=2)
+
+
+class ConfigError(AppError):
+    def __init__(self, message: str):
+        super().__init__(message, exit_code=3)

ai_mini_box_core-5.0.0/ai_mini_box/core/models.py

@@ -0,0 +1,78 @@
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class Topic(str, Enum):
+    PRICES = "Цены"
+    ORDER = "Заказ"
+    COMPLAINT = "Жалоба"
+    SCHEDULE = "График"
+    OTHER = "Другое"
+
+
+class MessageSource(str, Enum):
+    TELEGRAM = "telegram"
+    EMAIL = "email"
+    WHATSAPP = "whatsapp"
+    SMS = "sms"
+    MANUAL = "manual"
+
+
+class OrderStatus(str, Enum):
+    NEW = "new"
+    PROCESSING = "processing"
+    COMPLETED = "completed"
+    CANCELLED = "cancelled"
+
+
+class Contact(BaseModel):
+    id: Optional[int] = None
+    name: str = ""
+    phone: Optional[str] = None
+    email: Optional[str] = None
+    telegram: Optional[str] = None
+    whatsapp: Optional[str] = None
+    source: MessageSource = MessageSource.MANUAL
+    notes: Optional[str] = None
+    total_spent: int = 0
+    created_at: datetime = Field(default_factory=datetime.now)
+    updated_at: datetime = Field(default_factory=datetime.now)
+
+
+class Product(BaseModel):
+    id: Optional[int] = None
+    name: str = ""
+    description: Optional[str] = None
+    price_kopecks: int = 0
+    stock: int = 0
+    unit: str = "шт"
+    category: Optional[str] = None
+    created_at: datetime = Field(default_factory=datetime.now)
+    updated_at: datetime = Field(default_factory=datetime.now)
+
+
+class Message(BaseModel):
+    id: Optional[int] = None
+    source: MessageSource = MessageSource.MANUAL
+    external_id: Optional[str] = None
+    chat_id: Optional[str] = None
+    contact_id: Optional[int] = None
+    text: str = ""
+    topic: Optional[Topic] = None
+    draft_response: Optional[str] = None
+    sent_response: bool = False
+    received_at: datetime = Field(default_factory=datetime.now)
+
+
+class Order(BaseModel):
+    id: Optional[int] = None
+    contact_id: Optional[int] = None
+    status: OrderStatus = OrderStatus.NEW
+    total_kopecks: int = 0
+    notes: Optional[str] = None
+    source_message_id: Optional[int] = None
+    created_at: datetime = Field(default_factory=datetime.now)
+    updated_at: datetime = Field(default_factory=datetime.now)