system/elements/README.md

Elements — Атомарные элементы

Уровень: L4 (Компоненты)
Статус: planned

НАЗНАЧЕНИЕ

Неделимые единицы взаимодействия с внешним миром.
Каждый элемент = один протокол/сервис.

ЭЛЕМЕНТЫ (план)

Элемент Файл Назначение
Email email.py SMTP/IMAP
HTTP http.py HTTP-запросы
Telegram telegram.py Telegram Bot API
PostgreSQL postgresql.py БД PostgreSQL
SQLite sqlite.py БД SQLite
S3 s3.py S3-совместимые хранилища
File file.py Файловая система
Redis redis.py Redis

ИНТЕРФЕЙС

Каждый элемент реализует базовый интерфейс:

class Element:
    def connect(self, config: dict) -> bool
    def execute(self, action: str, params: dict) -> Result
    def disconnect(self) -> None

ПРИНЦИПЫ

  1. Один элемент = один протокол
  2. Без бизнес-логики
  3. Конфигурация через dict
  4. Возврат унифицированного Result

Версия: 0.1.0 (план)