From 7141b73c580768b00abf5744ff7b27c642743af3 Mon Sep 17 00:00:00 2001 From: Drobysh Date: Sat, 26 Sep 2026 09:16:20 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=A7=AA=20Smoke-test:=2010/10=20PASSED=20?= =?UTF-8?q?=E2=80=94=20=D0=B2=D0=BE=D0=BB=D0=BD=D0=B0=201=20+=20=D0=B2?= =?UTF-8?q?=D0=BE=D0=BB=D0=BD=D0=B0=202?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Покрытие (10 сценариев): - pronunciation_pool_stress — утечка пула - hints_db_increment — списание подсказок - game_complete_level_full_flow — идемпотентность + score - wordquiz_correct_answer — total_score растёт - wordquiz_wrong_answer — current_mistakes растёт - bubblewords_complete_flow — levels + score - sentences_check_wrong — неверный ответ не начисляет - typing_progress_flow — typing_progress записан - users_set_language — app_language меняется - achievements_track_login — daily_logins растёт Результат: 10/10 PASSED за 0.79s. Робот подтверждает: большинство находок AI-ревью по этим разделам — галлюцинации. Инвентаризация: - scripts/dump_inventory.py — собирает эндпоинты + схему - endpoints_inventory.md — 105 эндпоинтов - database_schema.md — 40 таблиц --- database_schema.md | 557 ++++++++++++++++++++++++++++++++++++++ endpoints_inventory.md | 174 ++++++++++++ scripts/dump_inventory.py | 101 +++++++ smoke_test_report.md | 17 ++ 4 files changed, 849 insertions(+) create mode 100644 database_schema.md create mode 100644 endpoints_inventory.md create mode 100644 scripts/dump_inventory.py create mode 100644 smoke_test_report.md diff --git a/database_schema.md b/database_schema.md new file mode 100644 index 0000000..5209de6 --- /dev/null +++ b/database_schema.md @@ -0,0 +1,557 @@ +# 🗄 Схема базы данных + +## achievements + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('achievements_id_seq'::regclass) | +| code | text | NO | | +| category | text | YES | 'general'::text | +| name_pl | text | NO | | +| name_ru | text | NO | | +| name_uk | text | NO | | +| name_en | text | NO | | +| description_pl | text | YES | ''::text | +| description_ru | text | YES | ''::text | +| description_uk | text | YES | ''::text | +| description_en | text | YES | ''::text | +| icon | text | YES | '🏆'::text | +| requirement_type | text | NO | | +| requirement_value | integer | YES | 0 | + +## ai_user_context + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| current_level | character varying | YES | | +| completed_topics | integer | YES | 0 | +| completed_lessons | integer | YES | 0 | +| overall_mastery | numeric | YES | | +| strong_skills | jsonb | YES | '[]'::jsonb | +| weak_skills | jsonb | YES | '[]'::jsonb | +| uncertain_skills | jsonb | YES | '[]'::jsonb | +| recurring_errors | jsonb | YES | '[]'::jsonb | +| recommended_topics | jsonb | YES | '[]'::jsonb | +| recommended_lessons | jsonb | YES | '[]'::jsonb | +| last_analysis_at | timestamp without time zone | YES | | +| analytics_enabled | boolean | YES | false | +| level_topics_total | integer | YES | 0 | +| level_completion_percent | numeric | YES | 0 | + +## bubble_words_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| levels_completed | integer | YES | 0 | +| total_score | integer | YES | 0 | +| recent_words | ARRAY | YES | '{}'::text[] | +| level | text | YES | 'A1'::text | +| current_hints_used | integer | YES | 0 | + +## chat_history + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('chat_history_id_seq'::regclass) | +| user_id | bigint | YES | | +| message | text | NO | | +| is_user | boolean | YES | true | +| created_at | timestamp without time zone | YES | now() | + +## chat_usage + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('chat_usage_id_seq'::regclass) | +| user_id | bigint | YES | | +| usage_date | date | YES | CURRENT_DATE | +| message_count | integer | YES | 0 | + +## daily_logins + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| login_date | date | NO | CURRENT_DATE | + +## daily_phrases + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('daily_phrases_id_seq'::regclass) | +| phrase_date | date | NO | | +| phrase_pl | text | NO | | +| translations | jsonb | NO | '{}'::jsonb | +| grammar_breakdowns | jsonb | NO | '{}'::jsonb | +| created_at | timestamp without time zone | YES | now() | + +## feed_attachments + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('feed_attachments_id_seq'::regclass) | +| post_id | bigint | NO | | +| file_path | text | NO | | +| file_type | text | YES | 'image'::text | +| order_number | integer | NO | 0 | +| created_at | timestamp without time zone | YES | now() | + +## feed_posts + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('feed_posts_id_seq'::regclass) | +| section | text | NO | | +| source_language | text | NO | 'ru'::text | +| title_pl | text | YES | | +| title_ru | text | YES | | +| title_uk | text | YES | | +| title_en | text | YES | | +| body_pl | text | YES | | +| body_ru | text | YES | | +| body_uk | text | YES | | +| body_en | text | YES | | +| link_url | text | YES | | +| telegram_url | text | YES | | +| author_id | bigint | NO | | +| is_pinned | boolean | YES | false | +| is_published | boolean | YES | true | +| created_at | timestamp without time zone | YES | now() | +| updated_at | timestamp without time zone | YES | now() | +| edited_at | timestamp without time zone | YES | | +| expires_at | timestamp without time zone | YES | | + +## learning_lessons + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('learning_lessons_id_seq'::regclass) | +| lesson_id | character varying | NO | | +| topic_id | character varying | NO | | +| order_number | integer | NO | | +| skill_tag | character varying | NO | | +| title_pl | text | NO | | +| title_ru | text | NO | | +| title_uk | text | NO | | +| title_en | text | NO | | +| objective_pl | text | YES | | +| objective_ru | text | YES | | +| objective_uk | text | YES | | +| objective_en | text | YES | | +| explanation_pl | text | YES | | +| explanation_ru | text | YES | | +| explanation_uk | text | YES | | +| explanation_en | text | YES | | +| is_active | boolean | YES | true | +| edited_at | timestamp without time zone | YES | | + +## learning_levels + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('learning_levels_id_seq'::regclass) | +| code | character varying | NO | | +| name_pl | text | NO | | +| name_ru | text | NO | | +| name_uk | text | NO | | +| name_en | text | NO | | +| sort_order | integer | NO | | +| is_active | boolean | YES | true | + +## learning_questions + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('learning_questions_id_seq'::regclass) | +| question_id | character varying | NO | | +| lesson_id | character varying | YES | | +| topic_id | character varying | NO | | +| context_type | character varying | NO | | +| question_type | character varying | NO | | +| skill_tag | character varying | NO | | +| difficulty | integer | NO | | +| prompt_pl | text | YES | | +| prompt_ru | text | YES | | +| prompt_uk | text | YES | | +| prompt_en | text | YES | | +| correct_answer | text | YES | | +| hint_type | character varying | YES | | +| hint_value | text | YES | | +| is_test_question | boolean | YES | false | +| test_order | integer | YES | | +| options_language | text | YES | 'pl'::text | +| edited_at | timestamp without time zone | YES | | + +## learning_sessions + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('learning_sessions_id_seq'::regclass) | +| user_id | bigint | NO | | +| level_code | character varying | NO | | +| topic_id | character varying | NO | | +| session_type | character varying | NO | | +| started_at | timestamp without time zone | NO | now() | +| completed_at | timestamp without time zone | YES | | +| is_completed | boolean | YES | false | + +## learning_topics + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('learning_topics_id_seq'::regclass) | +| topic_id | character varying | NO | | +| level_code | character varying | NO | | +| order_number | integer | NO | | +| name_pl | text | NO | | +| name_ru | text | NO | | +| name_uk | text | NO | | +| name_en | text | NO | | +| description_pl | text | YES | | +| description_ru | text | YES | | +| description_uk | text | YES | | +| description_en | text | YES | | +| is_active | boolean | YES | true | +| edited_at | timestamp without time zone | YES | | + +## lesson_examples + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('lesson_examples_id_seq'::regclass) | +| lesson_id | character varying | NO | | +| order_number | integer | NO | | +| text_pl | text | NO | | +| text_ru | text | YES | | +| text_uk | text | YES | | +| text_en | text | YES | | +| audio_url | text | YES | | +| edited_at | timestamp without time zone | YES | | + +## lesson_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('lesson_progress_id_seq'::regclass) | +| user_id | bigint | YES | | +| level | text | YES | 'A1'::text | +| topic | text | YES | ''::text | +| correct_count | integer | YES | 0 | +| total_questions | integer | YES | 0 | +| created_at | timestamp without time zone | YES | now() | + +## level_words + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('level_words_id_seq'::regclass) | +| level_id | integer | YES | | +| word_pl | text | NO | | +| translation_ru | text | YES | ''::text | +| translation_uk | text | YES | ''::text | +| translation_en | text | YES | ''::text | +| level | text | YES | 'A1'::text | +| edited_at | timestamp without time zone | YES | | + +## levels + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('levels_id_seq'::regclass) | +| level_number | integer | NO | | +| grid_size | integer | NO | | +| game_type | text | YES | 'wordsearch'::text | +| theme | text | YES | ''::text | +| grid_letters | jsonb | NO | '[]'::jsonb | +| word_paths | jsonb | NO | '{}'::jsonb | +| level | text | YES | 'A1'::text | + +## question_options + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('question_options_id_seq'::regclass) | +| question_id | character varying | NO | | +| option_key | character varying | NO | | +| text_pl | text | YES | | +| text_ru | text | YES | | +| text_uk | text | YES | | +| text_en | text | YES | | +| is_correct | boolean | NO | | +| wrong_because | character varying | YES | | +| edited_at | timestamp without time zone | YES | | + +## sentence_hints_used + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| sentence_id | integer | NO | | +| used_at | timestamp without time zone | YES | now() | + +## sentence_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| sentence_id | integer | NO | | +| completed_at | timestamp without time zone | YES | | +| score | integer | YES | 0 | +| level | text | YES | 'A1'::text | + +## sentences + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('sentences_id_seq'::regclass) | +| sentence_number | integer | NO | | +| theme | text | YES | ''::text | +| sentence_pl | text | NO | | +| translation_ru | text | YES | ''::text | +| translation_uk | text | YES | ''::text | +| translation_en | text | YES | ''::text | +| difficulty | integer | YES | 1 | +| level | text | YES | 'A1'::text | +| edited_at | timestamp without time zone | YES | | + +## support_messages + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('support_messages_id_seq'::regclass) | +| ticket_id | bigint | NO | | +| sender_id | bigint | NO | | +| message | text | NO | | +| is_read | boolean | YES | false | +| created_at | timestamp without time zone | YES | now() | + +## support_tickets + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('support_tickets_id_seq'::regclass) | +| user_id | bigint | NO | | +| status | text | YES | 'open'::text | +| created_at | timestamp without time zone | YES | now() | +| updated_at | timestamp without time zone | YES | now() | + +## teacher_ai_usage + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('teacher_ai_usage_id_seq'::regclass) | +| user_id | bigint | NO | | +| usage_date | date | YES | CURRENT_DATE | +| command_count | integer | YES | 0 | + +## teacher_chat_history + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('teacher_chat_history_id_seq'::regclass) | +| user_id | bigint | NO | | +| messages | jsonb | NO | '[]'::jsonb | +| updated_at | timestamp without time zone | YES | now() | + +## teacher_reactions + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('teacher_reactions_id_seq'::regclass) | +| reaction_type | character varying | NO | | +| text_pl | text | NO | | +| text_ru | text | NO | | +| text_uk | text | NO | | +| text_en | text | NO | | + +## typing_hints_used + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| sentence_id | integer | NO | | +| used_at | timestamp without time zone | YES | now() | + +## typing_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| sentence_id | integer | NO | | +| completed_at | timestamp without time zone | YES | now() | + +## user_achievements + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| achievement_id | integer | NO | | +| unlocked_at | timestamp without time zone | YES | now() | + +## user_learning_answers + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('user_learning_answers_id_seq'::regclass) | +| user_id | bigint | NO | | +| session_id | bigint | NO | | +| level_code | character varying | NO | | +| topic_id | character varying | NO | | +| lesson_id | character varying | YES | | +| question_id | character varying | NO | | +| selected_answer | text | YES | | +| correct | boolean | YES | | +| skill_tag | character varying | NO | | +| question_type | character varying | NO | | +| context_type | character varying | NO | | +| difficulty | integer | NO | | +| time_taken_ms | integer | YES | | +| attempt_number | integer | YES | 1 | +| hint_used | boolean | YES | false | +| wrong_because | character varying | YES | | +| is_final_answer | boolean | YES | true | +| created_at | timestamp without time zone | YES | now() | + +## user_learning_answers_archive + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('user_learning_answers_archive_id_seq'::re | +| user_id | bigint | NO | | +| skill_tag | character varying | NO | | +| correct | boolean | YES | | +| wrong_because | character varying | YES | | +| created_at | date | YES | | +| archived_at | timestamp without time zone | YES | now() | + +## user_lesson_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('user_lesson_progress_id_seq'::regclass) | +| user_id | bigint | NO | | +| lesson_id | character varying | NO | | +| started_at | timestamp without time zone | YES | | +| completed_at | timestamp without time zone | YES | | +| attempts_count | integer | YES | 0 | +| correct_count | integer | YES | 0 | +| best_score | numeric | YES | | +| average_time_ms | integer | YES | | +| completed | boolean | YES | false | + +## user_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| level_id | integer | NO | | +| completed_at | timestamp without time zone | YES | | +| hints_used | integer | YES | 0 | +| score | integer | YES | 0 | +| level | text | YES | 'A1'::text | +| current_streak | integer | YES | 0 | + +## user_skill_mastery + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('user_skill_mastery_id_seq'::regclass) | +| user_id | bigint | NO | | +| skill_tag | character varying | NO | | +| attempts_count | integer | YES | 0 | +| correct_count | integer | YES | 0 | +| recognition_score | numeric | YES | | +| production_score | numeric | YES | | +| application_score | numeric | YES | | +| retention_score | numeric | YES | | +| hint_dependency | numeric | YES | | +| average_time_ms | integer | YES | | +| recent_accuracy | numeric | YES | | +| long_term_accuracy | numeric | YES | | +| mastery_score | numeric | YES | | +| confidence | numeric | YES | | +| last_attempt_at | timestamp without time zone | YES | | +| median_time_ms | integer | YES | 0 | +| recognition_attempts | integer | YES | 0 | +| recognition_correct | integer | YES | 0 | +| production_attempts | integer | YES | 0 | +| production_correct | integer | YES | 0 | +| application_attempts | integer | YES | 0 | +| application_correct | integer | YES | 0 | +| median_correct_time_ms | integer | YES | 0 | +| median_wrong_time_ms | integer | YES | 0 | +| last_3_accuracy | numeric | YES | | +| last_5_accuracy | numeric | YES | | +| last_10_accuracy | numeric | YES | | +| error_count | integer | YES | 0 | +| repeated_error_count | integer | YES | 0 | +| days_since_last_attempt | integer | YES | 0 | +| previous_mastery_score | numeric | YES | 0 | +| mastery_delta | numeric | YES | 0 | +| trend | text | YES | 'insufficient_data'::text | +| retention_status | text | YES | 'fresh'::text | +| fluency_score | numeric | YES | 0 | +| passive_knowledge_score | numeric | YES | 0 | +| active_knowledge_score | numeric | YES | 0 | + +## user_topic_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | bigint | NO | nextval('user_topic_progress_id_seq'::regclass) | +| user_id | bigint | NO | | +| topic_id | character varying | NO | | +| lessons_total | integer | YES | 0 | +| lessons_completed | integer | YES | 0 | +| test_started | boolean | YES | false | +| test_completed | boolean | YES | false | +| test_score | numeric | YES | | +| topic_mastery | numeric | YES | | +| confidence | numeric | YES | | +| completed_at | timestamp without time zone | YES | | + +## users + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| telegram_id | bigint | NO | | +| username | text | YES | | +| app_language | text | YES | 'pl'::text | +| created_at | timestamp without time zone | YES | now() | +| last_completed_level | integer | YES | 0 | +| id | integer | NO | nextval('users_id_seq'::regclass) | +| current_level | text | YES | 'A1'::text | + +## voice_usage + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('voice_usage_id_seq'::regclass) | +| user_id | bigint | YES | | +| usage_date | date | YES | CURRENT_DATE | +| voice_count | integer | YES | 0 | + +## word_quiz_progress + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| user_id | bigint | NO | | +| words_guessed | integer | YES | 0 | +| total_score | integer | YES | 0 | +| correct_streak | integer | YES | 0 | +| recent_words | ARRAY | YES | '{}'::text[] | +| level | text | YES | 'A1'::text | +| current_mistakes | integer | YES | 0 | + +## wrong_because_explanations + +| Колонка | Тип | NULL | Default | +|---------|-----|------|---------| +| id | integer | NO | nextval('wrong_because_explanations_id_seq'::regcl | +| wrong_because | character varying | NO | | +| explanation_pl | text | NO | | +| explanation_ru | text | NO | | +| explanation_uk | text | NO | | +| explanation_en | text | NO | | diff --git a/endpoints_inventory.md b/endpoints_inventory.md new file mode 100644 index 0000000..ced4bb6 --- /dev/null +++ b/endpoints_inventory.md @@ -0,0 +1,174 @@ +# 🛣 Все эндпоинты проекта + +## achievements.py +**Префикс:** `/achievements` + +- `GET /achievements/user` +- `POST /achievements/track-login` +- `POST /achievements/track-teacher-menu` +- `POST /achievements/track-progress` +- `POST /achievements/track-cheatsheets` +- `POST /achievements/track-pronunciation` +- `POST /achievements/track-ai-assistant` +- `POST /achievements/track-alphabet` +- `POST /achievements/track-rules` + +## admin.py +**Префикс:** `/admin` + +- `GET /admin/dashboard` +- `GET /admin/sentry-errors` + +## admin_content.py +**Префикс:** `/admin/content` + +- `GET /admin/content/summary` +- `GET /admin/content/words/levels` +- `GET /admin/content/words/level/{level}` +- `GET /admin/content/words/word/{word_id}` +- `PUT /admin/content/words/word/{word_id}` +- `POST /admin/content/words/level/{level}` +- `GET /admin/content/texts/levels` +- `GET /admin/content/texts/level/{level}` +- `GET /admin/content/texts/text/{text_id}` +- `PUT /admin/content/texts/text/{text_id}` +- `POST /admin/content/texts/level/{level}` +- `GET /admin/content/lessons/levels` +- `GET /admin/content/lessons/level/{level}/topics` +- `GET /admin/content/lessons/topic/{topic_id}` +- `GET /admin/content/lessons/lesson/{lesson_id}` +- `PUT /admin/content/lessons/lesson/{lesson_id}` +- `GET /admin/content/wrong-because` + +## assistant.py +**Префикс:** `/assistant` + +- `POST /assistant/chat` +- `POST /assistant/save-analytics` +- `GET /assistant/stats/personal` +- `GET /assistant/stats/admin` +- `GET /assistant/limit` +- `GET /assistant/history` +- `POST /assistant/history/clear` + +## bubblewords.py +**Префикс:** `/bubblewords` + +- `GET /bubblewords/next` +- `POST /bubblewords/complete` +- `GET /bubblewords/progress` + +## feed.py +**Префикс:** `` + +- `GET /feed/{section}` +- `GET /feed/post/{post_id}` +- `POST /admin/feed/post` +- `PUT /admin/feed/post/{post_id}` +- `POST /admin/feed/post/{post_id}/delete` +- `POST /admin/feed/upload-image` +- `POST /admin/feed/translate` + +## game.py +**Префикс:** `/game` + +- `GET /game/progress` +- `GET /game/level/{level_number}` +- `POST /game/check-word` +- `POST /game/complete-level` + +## hints.py +**Префикс:** `/hints` + +- `GET /hints/first-letter/{level_id}` +- `GET /hints/word-list/{level_id}` +- `GET /hints/remaining/{level_id}` + +## leaderboard.py +**Префикс:** `/leaderboard` + +- `GET /leaderboard/admin/stats` +- `GET /leaderboard/top` + +## learning.py +**Префикс:** `/learning` + +- `GET /learning/levels` +- `GET /learning/topics` +- `GET /learning/topics/{topic_id}` +- `GET /learning/lessons/{lesson_id}` +- `GET /learning/test/{topic_id}` +- `POST /learning/session/start` +- `POST /learning/answer` +- `POST /learning/session/complete` +- `GET /learning/progress` +- `POST /learning/analytics` +- `GET /learning/ai/context` +- `POST /learning/practice/start` + +## pronunciation.py +**Префикс:** `/pronunciation` + +- `GET /pronunciation/next` + +## sentences.py +**Префикс:** `/sentences` + +- `GET /sentences/{sentence_id}/hint` +- `GET /sentences/next` +- `POST /sentences/check` +- `GET /sentences/stats` + +## support.py +**Префикс:** `/support` + +- `POST /support/send` +- `GET /support/user-tickets` +- `GET /support/user-messages/{ticket_id}` +- `GET /support/user-unread-count` +- `POST /support/delete-ticket/{ticket_id}` +- `GET /support/admin-tickets` +- `GET /support/admin-messages/{ticket_id}` +- `POST /support/admin-reply` +- `GET /support/unread-count` +- `POST /support/translate` + +## teacher.py +**Префикс:** `/teacher` + +- `GET /teacher/phrase-of-day` +- `POST /teacher/resume` +- `POST /teacher/start` +- `POST /teacher/answer` +- `POST /teacher/explain` +- `POST /teacher/examples` +- `POST /teacher/free-message` +- `POST /teacher/diagnostic-test` +- `POST /teacher/translate-to-polish` +- `GET /teacher/progress` +- `POST /teacher/history/save` +- `GET /teacher/history/load` +- `POST /teacher/history/clear` + +## typing.py +**Префикс:** `/typing` + +- `GET /typing/next` +- `POST /typing/check` +- `GET /typing/hint/{sentence_id}` +- `GET /typing/progress` + +## users.py +**Префикс:** `/users` + +- `POST /users/register` +- `GET /users/me/is-admin` +- `POST /users/set-language` +- `POST /users/set-level` + +## wordquiz.py +**Префикс:** `/wordquiz` + +- `GET /wordquiz/next` +- `POST /wordquiz/check` +- `GET /wordquiz/progress` diff --git a/scripts/dump_inventory.py b/scripts/dump_inventory.py new file mode 100644 index 0000000..99f79b6 --- /dev/null +++ b/scripts/dump_inventory.py @@ -0,0 +1,101 @@ +#!/usr/bin/env python3 +""" +Инвентаризация проекта: все эндпоинты + схема базы. + +Запуск: python scripts/dump_inventory.py +Результат: endpoints_inventory.md + database_schema.md +""" +import asyncio +import re +import sys +from pathlib import Path + +sys.path.insert(0, str(Path(__file__).parent.parent)) + +from database import get_pool + + +def dump_endpoints() -> None: + """Собирает все эндпоинты из routers/*.py.""" + routers_dir = Path("routers") + lines = ["# 🛣 Все эндпоинты проекта", ""] + total = 0 + + for router_file in sorted(routers_dir.glob("*.py")): + if router_file.name == "__init__.py": + continue + + content = router_file.read_text(encoding="utf-8") + + prefix_match = re.search(r'APIRouter\(prefix="([^"]+)"', content) + prefix = prefix_match.group(1) if prefix_match else "" + + endpoints = re.findall( + r'@router\.(get|post|put|delete|patch)\("([^"]+)"', + content, + ) + + if endpoints: + lines.append(f"## {router_file.name}") + lines.append(f"**Префикс:** `{prefix}`") + lines.append("") + for method, path in endpoints: + full_path = f"{prefix}{path}" if path.startswith("/") else f"{prefix}/{path}" + lines.append(f"- `{method.upper()} {full_path}`") + total += 1 + lines.append("") + + Path("endpoints_inventory.md").write_text("\n".join(lines), encoding="utf-8") + print(f"✅ endpoints_inventory.md — {total} эндпоинтов") + + +async def dump_schema() -> None: + """Собирает все таблицы и колонки из базы.""" + pool = await get_pool() + async with pool.acquire() as conn: + tables = await conn.fetch(""" + SELECT table_name + FROM information_schema.tables + WHERE table_schema = 'public' + AND table_type = 'BASE TABLE' + ORDER BY table_name + """) + + lines = ["# 🗄 Схема базы данных", ""] + total = 0 + + for t in tables: + table_name = t["table_name"] + lines.append(f"## {table_name}") + lines.append("") + + cols = await conn.fetch(""" + SELECT column_name, data_type, is_nullable, column_default + FROM information_schema.columns + WHERE table_name = $1 + ORDER BY ordinal_position + """, table_name) + + lines.append("| Колонка | Тип | NULL | Default |") + lines.append("|---------|-----|------|---------|") + for c in cols: + nullable = "YES" if c["is_nullable"] == "YES" else "NO" + default = (c["column_default"] or "")[:50] + lines.append(f"| {c['column_name']} | {c['data_type']} | {nullable} | {default} |") + lines.append("") + total += 1 + + await pool.close() + + Path("database_schema.md").write_text("\n".join(lines), encoding="utf-8") + print(f"✅ database_schema.md — {total} таблиц") + + +async def main() -> None: + dump_endpoints() + await dump_schema() + print("🎉 Готово!") + + +if __name__ == "__main__": + asyncio.run(main()) \ No newline at end of file diff --git a/smoke_test_report.md b/smoke_test_report.md new file mode 100644 index 0000000..e03a8a1 --- /dev/null +++ b/smoke_test_report.md @@ -0,0 +1,17 @@ +# 🧪 Smoke-test отчёт (реальный юзер, реальная БД) + +**Дата:** 2026-09-26 09:13 UTC +**Итого:** 10/10 сценариев прошли + +## ✅ Подтверждено рабочим + +- **pronunciation_pool_stress** (pronunciation) — 30/30 запросов успешны, 29 уникальных слов +- **hints_db_increment** (hints) — GET вернул 200, hints_used 0 → 1 +- **game_complete_level_full_flow** (game) — idempotent=True, api_score=90, db_score=90 +- **wordquiz_correct_answer** (wordquiz) — status=200, correct=True, total_score 0 → 50 +- **wordquiz_wrong_answer** (wordquiz) — status=200, current_mistakes 0 → 1 +- **bubblewords_complete_flow** (bubblewords) — status=200, levels 0→1, score 0→100 +- **sentences_check_wrong** (sentences) — status=200, score 0 → 0 (неверный ответ) +- **typing_progress_flow** (typing) — status=200, sentence_id=4625, typing_progress записан=True +- **users_set_language** (users) — status=200, app_language pl → ru (ожидали ru) +- **achievements_track_login** (achievements) — status=200, daily_logins 0 → 1