Skip to content

Commit 21b8d8c

Browse files
committed
docs: #80 More documentation on CSV files with user info (currently only id and login).
1 parent fae4f5e commit 21b8d8c

File tree

1 file changed

+39
-1
lines changed
  • kgstatsSrv/src/test/resources/ru/klavogonki/data

1 file changed

+39
-1
lines changed

kgstatsSrv/src/test/resources/ru/klavogonki/data/readme.md

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,8 @@ select id, name from klavogonki.voc where (deleted = 0);
5656

5757
Здесь, наконец, удалось сделать выгрузку в кодировке `UTF-8`, а не `Windows-1251`.
5858

59+
Условие `deleted = 0` исключает из выборки историю словарей.
60+
5961
```sql
6062
select * from klavogonki.voc where (deleted = 0);
6163
```
@@ -73,9 +75,45 @@ select * from klavogonki.voc where (deleted = 0);
7375
В поле `info` похоже, что сохраняется формат html (видимо, некое Rich-поле при редактуре поля),
7476
переносы выполнены через тэг `<br />`.
7577

76-
Эти данные должны замариться на все поля из `GetStatsOverviewGameType`
78+
Эти данные должны замапиться на все поля из `GetStatsOverviewGameType`
7779

7880
:question: Однако непонятно, как заполняется поле `GetStatsOverviewGameType#book_done`.
7981
Может быть, сравнивается число отрезков в книге (`vocs.rows`) и пробег юзера по словарю?
8082

8183
Но пробег может быть больше, чем длина словаря.
84+
85+
Для учёта каждого из отрывков словаря есть отдельная таблица, которая содержит пройденные игроком отрезки
86+
книжного словаря. Именно из неё выбираются данные для показа прогресса юзера по книге,
87+
они возвращаются по запросу вида https://klavogonki.ru/api/profile/get-book-parts?userId=242585&vocId=30149.
88+
89+
Её поля — `user_id`, `voc_id`, `part_id`.
90+
91+
**TODO:** Каково имя этой таблицы?
92+
93+
94+
# user20241101.csv
95+
96+
НЕ заблокированные пользователи.
97+
98+
```sql
99+
select id, login from klavogonki.user where (blocked = 0);
100+
```
101+
102+
## Поля
103+
Только `id` и `login`.
104+
105+
Если для статистики нужны другие поля, нужно запрашивать их отдельно.
106+
107+
Всех полей из `GetIndexDataSuccess` здесь, естественно, нет.
108+
109+
# blocked20240416.csv
110+
111+
Заблокированные пользователи.
112+
Многие из них имеют нецензурные никнеймы.
113+
114+
```sql
115+
select id, login from klavogonki.user where (blocked != 0);
116+
```
117+
118+
## Поля
119+
Только `id` и `login`.

0 commit comments

Comments
 (0)