architect/_archive/2025-11-26-cleanup/registry/README.md

CODE SOURCES REGISTRY

Версия: 1.0-mvp
Дата создания: 2025-11-10
Статус: Активен

ЧТО ЭТО?

Централизованный справочник всех источников кода для экономии токенов.

Цель: Использовать готовый код вместо генерации с нуля.


СТРУКТУРА

registry/
├── README.md               # Этот файл
├── GLOSSARY.yaml           # Терминология (17 терминов)
├── INDEX.yaml              # Главный каталог (13 библиотек)

├── index/                  # Индексы для быстрого поиска
   └── by-function.yaml    # Поиск по функциональности (18 функций)

├── external/               # Внешние библиотеки
   └── docs/               # Документация библиотек

├── internal/               # Наши компоненты (TODO)
└── archive/                # Архивные источники (TODO)

БЫСТРЫЙ СТАРТ

Перед генерацией кода:

# 1. Читать главный индекс
cat registry/INDEX.yaml

# 2. Искать по функциональности
grep -A 10 "authentication:" registry/index/by-function.yaml

# 3. Использовать найденное!

Приоритет источников:

1. EXTERNAL LIBRARY    95-99% экономии (просто import)
2. INTERNAL COMPONENT  70-90% экономии (копировать)
3. PROJECT CODE        50-70% экономии (извлечь)
4. ARCHIVE CODE        30-50% экономии (адаптировать)
5. GENERATE NEW        0% экономии (последний вариант!)

СТАТИСТИКА

Задокументировано:
- 13 external libraries
- 18 функциональных категорий
- 17 терминов

Экономия:
- Средняя: 70-80% токенов
- Пример: Excel export 1500 → 250 tokens (83%)


ИСПОЛЬЗОВАНИЕ

Пример 1: Нужна авторизация

# Поиск
grep -A 20 "authentication:" registry/index/by-function.yaml

# Найдено:
# - streamlit-authenticator (external, готово)
# - marketplace/core/auth.py (project code)

# Использование:
pip install streamlit-authenticator
# ИЛИ
cp projects/marketplace/core/auth.py my-project/

Пример 2: Нужна таблица с данными

# Поиск
grep -A 15 "table_display:" registry/index/by-function.yaml

# Найдено:
# - st.dataframe (встроен)
# - streamlit-aggrid (external)
# - marketplace/pages/03_Orders.py (project code)

# Использование:
# Копировать паттерн из Orders.py

ПРАВИЛА

Читай: /opt/claude-workspace/platform/modes/code.md

Главное правило:

ВСЕГДА искать в реестре ПЕРЕД генерацией!

TODO (Следующие шаги)

Этап 2: Расширение (4-6 часов)

Этап 3: Интеграция (2 часа)

Этап 4: Автоматизация (будущее)


ССЫЛКИ


КОНТАКТЫ

Вопросы и предложения: обновлять INDEX.yaml по мере добавления источников.

Дата последнего обновления: 2025-11-10