# Аудит курсової PaperScope | Пункт | Що реалізовано | Де в коді чи звіті | Де показати у вебінтерфейсі | Результат перевірки | |---|---|---|---|---| | 3. Архітектура | Браузер → FastAPI → QueryService → ReadRepository → MongoRepository → mongos | `architecture.md` | `/#defense-3` | Виконано за кодом або збереженим доказом. | | 4. Порти та моделі | Контролер приймає SearchQuery, домен описує Article, адаптер відображає документ MongoDB. | `application/ports.py` | `/#defense-4` | Частково: порт підтримує створення, читання й службові зміни стану. Предметне видалення і редагування статей відсутні за моделлю append-only. | | 5. Перегляд архітектури | Звірте фінальні схеми компонентів і класів із кодом. | `architecture.md` | `/#defense-5` | Виконано за кодом або збереженим доказом. | | 6. Контейнери | Docker Compose → застосунок → mongos → шарди. Журнал зберігається на хості. | `results/clean-start.json` | `/#defense-6` | Виконано за кодом або збереженим доказом. | | 7. SQL і NoSQL | Порівняйте документне зберігання з реляційною альтернативою. | `decisions.md` | `/#defense-7` | Виконано за кодом або збереженим доказом. | | 8. CAP | Перевірте готовність залежностей і прочитайте, як поводиться система при відмові. | `cap-and-failures.md` | `/#defense-8` | Виконано за кодом або збереженим доказом. | | 9. Сховища | MongoDB зберігає статті, OpenSearch індексує текст, Redis кешує видачу. | `architecture.md` | `/#defense-9` | Виконано за кодом або збереженим доказом. | | 10. Запис до MongoDB | Генератор → IngestService → пакетні upsert → стан pending. | `application/services.py` | `/#defense-10` | Виконано за кодом або збереженим доказом. | | 11. Пошук | OpenSearch знаходить збіги, MongoDB доповнює видачу довідниками. | `application/queries.py` | `/#defense-11` | Виконано за кодом або збереженим доказом. | | 12. Картка публікації | Введіть UUID або відкрийте статтю у видачі. Картка читається з MongoDB. | `results/defense-stack.xml` | `/#defense-12` | Виконано за кодом або збереженим доказом. | | 13. Шардування | mongos розподіляє статті за хешем _id. Перевірте розподіл на трьох шардах. | `results/shards-demo.json` | `/#defense-13` | Виконано за кодом або збереженим доказом. | | 14. Агрегація між шардами | Обчисліть кількість статей за роками й перегляньте план MongoDB. | `infrastructure/mongo.py` | `/#defense-14` | Виконано. 1 000 статей, три шарди та розділений план у results/defense-aggregation.json. | | 15. Повнотекстовий пошук і кеш | Повторіть однаковий запит і порівняйте поле cache_hit. | `results/integration.xml` | `/#defense-15` | Виконано за кодом або збереженим доказом. | | 16. Міграція | Експортуйте JSONL і відновіть корпус на окремому екземплярі. | `scripts/ops.py` | `/#defense-16` | Виконано. Між двома ізольованими стендами перенесено 30 статей, усі видимі в пошуку. Доказ у results/defense-migration.json. | | 17. Відображення об’єктів | ArticleDocument мапить Article на BSON-поля та додає службові поля індексації. | `infrastructure/odm.py` | `/#defense-17` | Виконано за кодом або збереженим доказом. | | 18. Гарантії запису | Порівняйте підтверджений запис із видимістю проєкції у метриках. | `cap-and-failures.md` | `/#defense-18` | Виконано за кодом або збереженим доказом. | | 19. Журнал | Знайдіть подію за текстом або рівнем. Оновлення кожні три секунди. | `infrastructure/logging.py` | `/#defense-19` | Виконано. PATCH встановив WARNING, GET із фільтром знайшов подію, PATCH повернув INFO. | | 20. Діаграма класів | QueryService → ReadRepository ← MongoRepository → ArticleDocument → Article. | `architecture.md` | `/#defense-20` | Виконано за кодом або збереженим доказом. | | 21. Падіння та відновлення | Перевірте живі метрики і виконайте відновлювальні тести в окремому стеку. | `results/recovery.xml` | `/#defense-21` | Частково. Локально 10 інтеграційних і браузерних та 6 відновлювальних тестів пройшли. Доступ до цільового сервера відсутній. | Артефакти в `results/` належать зафіксованим прогонам. Межі їх застосовності описано в [матриці приймання](acceptance.md).