fix

2026-10-03 13:22:11 +07:00
parent 05090722a0
commit 2caa2c1a88
74 changed files with 44 additions and 676 deletions
@@ -6,28 +6,22 @@ import (
 	"evening_detective_server/internal/services/game_model"
 )

-// Answer — ответ команды на вопрос дела (для публичного API команды).
 type Answer struct {
 	QuestionCode string
 	Text         string
 }

-// AnswerScore — ответ команды с баллом организатора (для панели оценки).
 type AnswerScore struct {
 	QuestionCode string
 	Text         string
-	// Score — балл; nil — ещё не оценено.
-	Score *int
+	Score        *int
 }

-// TeamAnswers — ответы одной команды игры.
 type TeamAnswers struct {
 	Team    *game_model.Team
 	Answers []AnswerScore
 }

-// GameAnswers — полная картина для оценки организатором: вопросы сценария
-// (с правильными ответами) и ответы всех команд с баллами.
 type GameAnswers struct {
 	Questions []*storytelling.Question
 	Teams     []TeamAnswers
@@ -7,31 +7,18 @@ import (
 	"evening_detective_server/internal/modules/storytelling"
 )

-// TeamResult — строка итоговой таблицы: команда, баллы по вопросам (в порядке
-// сценария), сумма баллов и место.
 type TeamResult struct {
-	Team    *game_model.Team
-	Answers []AnswerScore
-	// TotalScore — сумма баллов по всем вопросам сценария; неоценённые
-	// вопросы считаются как 0.
+	Team       *game_model.Team
+	Answers    []AnswerScore
 	TotalScore int
-	// Place — место в итоговой таблице. Команды с одинаковой суммой баллов
-	// и одинаковым числом ходов занимают одно место (следующее место
-	// пропускается); проставляется функцией rankTeams.
-	Place int
+	Place      int
 }

-// GameResults — итоговая таблица игры: вопросы сценария (шапка таблицы) и
-// результаты команд, отсортированные по сумме баллов.
 type GameResults struct {
 	Questions []*storytelling.Question
 	Teams     []TeamResult
 }

-// buildTeamResults собирает строки итоговой таблицы по командам: баллы в
-// порядке вопросов сценария (неотвеченный/неоценённый вопрос — с пустым
-// текстом и Score=nil), сумма баллов (nil считается как 0). Команды в
-// результате — в порядке переданного списка; сортировку и места делает
 // rankTeams.
 func buildTeamResults(
 	questions []*storytelling.Question,
@@ -63,12 +50,6 @@ func buildTeamResults(
 	return res
 }

-// rankTeams сортирует строки итоговой таблицы по сумме баллов (убывание);
-// при равенстве суммы выше команда с меньшим числом ходов. Команды с
-// одинаковой суммой баллов И одинаковым числом ходов занимают одно место
-// (следующее место пропускается — схема 1,2,2,4 по ключу (сумма, ходы)).
-// id команды влияет только на порядок показа внутри группы (меньший id
-// первым), не на место. Входной срез не изменяется.
 func rankTeams(rows []TeamResult) []TeamResult {
 	sorted := make([]TeamResult, len(rows))
 	copy(sorted, rows)
@@ -17,7 +17,6 @@ func teamResult(id, actions, total int) TeamResult {
 }

 func TestRankTeamsSortsByTotalThenActions(t *testing.T) {
-	// У всех команд разный ключ (сумма, ходы) — места идут подряд 1..N.
 	rows := []TeamResult{
 		teamResult(3, 5, 10),
 		teamResult(1, 3, 10),
@@ -36,14 +35,12 @@ func TestRankTeamsSortsByTotalThenActions(t *testing.T) {
 			t.Fatalf("rankTeams[%d].Place = %d, want %d", i, got[i].Place, wantPlaces[i])
 		}
 	}
-	// Команды 1 и 3 имеют одинаковую сумму (10), но разные ходы — разные места.
 	if got[1].Place == got[2].Place {
 		t.Fatalf("равные суммы при разных ходах должны давать разные места: places = %d, %d", got[1].Place, got[2].Place)
 	}
 }

 func TestRankTeamsSharesPlaceOnEqualTotalAndActions(t *testing.T) {
-	// Одинаковая сумма И одинаковое число ходов — одно место у всех трёх.
 	rows := []TeamResult{
 		teamResult(5, 4, 9),
 		teamResult(2, 4, 9),
@@ -51,7 +48,6 @@ func TestRankTeamsSharesPlaceOnEqualTotalAndActions(t *testing.T) {
 	}
 	got := rankTeams(rows)

-	// Внутри группы порядок показа — по id asc (детерминированный).
 	wantIDs := []int{2, 5, 7}
 	for i, id := range wantIDs {
 		if got[i].Team.ID != id {
@@ -64,7 +60,6 @@ func TestRankTeamsSharesPlaceOnEqualTotalAndActions(t *testing.T) {
 }

 func TestRankTeamsSkipsPlaceAfterSharedTie(t *testing.T) {
-	// Две команды делят 1-е место, следующая получает 3-е (схема 1,1,3).
 	rows := []TeamResult{
 		teamResult(3, 2, 7),
 		teamResult(1, 5, 10),
@@ -116,7 +111,7 @@ func TestBuildTeamResultsScenarioOrderAndNilScores(t *testing.T) {
 			"q3": {QuestionCode: "q3", Text: "ответ 3", Score: intPtr(-1)},
 		},
 		2: {
-			"q2": {QuestionCode: "q2", Text: "ответ 2"}, // балл не выставлен
+			"q2": {QuestionCode: "q2", Text: "ответ 2"},
 		},
 	}

@@ -126,7 +121,6 @@ func TestBuildTeamResultsScenarioOrderAndNilScores(t *testing.T) {
 		t.Fatalf("len(buildTeamResults) = %d, want 2", len(got))
 	}

-	// Команда 1: q1(5), q2 не отвечен, q3(-1) → сумма 4.
 	first := got[0]
 	if first.Team.ID != 1 || first.TotalScore != 4 {
 		t.Fatalf("команда 1: Team.ID = %d, TotalScore = %d; want ID 1, Total 4", first.Team.ID, first.TotalScore)
@@ -143,7 +137,6 @@ func TestBuildTeamResultsScenarioOrderAndNilScores(t *testing.T) {
 		t.Fatalf("команда 1: неотвеченный q2 = %+v, want Score=nil и Text=\"\"", first.Answers[1])
 	}

-	// Команда 2: все не оценены → сумма 0.
 	second := got[1]
 	if second.Team.ID != 2 || second.TotalScore != 0 {
 		t.Fatalf("команда 2: Team.ID = %d, TotalScore = %d; want ID 2, Total 0", second.Team.ID, second.TotalScore)
@@ -40,24 +40,15 @@ func NewAnswerService(
 }

 var (
-	// ErrTeamNotFound — команда не найдена или пароль неверен.
-	ErrTeamNotFound = errors.New("Команда не найдена")
-	// ErrGameNotFound — игра не найдена.
-	ErrGameNotFound = errors.New("Игра не найдена")
-	// ErrGameFinished — после завершения игры ответы команд больше нельзя
-	// изменять: организатор оценивает их в панели игры.
-	ErrGameFinished = errors.New("Игра завершена, ответы больше нельзя изменять")
-	// ErrGameNotStarted — игра ещё не начата, отвечать на вопросы нельзя.
-	ErrGameNotStarted = errors.New("Игра не начата, отвечать на вопросы нельзя")
-	// ErrQuestionNotFound — вопрос с таким кодом отсутствует в сценарии игры.
+	ErrTeamNotFound     = errors.New("Команда не найдена")
+	ErrGameNotFound     = errors.New("Игра не найдена")
+	ErrGameFinished     = errors.New("Игра завершена, ответы больше нельзя изменять")
+	ErrGameNotStarted   = errors.New("Игра не начата, отвечать на вопросы нельзя")
 	ErrQuestionNotFound = errors.New("Вопрос не найден")
-	// ErrGameNotFinished — итоги игры доступны только после её завершения.
-	ErrGameNotFinished = errors.New("Итоги доступны после завершения игры")
-	// ErrOfflineAnswers — ответы для offline-игры недоступны через сайт.
-	ErrOfflineAnswers = errors.New("В offline-игре ответы через сайт недоступны")
+	ErrGameNotFinished  = errors.New("Итоги доступны после завершения игры")
+	ErrOfflineAnswers   = errors.New("В offline-игре ответы через сайт недоступны")
 )

-// getTeamAndGame проверяет команду по паролю и возвращает её вместе с игрой.
 func (s *AnswerService) getTeamAndGame(ctx context.Context, teamID int, password string) (*repos.Team, *repos.Game, error) {
 	team, err := s.teamsRepo.GetTeamByID(ctx, teamID)
 	if err != nil {
@@ -79,7 +70,6 @@ func (s *AnswerService) getTeamAndGame(ctx context.Context, teamID int, password
 	return team, game, nil
 }

-// getScenarioQuestionsByCode возвращает вопросы сценария игры с индексацией по коду.
 func (s *AnswerService) getScenarioQuestionsByCode(ctx context.Context, scenarioID int) ([]*storytelling.Question, map[string]*storytelling.Question, error) {
 	scenario, err := s.scenarioService.GetFullScenarioByID(ctx, scenarioID)
 	if err != nil {
@@ -92,9 +82,6 @@ func (s *AnswerService) getScenarioQuestionsByCode(ctx context.Context, scenario
 	return scenario.Story.Questions, byCode, nil
 }

-// GetTeamAnswers возвращает ответы команды на вопросы дела (без баллов:
-// баллы видны только организаторам). Ответы на удалённые из сценария
-// вопросы не возвращаются.
 func (s *AnswerService) GetTeamAnswers(ctx context.Context, teamID int, password string) ([]Answer, error) {
 	_, game, err := s.getTeamAndGame(ctx, teamID, password)
 	if err != nil {
@@ -124,10 +111,6 @@ func (s *AnswerService) GetTeamAnswers(ctx context.Context, teamID int, password
 	return answers, nil
 }

-// SubmitTeamAnswers сохраняет ответы команды на вопросы дела (upsert).
-// Доступно только пока игра идёт (статусы run/pause): после завершения
-// ответы фиксируются для оценки организатором. Переданные коды должны
-// существовать в сценарии игры; пустая строка очищает ответ.
 func (s *AnswerService) SubmitTeamAnswers(ctx context.Context, teamID int, password string, answers []Answer) error {
 	_, game, err := s.getTeamAndGame(ctx, teamID, password)
 	if err != nil {
@@ -138,7 +121,6 @@ func (s *AnswerService) SubmitTeamAnswers(ctx context.Context, teamID int, passw
 	}
 	switch game.Status {
 	case "run", "pause":
-		// игра идёт — можно отвечать
 	default:
 		if game.Status == "finish" {
 			return ErrGameFinished
@@ -162,12 +144,6 @@ func (s *AnswerService) SubmitTeamAnswers(ctx context.Context, teamID int, passw
 	return s.answersRepo.UpsertAnswers(ctx, teamID, rows)
 }

-// GetGameAnswers возвращает полную картину для оценки организатором:
-// вопросы сценария с правильными ответами и ответы всех команд с баллами.
-// Команда может не дать ответ на вопрос — такой вопрос попадает в список
-// ответов команды с пустым текстом и без балла (организатор видит его и
-// может выставить балл, в т.ч. штрафной). Ответы на удалённые из сценария
-// вопросы не возвращаются (как в GetTeamAnswers).
 func (s *AnswerService) GetGameAnswers(ctx context.Context, gameID int) (*GameAnswers, error) {
 	game, err := s.gamesRepo.GetGameByID(ctx, gameID)
 	if err != nil {
@@ -211,8 +187,6 @@ func (s *AnswerService) GetGameAnswers(ctx context.Context, gameID int) (*GameAn
 	teamAnswers := make([]TeamAnswers, 0, len(teams))
 	for _, team := range teams {
 		byCode := answerByTeamAndCode[team.ID]
-		// Все вопросы сценария в порядке сценария; неотвеченные — с пустым
-		// текстом и без балла, чтобы организатор видел пропуски.
 		answers := make([]AnswerScore, 0, len(questions))
 		for _, question := range questions {
 			if answer, ok := byCode[question.Code]; ok {
@@ -234,10 +208,6 @@ func (s *AnswerService) GetGameAnswers(ctx context.Context, gameID int) (*GameAn
 	}, nil
 }

-// SetTeamAnswerScore выставляет балл команде за ответ на вопрос дела;
-// score == nil сбрасывает балл. Балл может быть любым целым числом
-// (в т.ч. отрицательным — штрафные баллы). Вопрос должен существовать
-// в сценарии игры.
 func (s *AnswerService) SetTeamAnswerScore(ctx context.Context, teamID int, questionCode string, score *int) error {
 	team, err := s.teamsRepo.GetTeamByID(ctx, teamID)
 	if err != nil {
@@ -257,11 +227,6 @@ func (s *AnswerService) SetTeamAnswerScore(ctx context.Context, teamID int, ques
 	return s.answersRepo.SetAnswerScore(ctx, teamID, questionCode, score)
 }

-// GetGameResults возвращает итоговую таблицу игры: вопросы сценария (шапка
-// таблицы, без правильных ответов) и команды, отсортированные по сумме
-// баллов, с баллами по каждому вопросу (в порядке сценария), числом ходов и
-// местом. Доступно только после завершения игры (статус finish); неоценённые
-// вопросы в сумме считаются как 0.
 func (s *AnswerService) GetGameResults(ctx context.Context, gameID int) (*GameResults, error) {
 	game, err := s.gamesRepo.GetGameByID(ctx, gameID)
 	if err != nil {
@@ -39,7 +39,6 @@ func TestAnswerAccessPostgres(t *testing.T) {
 	if err != nil {
 		t.Fatal(err)
 	}
-	// Отклонённые запросы не должны доходить до хранилищ сценариев и ответов.
 	service := NewAnswerService(games_repo.NewGamesRepo(pool), teams_repo.NewTeamsRepo(pool), nil, nil, nil)
 	for _, tc := range []struct {
 		status string