1. Об игре
2. Правила
3. Введение в архитектуру
   1. Диаграмма использования
   2. Логическая схема данных
   3. Физическая схема данных
   4. Руководство пользователя
      1. Регистрация и вход в систему
      2. Создание новой игры
      3. Ввод и отправка данных на сервер
      4. Завершение игры
      5. Возобновление игры
      6. Просмотр истории игр

Быки и коровы — логическая игра, в ходе которой за несколько попыток один из игроков должен определить, что задумал другой игрок. Варианты игры могут зависеть от типа отгадываемой последовательности — это могут быть числа, цвета, пиктограммы или слова. После каждой попытки задумавший игрок выставляет «оценку», указывая количество угаданного без совпадения с их позициями (количество «коров») и полных совпадений (количество «быков»). Роли участников игры не равнозначны — угадывающий должен анализировать сделанные попытки и полученные оценки, то есть его роль активна. Его партнёр лишь сравнивает очередной вариант с задуманным и выставляет оценку по формальным правилам, то есть его роль пассивна.

Смотреть подробнее по ссылке.

В классическом варианте игра рассчитана на двух игроков. Каждый из игроков задумывает и записывает тайное 4-значное число с неповторяющимися цифрами. Игрок, который начинает игру по жребию, делает первую попытку отгадать число. Попытка — это 4-значное число с неповторяющимися цифрами, сообщаемое противнику. Противник сообщает в ответ, сколько цифр угадано без совпадения с их позициями в тайном числе (то есть количество коров) и сколько угадано вплоть до позиции в тайном числе (то есть количество быков). Например:

Задумано тайное число «3219».

Попытка: «2310».

Результат: две «коровы» (две цифры: «2» и «3» — угаданы на неверных позициях) и один «бык» (одна цифра «1» угадана вплоть до позиции).

Игроки делают попытки угадать по очереди. Побеждает тот, кто угадает число первым, при условии, что он не начинал игру. Если же отгадавший начинал игру — его противнику предоставляется последний шанс угадать последовательность.

Данная реализация это игра против компьютера, где игрок вводит комбинации одну за другой, пока не отгадает всю последовательность.

Игра Быки и Коровы это классическое веб приложение представляющее из себя трех уровневую архитектуру.

Диаграмма вариантов использования (англ. use case diagram) в UML — диаграмма, отражающая отношения между актёрами и прецедентами и являющаяся составной частью модели прецедентов, позволяющей описать систему на концептуальном уровне.

На диаграмме ниже представлен актер Пользователь, который может совершать следующие действия, показанные на изоображении нижею

Логическая схема данных спроектированна по методологии IDEF1x. В конкретной схеме базы данных используются внешние виды связи такие как многие ко многим. Если говорить более предметно, то отношение таблицы Пользователь к таблице Игра является необязательная, неидентифицирующая. Так же отношение таблицы Игра к таблице Шаг_Игры так же является необязательной, неидентифицирующей. Ниже представлена логическая схема БД.

Текущий проект был построен с использованием двух СУБД Postgres и H2. Физическая схема БД успешно протестированна на той паре СУБД, которые указаны выше по тексту. Физическая схема БД была разработана с использованием ограничений, которые помогают реализовывать целостность базы данных. Ниже представлена физическая схема БД.

Для регистрации в системе требуется перейти в корневой каталог url '/' или по следующему url '/login' . После перехода на страницу с авторизацией следует назать на вкладку ${Sign up} после чего ввести валидные данные. Следом после перезагрузки страницы после успешной регистрации появится сообщающее об успешном вводе данных. Ниже представлена анимация, которая показывает успешные шаги.

Зарегистрируйтесь и авторизируйтись в приложении. Далее появится страничка состоящая из трех пунктов ${Resume game} , ${Start new game} , ${View history games} . Если у вас нет начатой игры следует нажать на кнопку ${Start new game} для начала новой игры. Ниже представлена анимация, которая показывает процесс создания новой игры.

Ввод числа существляется с помощью выдвижных списков содержащих порядковые числа. После успешного выбора следует нажать кнопку ${Send message} . Введеные данные отправятся на сервер, об успешности операции сообщит зеленое уведомление в правом углу страницы и ответное сообщение сервера сообщающее колличество быков и коров в обртаном сообщении. Следует учитывать возможные неудачи отсылки попытки угадать число. При полноценной работе системы существует две основные ощибки ввода сообщения, заключающиеся в повторении однозначных чисел и отсутствии выбора одного или нескольких однозначых чисел. Ниже представлена анимация, которая показывает игровой процесс.

Для завершения игры существует два пути. Первый путь это пройти игру одержав победу. Второй путь это вернуться в главное меню нажав кнопку ${Home} после чего нажать кнопку ${New game} после чего будет создана новая игра с новой загадкой.

Чтобы возобновить игру следует перейти домой нажав кнопку ${Home} . После успешного перехода в меню появится кнопка ${Resume game} , нажав на которую пользователь будет перенаправлен к последней незавершеной игре. Ниже представлена анимация, которая показывает возобновление игры.

Для просмотра игры следует перейти домой нажав кнопку ${Home} . После успешного перехода в меню появится кнопка ${View game history} , нажав на которую пользователь сможет перейти и посмотреть все завершенные игры и статистику по ним. Так же находясь на страничке с историей пользователю будет доступен рейтинг вычисляющийся по отношению всех завершенных игр к всем выполненым ходам к этим играм. Стоит отметить, что на страничке с историей пользователю доступна информация есть ди у текущего пользователя начатые игры. Ниже представлена анимация, которая показывает переход к страничке с историей и информаций доступной на ней.