Roadmap

Эта страница показывает не только список задач, но и инженерный вектор развития NextLib: что уже стабильно, где идёт расширение и какие критерии качества используются.

1. Текущий статус платформы

Базовые модули — реализованы

• Command API
• Item API + PDC helpers
• Color API
• Config Manager
• GUI API (YAML + actions + conditions)
• Dynamic Database + HikariCP

Расширенный data слой — реализован

• Query operators (IN, BETWEEN, LIKE, STARTS_WITH, CONTAINS, ...)
• Relation annotations (ManyToOne, OneToMany, ...)
• Include graph execution
• Auto migration manager
• SQL migration runner
• Entity validation/indexing/conversion annotations (NotNull, Size, Min/Max, Pattern, Email, Index, Unique, Convert)

Платформенные модули — реализованы

• NextLibContext
• Reload API
• Observability API
• I18n API
• Messaging API
• Validation API
• Quests API
• Utilities API

2. Ближайшие направления (near-term)

2.1 Dynamic Database evolution

• Более гибкий контроль eager/lazy include стратегий.
• Улучшенная диагностика SQL/mapper ошибок.
• Сценарии безопасной эволюции schema для сложных миграций.

Цель: сохранить простоту API при росте нагрузки и сложности модели данных.

2.2 GUI API hardening

• Более строгая валидация YAML-конфигов до runtime.
• Улучшение DX для больших каталогов меню.
• Расширение встроенных actions/conditions.

Цель: снизить количество runtime ошибок в GUI-конфигурациях.

2.3 Quests and gameplay systems

• Расширение набора objective types.
• Улучшение адаптеров под Bukkit-события.
• Улучшение инструментов восстановления/миграции прогресса.

Цель: сделать контентные механики масштабируемыми для больших серверов.

2.4 Operational maturity

• Богаче метрики и отчётность reload операций.
• Улучшение health-check наборов по умолчанию.
• Рекомендации и шаблоны production-эксплуатации.

Цель: уменьшить MTTR при инцидентах.

3. Mid-term вектор

• Более строгая контрактная документация по API уровням.
• Улучшение генерации reference-доков по исходникам.
• Дополнительные tooling сценарии для миграций и диагностики.

4. Что считается «готовым» для функции

Фича считается зрелой, когда:

1. есть стабильный API-контракт;
2. есть покрывающая документация;
3. есть практические сценарии и troubleshooting;
4. есть понятная миграция между версиями.

5. Нефункциональные приоритеты

Помимо новых модулей, NextLib продолжает держать фокус на:

• предсказуемость поведения в runtime;
• совместимость и понятную эволюцию API;
• читаемость и простоту внедрения;
• наблюдаемость и эксплуатационную устойчивость.

6. Рекомендации для пользователей библиотеки

Чтобы апдейты проходили спокойно:

1. обновляйте поэтапно (staging -> production);
2. проверяйте release notes и changelog;
3. прогоняйте smoke tests на командах/GUI/БД;
4. поддерживайте собственные миграционные сценарии для критичных данных.

7. Главная инженерная цель проекта

Сохранить философию NextLib:

• минимум инфраструктурного кода в конечном плагине;
• максимум ясного и поддерживаемого доменного кода;
• возможность расти от маленького проекта до production-нагруженной системы без полной архитектурной переработки.

Roadmap будет расширяться по мере появления новых модулей и стабилизации следующих версий.