architect/standards/arch-library-structure.md

type: standard
layer: arch
object: library
aspect: structure
form: text
title: "Структура library/"
status: active
version: 1.0.0
date: 2026-04-15
knowledge_level: У1
parent: arch-platform-structure.md

Структура library/

Компонент ЧТО МЫ ИСПОЛЬЗУЕМ — пассивные знания: коннекторы, компоненты, функции.

1. ВОПРОС КОМПОНЕНТА

Что мы можем взять готовым и использовать в проектах?

library/ — библиотека переиспользуемых артефактов. В отличие от system/ — здесь нет живых процессов и реальных токенов. Всё пассивное: шаблоны, код-заготовки, функции.

2. СТРУКТУРА

library/
├── connectors/     Коннекторы к внешним сервисам (шаблоны)
├── components/     Переиспользуемые UI/UX компоненты
├── functions/      Утилитарные функции
├── adapters/       Адаптеры форматов и протоколов
├── models/         Модели данных
├── parsers/        Парсеры форматов
├── primitives/     Базовые типы и константы
├── storages/       Абстракции хранилищ
├── integrations/   Готовые интеграции (сложнее коннекторов)
└── services/       Вспомогательные сервисы (не платформенные)

3. КОННЕКТОРЫ (connectors/)

Коннектор — шаблон подключения к внешнему сервису. Токены заглушены.

connectors/
├── telegram/
│   ├── connector.py      — код подключения
│   ├── config.example.yaml  — шаблон конфига с {{TOKEN}}
│   └── README.md
├── openrouter/
└── s3/

Правило: коннектор содержит "{{TOKEN}}", "{{API_KEY}}" — никогда реальных значений.
Реальные значения → system/config/ или $DATASPACE.

4. КОМПОНЕНТЫ (components/)

Переиспользуемые блоки: UI-виджеты, Drupal-модули-шаблоны, Python-классы.

components/
├── drupal/
│   └── dru-base-module/   — базовый шаблон Drupal-модуля
├── vue/
│   └── data-table/        — компонент таблицы
└── python/
    └── base-scraper/      — базовый класс скрапера

5. ФУНКЦИИ (functions/)

Атомарные утилиты без внешних зависимостей.

functions/
├── text/
│   ├── transliterate.py
│   └── normalize.py
├── date/
│   └── format.py
└── data/
    └── csv_utils.py

6. РАЗНИЦА library/ VS system/

library/ system/
Состояние пассивное активное
Токены {{TOKEN}} — заглушки реальные значения
Процессы нет запущены
Назначение взять и использовать работает прямо сейчас

7. РАЗНИЦА library/ VS architect/standards/

library/ architect/standards/
Что готовый код / шаблон файлов правила и документы
Форма .py, .yaml, .md-шаблоны .md документы
Уровень У4 (артефакты) У1 (стандарты)

СВЯЗАННЫЕ ДОКУМЕНТЫ