Разработчикам
Разработчикам
Локальное окружение, куда смотреть в коде и какие темы ещё без инструкций.
Портал документации не импортирует пакеты продукта и не требует PostgreSQL, движка и моделей. Этот раздел — карта репозитория, а не второе приложение.
Локально
- Node.js 22.13+, Python 3.12.
- Зависимости TypeScript —
yarn, Python —uv. npm и pip для этого репозитория не используются. - Проверки — цели Nx:
yarn nx run <project>:lint,typecheck,test,build. - Портал:
yarn nx run docs:serve(порт 3002) иyarn nx run docs:build. Перед сборкой Nx снимает OpenAPI цельюapi:export-openapi. База для этого не нужна: сервисы в тестовом модуле заменены заглушками.
Поднять сам продукт — установка и CLI.
Куда смотреть
| Вопрос | Где |
|---|---|
| Границы слоёв | Слои |
| Контракты | Контракты и packages/contracts |
| Агенты и промпты | каталог registry/agents/<id>/, отдельными файлами, с версией semver |
| Пайплайн | packages/pipeline |
| Движок | engine/, слои не импортируют друг друга |
| Тесты без сети | фейковый провайдер моделей и записанные ответы |
Промптов в коде TypeScript быть не должно: их читает загрузчик реестра. Как добавить агента и поднять версию, будет отдельная статья. Менять смысл инструкции без смены версии нельзя.
Что ещё написать
- полный цикл локального окружения с порядком сервисов;
- как устроены кодогенерация Zod → JSON Schema → Pydantic и общие фикстуры;
- как добавлять проверку аудита (два теста: нарушение и соответствие) и не править
docs/AUDIT.mdруками; - как расширять пайплайн, не зашивая имя шаблона.
Тесты продукта должны проходить без GPU и без сети. Платные вызовы моделей из документации не запускаются.