🧪 Smoke-test: 10/10 PASSED — волна 1 + волна 2

Покрытие (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 таблиц
This commit is contained in:
2026-09-26 09:16:20 +00:00
parent eef9c393ca
commit 7141b73c58
4 changed files with 849 additions and 0 deletions
+557
View File
@@ -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 | |
+174
View File
@@ -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`
+101
View File
@@ -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())
+17
View File
@@ -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