From b3adf78351227abe7285b4f55b7e7f7434966ea0 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Tue, 10 Jun 2025 21:40:19 +0300 Subject: [PATCH 01/15] feat: week1 report --- content/docs/2025/UniTrip/_index.md | 4 ++ content/docs/2025/UniTrip/week1.md | 73 +++++++++++++++++++++++++++++ 2 files changed, 77 insertions(+) create mode 100644 content/docs/2025/UniTrip/_index.md create mode 100644 content/docs/2025/UniTrip/week1.md diff --git a/content/docs/2025/UniTrip/_index.md b/content/docs/2025/UniTrip/_index.md new file mode 100644 index 000000000..500e3442e --- /dev/null +++ b/content/docs/2025/UniTrip/_index.md @@ -0,0 +1,4 @@ +--- +bookCollapseSection: true +title: "Dream Team" +--- \ No newline at end of file diff --git a/content/docs/2025/UniTrip/week1.md b/content/docs/2025/UniTrip/week1.md new file mode 100644 index 000000000..bd3ea0c7c --- /dev/null +++ b/content/docs/2025/UniTrip/week1.md @@ -0,0 +1,73 @@ +--- +title: "Week #1" +--- + +# Week #1 + +## **Team Members** + +| Team Member | Telegram ID | Email Address | Track | Responsibilities | +|-----------------------------------------|---------------|-----------------|---------------------------------------------|--------------------| +| Marina Lavrova(Lead) | @mc_lavrushka | m.lavrova@innopolis.university | Project Management | Organization of work documentation, communication | +| Merkulov Leonid | @merkulov_leonid | l.merkulov@innopolis.university | Backend | C# code and DevOps tasks | +| Ivan Makarov | @cody_py | i.makarov@innopolis.university | Backend| C# code | +| Tarubarova Nadia | @laseiiine | n.tarubarova@innopolis.university | Design | 3D modeling of locations and characters | +| Pokhodyaeva Polina | @polly_p0 | p.pokhodyaeva@innopolis.university | Design | Designing and scatching locations and cha | + +**Team name** - CodeInno + +**Team communication channel** - Telegram chat and offline meetings + + +## Project idea +Interactive game with walking around the space about the Innopolis University. + +Brief description: +Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC and things and learning about life in Innopolis through mini-quests and dialogues. + +According our research and analysis of the market - there is no games about Innopolis University, so it should be interesting and unique for the users interested in Innopolis University. + +### Problem statement +Many applicants and tourists do not have the opportunity to come to the university in person and learn about the student's life. We solve this by creating a virtual tour around the University with interaction. + +### Target users +Applicants and their parents, tourists, guests. + +### Users needs +See what the university looks like + +Understand atmosphere, infrastructure + +Get involved in the process and student's life through the game interaction + + +Learn something new about the university + +### User stories +- As an applicant, I want to walk around the university online to understand how it works and feels. + +- As a guest, I want to talk with the NPC (Professors/Students) to learn about students' lives. + +- As a parent, I want to make sure that the students have good conditions. + +- As a tourist, I want to go through the mini-quest to learn more about university. + + +### Initial scope +**On MVP:** +2 locations of the main hall with 7-8 interactions with objects + +**Out of the MVP:** +The other location with Student dormitory and canteen. + +[Open repo here](https://github.com/IU-Capstone-Project-2025/UniTrip) + +## Tech stack: +- **Unity** for the game creation. +We use it because it is simple and fast in development, supports all functionality that we need and known by our team. +- **Blender** for 3D model creations +Also fast, simple and known +- **Procreate** for design +Suggest wide functionality for creating the design - professional and comfort in use. +- **Github pages** for deploy +Easy in use, could be automized by Github actions \ No newline at end of file From 1625d93b0a996006cb8b2f592370ffab8e14b98d Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Tue, 10 Jun 2025 21:42:08 +0300 Subject: [PATCH 02/15] fix: typo --- content/docs/2025/UniTrip/week1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/2025/UniTrip/week1.md b/content/docs/2025/UniTrip/week1.md index bd3ea0c7c..979a8e9d7 100644 --- a/content/docs/2025/UniTrip/week1.md +++ b/content/docs/2025/UniTrip/week1.md @@ -12,7 +12,7 @@ title: "Week #1" | Merkulov Leonid | @merkulov_leonid | l.merkulov@innopolis.university | Backend | C# code and DevOps tasks | | Ivan Makarov | @cody_py | i.makarov@innopolis.university | Backend| C# code | | Tarubarova Nadia | @laseiiine | n.tarubarova@innopolis.university | Design | 3D modeling of locations and characters | -| Pokhodyaeva Polina | @polly_p0 | p.pokhodyaeva@innopolis.university | Design | Designing and scatching locations and cha | +| Pokhodyaeva Polina | @polly_p0 | p.pokhodyaeva@innopolis.university | Design | Designing and scatching locations and characters | **Team name** - CodeInno From dada8e1ea5a98bac1062c8512dec83fdd479d1f6 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 11 Jun 2025 15:25:03 +0300 Subject: [PATCH 03/15] fix: upload week1 report with changes --- content/docs/2025/UniTrip/week1.md | 105 +++++++++++++++++++++++------ 1 file changed, 86 insertions(+), 19 deletions(-) diff --git a/content/docs/2025/UniTrip/week1.md b/content/docs/2025/UniTrip/week1.md index 979a8e9d7..28493c7dc 100644 --- a/content/docs/2025/UniTrip/week1.md +++ b/content/docs/2025/UniTrip/week1.md @@ -4,44 +4,88 @@ title: "Week #1" # Week #1 +## Project description + +### Project name: UniTrip +**Code repository**: https://github.com/IU-Capstone-Project-2025/UniTrip + +### Detailed description +Our project is the Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC(students/professors) and objects in locations to learn about life in Innopolis through mini-quests and dialogues. + +### Problem statement +Many applicants and tourists do not have the opportunity to come to the university in person and learn about the student's life. We solve this by creating a virtual tour around the University with interaction. + ## **Team Members** | Team Member | Telegram ID | Email Address | Track | Responsibilities | |-----------------------------------------|---------------|-----------------|---------------------------------------------|--------------------| | Marina Lavrova(Lead) | @mc_lavrushka | m.lavrova@innopolis.university | Project Management | Organization of work documentation, communication | | Merkulov Leonid | @merkulov_leonid | l.merkulov@innopolis.university | Backend | C# code and DevOps tasks | -| Ivan Makarov | @cody_py | i.makarov@innopolis.university | Backend| C# code | +| Ivan Makarov | @cody_py | i.makarov@innopolis.university | Backend| C# code and customer communication | | Tarubarova Nadia | @laseiiine | n.tarubarova@innopolis.university | Design | 3D modeling of locations and characters | | Pokhodyaeva Polina | @polly_p0 | p.pokhodyaeva@innopolis.university | Design | Designing and scatching locations and characters | -**Team name** - CodeInno -**Team communication channel** - Telegram chat and offline meetings +## Brainstorming +### Ideas during brainstorming -## Project idea -Interactive game with walking around the space about the Innopolis University. +1. **Interactive game about Innopolis University** +Walk through University locations and interact with objects and NPCs to learn something new about Innopolis +2. **Service discovery and advertising platform for Innopolis** +A unified application for finding, booking, and promoting local services in the city of Innopolis (beauty salons, massage, health services, repair, etc.). The app will offer a structured and user-friendly alternative to fragmented Telegram chats and word-of-mouth recommendations. Users will be able to easily browse available services, read reviews, save favorites, and sign up — all within a single app, without relying on Telegram or WhatsApp. -Brief description: -Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC and things and learning about life in Innopolis through mini-quests and dialogues. +3. **Personal AI Health Assistant** +A virtual personal doctor AI-agent that helps users monitor and manage their health. The assistant keeps track of personal medical data (such as blood type, doctor visits, test results), answers health-related questions, and provides reliable information to avoid the common problem of users self-diagnosing through unverified internet sources. -According our research and analysis of the market - there is no games about Innopolis University, so it should be interesting and unique for the users interested in Innopolis University. +4. **Tower defense game** +Tower defense game in Zombie style, called Defendead. It was our project in previous year, there was 3 levels and we could improve it by adding new levels, new monsters and more waves(also add multiplayer, rank, in-game currency and etc). -### Problem statement -Many applicants and tourists do not have the opportunity to come to the university in person and learn about the student's life. We solve this by creating a virtual tour around the University with interaction. + +### Brief market research / problem validation +1. **Interactive game about Innopolis University** + +Problem: +Many prospective students, their parents, and tourists do not have the opportunity to visit Innopolis University in person(who lives far away). However even someone, who could visit University - cannot do it without guide and doesn't have opporunity to walk free and interact with objects/people. + +Market: +- Prospective students applying to Innopolis University (~ 14 thousands yearly). +- Parents of prospective students (number of students * 2 = 28 thosands). +- Tourists and guests interested in Innopolis city and university (~100-150 thousands yearly ) + +Validation: +- Official university tours are limited in frequency and location-based. +- Discussions with guides show that tourists often look for visual and interactive materials. +- Current online resources do not allow interaction with university spaces or immersion into student life. + +2. **Service discovery and advertising platform for Innopolis** + +Problem: +Finding local services in Innopolis is currently inefficient and fragmented. Information is spreaded across multiple Telegram groups and chats. Newcomers often experience information overload, while new businesses struggle to advertise themselves. Additionally, Telegram is not optimized for service discovery and lacks proper filtering, search, and review mechanisms. + +Market: +- City of Innopolis ( ~ 5-7k population and growing). +- Newcomers (students, specialists relocating to work in IT companies). +- Local businesses and entrepreneurs providing services (beauty, healthcare, repair, education, etc.). + +Validation: +- Personal experience and feedback from new residents show that searching for services usually involves joining dozens of Telegram chats and browsing through unstructured posts. +- New local businesses advertising in Telegram chats is ineffective and tough. + +## Basic requirements ### Target users Applicants and their parents, tourists, guests. -### Users needs -See what the university looks like +Their needs: -Understand atmosphere, infrastructure +- See what the university looks like -Get involved in the process and student's life through the game interaction +- Understand atmosphere, infrastructure +- Get involved in the process and student's life through the game interaction -Learn something new about the university +- Learn something new about the university ### User stories - As an applicant, I want to walk around the university online to understand how it works and feels. @@ -58,9 +102,7 @@ Learn something new about the university 2 locations of the main hall with 7-8 interactions with objects **Out of the MVP:** -The other location with Student dormitory and canteen. - -[Open repo here](https://github.com/IU-Capstone-Project-2025/UniTrip) +The other locations such as student's dormitory and canteen. ## Tech stack: - **Unity** for the game creation. @@ -70,4 +112,29 @@ Also fast, simple and known - **Procreate** for design Suggest wide functionality for creating the design - professional and comfort in use. - **Github pages** for deploy -Easy in use, could be automized by Github actions \ No newline at end of file +Easy in use, could be automized by Github actions + + +# Weekly commitments + +## Individual contribution of each participant +Marina Lavrova(Lead) - organized work, brainstorm ideas and create a draft roadmap +Merkulov Leonid - learned the deploy tools, start to create a plot of the game +Ivan Makarov - brainstorm ideas, discussed with customer, start to create the plot of the game +Tarubarova Nadia - started creating the [first location](https://drive.google.com/drive/folders/1tOgQVp6NgdZlooWGwSPTcuapUi9yx5kQ?usp=share_link) in Blender +Pokhodyaeva Polina - started creation [makets](https://drive.google.com/drive/folders/10yk3KXb1-QyhiQZRcKuYPSGiJnsx5py9?usp=sharing) with design for first location and main character + + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [ ] In working condition. +- [ ] Run via docker-compose (or another alternative described in the `README.md`). + +## Plans for next week +- Write detailed user stories and user flow diagrams +- Create a backlog with all tasks +- Create a prototype of 2 locations +- Upload the 3d model of the first location in Unity +- Add main character and it's walking around the ares. +- If will have left time, create a first interactions with objects in location. From 6372b30721788e8449f374ecef54ac273e2b4418 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 11 Jun 2025 15:31:06 +0300 Subject: [PATCH 04/15] fix: name of team --- content/docs/2025/UniTrip/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/2025/UniTrip/_index.md b/content/docs/2025/UniTrip/_index.md index 500e3442e..bbebb719e 100644 --- a/content/docs/2025/UniTrip/_index.md +++ b/content/docs/2025/UniTrip/_index.md @@ -1,4 +1,4 @@ --- bookCollapseSection: true -title: "Dream Team" +title: "UniTrip" --- \ No newline at end of file From 54a34981f63314513ec08aae10eb9e6a50506b97 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 11 Jun 2025 18:02:20 +0300 Subject: [PATCH 05/15] fix: add unity version and artefacts --- content/docs/2025/UniTrip/week1.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/content/docs/2025/UniTrip/week1.md b/content/docs/2025/UniTrip/week1.md index 28493c7dc..23cf78619 100644 --- a/content/docs/2025/UniTrip/week1.md +++ b/content/docs/2025/UniTrip/week1.md @@ -7,7 +7,8 @@ title: "Week #1" ## Project description ### Project name: UniTrip -**Code repository**: https://github.com/IU-Capstone-Project-2025/UniTrip +**Code repository**: https://github.com/IU-Capstone-Project-2025/UniTrip +Unity version - 2022.3.56f1 ### Detailed description Our project is the Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC(students/professors) and objects in locations to learn about life in Innopolis through mini-quests and dialogues. @@ -118,9 +119,9 @@ Easy in use, could be automized by Github actions # Weekly commitments ## Individual contribution of each participant -Marina Lavrova(Lead) - organized work, brainstorm ideas and create a draft roadmap -Merkulov Leonid - learned the deploy tools, start to create a plot of the game -Ivan Makarov - brainstorm ideas, discussed with customer, start to create the plot of the game +Marina Lavrova(Lead) - organized work, brainstorm ideas and create a draft [roadmap](https://www.figma.com/file/mKd4J2YIo0d3aj9GmMZOZ8?node-id=61-28&t=Pb7lIIqvWFRYL6yj-0&type=whiteboard&fuid=730113520731516840) +Merkulov Leonid - learned the deploy tools, start to create a [plot](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?usp=share_link) of the game +Ivan Makarov - brainstorm ideas, discussed with customer, start to create the [plot](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?usp=share_link) of the game Tarubarova Nadia - started creating the [first location](https://drive.google.com/drive/folders/1tOgQVp6NgdZlooWGwSPTcuapUi9yx5kQ?usp=share_link) in Blender Pokhodyaeva Polina - started creation [makets](https://drive.google.com/drive/folders/10yk3KXb1-QyhiQZRcKuYPSGiJnsx5py9?usp=sharing) with design for first location and main character From 88a314f903482a85bfa7d329f3df966569bbb732 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Fri, 13 Jun 2025 15:21:05 +0300 Subject: [PATCH 06/15] fix: report fixes after meeting with TA --- content/docs/2025/UniTrip/week1.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/content/docs/2025/UniTrip/week1.md b/content/docs/2025/UniTrip/week1.md index 23cf78619..aadbc32fa 100644 --- a/content/docs/2025/UniTrip/week1.md +++ b/content/docs/2025/UniTrip/week1.md @@ -11,7 +11,10 @@ title: "Week #1" Unity version - 2022.3.56f1 ### Detailed description -Our project is the Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC(students/professors) and objects in locations to learn about life in Innopolis through mini-quests and dialogues. +Our project is the Unity game where the player can walk through the main areas of the university (main hall and dormitory), interacting with the NPC(students/professors) and objects in locations to learn about life in Innopolis through mini-quests and dialogues. +User open the game and see main screen with first location(first part of main hall). Also user see 3 "!" marks with possibilities to click and open the dialogs with professor, and 2 secutity men. +After passing the dialogs with the second secutiry man you have opportunity to pass to the second location with more quests such as look at 108 auditorium or buy something in the vending mashine. The fully detailed description of the scenario is attached in the contribution part below. It will be finalized in the next week. + ### Problem statement Many applicants and tourists do not have the opportunity to come to the university in person and learn about the student's life. We solve this by creating a virtual tour around the University with interaction. @@ -20,9 +23,9 @@ Many applicants and tourists do not have the opportunity to come to the universi | Team Member | Telegram ID | Email Address | Track | Responsibilities | |-----------------------------------------|---------------|-----------------|---------------------------------------------|--------------------| -| Marina Lavrova(Lead) | @mc_lavrushka | m.lavrova@innopolis.university | Project Management | Organization of work documentation, communication | -| Merkulov Leonid | @merkulov_leonid | l.merkulov@innopolis.university | Backend | C# code and DevOps tasks | -| Ivan Makarov | @cody_py | i.makarov@innopolis.university | Backend| C# code and customer communication | +| Marina Lavrova(Lead) | @mc_lavrushka | m.lavrova@innopolis.university | Project Management and narrative writer | Organization of work documentation, communication, backlog and responsible for narrative script | +| Merkulov Leonid | @merkulov_leonid | l.merkulov@innopolis.university | Unity developer | C# code and DevOps tasks | +| Ivan Makarov | @cody_py | i.makarov@innopolis.university | Unity developer| C# code and customer communication | | Tarubarova Nadia | @laseiiine | n.tarubarova@innopolis.university | Design | 3D modeling of locations and characters | | Pokhodyaeva Polina | @polly_p0 | p.pokhodyaeva@innopolis.university | Design | Designing and scatching locations and characters | @@ -133,9 +136,11 @@ We confirm that the code in the main branch: - [ ] Run via docker-compose (or another alternative described in the `README.md`). ## Plans for next week -- Write detailed user stories and user flow diagrams -- Create a backlog with all tasks -- Create a prototype of 2 locations -- Upload the 3d model of the first location in Unity +- Write detailed user stories and user flow diagrams. +- Finalize the narrative for the game. +- Create a backlog with all tasks, estimation and sprints. +- Create a prototype of 2 locations. +- Upload the 3d model of the first location in Unity. - Add main character and it's walking around the ares. -- If will have left time, create a first interactions with objects in location. +- Create a first interactions with objects in location. +- Learn camera transitions in Unity and try to apply. From 565dd17db43fc6245d9de6d46fb7df40fb96d690 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 18 Jun 2025 16:39:39 +0300 Subject: [PATCH 07/15] add week2 report --- content/docs/2025/UniTrip/week2.md | 120 +++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 content/docs/2025/UniTrip/week2.md diff --git a/content/docs/2025/UniTrip/week2.md b/content/docs/2025/UniTrip/week2.md new file mode 100644 index 000000000..13aa96a0d --- /dev/null +++ b/content/docs/2025/UniTrip/week2.md @@ -0,0 +1,120 @@ +--- +title: "Week #2" +--- + +# **Week #2** + +## Detailed Requirements Elaboration + +### User Story 1: Moving around the location + +**As a** player **I want to** move my character around the university locations so that I can explore the university and get a feeling of its atmosphere. + +**Given:** +I’m a player in the game on the first location (main hall). + +**When:** +I tap/click on location area parts on my screen. + +**Then:** +- The character moves accordingly on the screen. +- The character cannot leave the predefined bounds of the location. +- Movement is responsive and smooth. + +### User Story 2: Talking with NPCs + +**As a** player **I want to** interact with NPCs so that I can learn more about the university life and students. + +**Given:** +I’m a player moving around the location and see NPCs(Professor/Security guard) with an interaction marker (!). + +**When:** +I click on the NPC. + +**Then:** +- A dialogue window appears with the conversation. +- I can progress through the dialogue using button next or choices button. +- After completing the dialogue, the dialogue window closes. +- Game state updates accordingly (unlocking new quest with "!" or moving to next location). + + +### User Story 3: Starting the game from the main screen + +**As a** player **I want to** start the game from the main menu so that I can enter the gameplay easily. + +**Given:** +I launch the game and see the main screen. + +**When:** +I press the “Start” button. + +**Then:** +- The first location loads and gameplay begins. +- Background music starts. +- I see a prompt to follow the “!” signs. +- The character appears at the entrance of the university. + + + +### Prioritized backlog +We created the backlog with tasks for all weeks and planned to follow the sprints. The workload on each members are spreaded and trying to be balanced, however during the planning we noticed that on first week there are more work for designers, because we need to create a lot of design and 3D models, however in the last weeks the load on the developers team is more, because of hard features to implement. We cannot avoid it, because it is a flow of our project and will try to balance between weight of tasks as we can. Thats the reason why we decided to divide the sprint deadlines on two parts to balance the designers and developers: +during the first part of week designers create all staff, required for the week tasks and then developers during the second part of week implement it and repeat the process. During the gap each part of team could start work, which do not depend on previos implementations. + +For backlog we chosed Jira, because among all tools checked by PM (such as Asana, github issues and gitlab milestones) - it shows the better and wide functionality and customization such as custom fields (in Asana its paid), free usage for team less than 10 people and illustrative interface with sprints (in conrtast to github and gitlab, where milestones are separate of each other in different pages). +To check our backlog follow the link: +https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog + + +## Project specific progress + +### Whole team progress +- Finalize the narrative for the game. +- Agreed with the customer ideas, narrative and plans for testing and using a game. + +### PM +- Created a backlog with all spints and estimation +- Create a user flow diagram for the whole project + +### Design +- Finalize the 3D model of first location with background sprites and upload to Unity +- Create a sprites for 4 characters of the first location +- Finalize prototyping for the whole project + + +### Unity development +- Create the zero welcome scene with the start button and transition to the first scene +- Crete a main character walking through the first location +- Create a first interaction scripts without designed sprites + +### ML +- Start creation of dataset for AI assistant + + +# Weekly commitments + +## Individual contribution of each participant + +**Marina Lavrova(Lead)** - organized the teamwork, spreaded the tasks, created a [backlog](https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog?label=Design&selectedIssue=SCRUM-27), organized team meet with [narrative](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?usp=sharing) finalizing and created user flow [diagrams](https://www.figma.com/design/lSDrdh8XspHjlDYsoE9kKA/User-flow-diagram?node-id=0-1&t=0SVQ1DFlW8wU7V0n-1) +**Merkulov Leonid** - created a [zero scene](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/40ff76e14b6fe52d76210442ddbfd3ce816e9a65) with start button and the main character [walking](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/1dcb50252706a240fadd15ad4310222edfd4f9f7), upload paricipated in [narrative](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?tab=t.0) writing +**Ivan Makarov** - organized meet with customer, created a [interaction scripts](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/c6fd8b068f9abc1d45d6cbfd09d94788ca171398) with objects on location, participated in [narrative](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?tab=t.0) writing, start collecting [dataset](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-?usp=sharing) +**Tarubarova Nadia** - finalized creating the [first location](https://drive.google.com/drive/folders/1tOgQVp6NgdZlooWGwSPTcuapUi9yx5kQ?usp=sharing), participated in [narrative](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?tab=t.0) writing +**Pokhodyaeva Polina** - created [sprites](https://drive.google.com/drive/folders/13HPbsBE8fOnZaMYTB2S0OX5y6IpHdIcc) for 3D location background, created [sprites](https://drive.google.com/drive/folders/11HQP3-jThDvhKhujYdB21xxgTCo_IqBf?usp=sharing) for 4 characters in first location, finalized the whole project [protorypes](https://drive.google.com/drive/folders/10yk3KXb1-QyhiQZRcKuYPSGiJnsx5py9?usp=sharing), participated in [narrative](https://docs.google.com/document/d/1iMLAHSx76uULx53z7i-xRVh0EfPteNgj682SRBlNNjo/edit?tab=t.0) writing + +## Plan for Next Week +- Create a 3D model of the all characters in first location and upload it +- Create a sprites for dialogue screens and "!" signes +- Implement all interactions in first locations (first MVP version) +- Add deploy to GitHub pages +- Start creation of the second location (sprites for background and 3D model) +- Finalize the dataset collection and train initial version of a ML model. + + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [✓] In working condition. +- [✓] Run via docker-compose (or another alternative described in the `README.md`). + +## Run the project +Full project and initial version of the game you could see here: +https://github.com/IU-Capstone-Project-2025/UniTrip From 3e7105970642656d29fe3a4b866694126ce7fec9 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 25 Jun 2025 19:32:57 +0300 Subject: [PATCH 08/15] feat: add week3 report --- content/docs/2025/UniTrip/week3.md | 156 +++++++++++++++++++++++++++++ 1 file changed, 156 insertions(+) create mode 100644 content/docs/2025/UniTrip/week3.md diff --git a/content/docs/2025/UniTrip/week3.md b/content/docs/2025/UniTrip/week3.md new file mode 100644 index 000000000..8c01bbbb4 --- /dev/null +++ b/content/docs/2025/UniTrip/week3.md @@ -0,0 +1,156 @@ +--- +title: "Week #3" +--- + +# **Week #3** + +## Implemented MVP features +- Create a 3D model of the all characters in first location and upload it +- Update 3D model of the first location(add bg sprites and fix some objects) +- Create a sprites for dialogue screens and "!" signes and upload it +- Implement all interactions in first locations with designed sprites +- Add camera transition for the dialogue scenes +- Add animation of walking +- Fix bugs with walking in unrestricted zone and glitching of character + +If summarize everything we create full user journey in first location with all interactions, functionality and also add animation and camera transitions for better user experience. + +During the deploy to the gh-pages we faced some issues with access to github actions and then with WebGL specific moments, so decided to focus on MVP features implementation and reschedule the deploy part to the next week, where according to the requirements it asked. For now we tested web verion locally and it works, for deploy on pages we need more time. For getting the MVP you could use the created [build](https://github.com/IU-Capstone-Project-2025/UniTrip/releases/tag/v1.1.0) + +### Full user journey + +0) Open the game +1) Click the button start +2) Click the "!" sign for first character - security guard +3) Read the dialogue and click on the screen to continue +4) Walk through area and click the "!" sign for the second character - Professor Burmyakov +5) Read the dialogue and click on the screen to continue +6) Click to the last "!" sign for the third character - 2nd security guard +7) Read the dialogue, click on the right answer or try again +8) Click continue and go to turnstille to go to the second location + +## Demonstration of the working MVP + +You could see our demo and screenshoots [here](https://drive.google.com/drive/folders/1FiEUsC9ZYDPfgYo-tCPPDZgA6FGsVrWJ?usp=sharing) + +## ML + +### Model Architecture +We used microsoft/phi-2, a small but capable causal language model (decoder-only transformer) with ~2.7 billion parameters. It is optimized for reasoning and instruction-following tasks. + +### Training Data +We created a custom dataset from publicly available text documents about Innopolis University, such as: +- A university information sheet (Справка об Университете Иннополис.docx) +- A guided tour program document (Программа экскурсии по УИ.docx). + +Combined into one large .txt file: innopolis_data.txt. +From that, we automatically generated training samples in the following format: +``` +{ + "instruction": "Что ты можешь рассказать по следующей теме об Университете Иннополис?", + "input": "", + "output": "Университет Иннополис — это современное высшее учебное заведение, специализирующееся на IT и инженерии..." +} +``` +This dataset was split into train/test subsets, typically 90% training, 10% validation. + +### Training Parameters + +We used the Hugging Face Trainer API with the following configuration: + +Model - microsoft/phi-2 +Batch Size - 2 (per device) +Epochs - 3 +Max Sequence Length - 512 tokens +Learning Rate - 2e-5 +Weight Decay - 0.01 +Warmup Steps - 10 +Mixed Precision (fp16) - Disabled (CPU only) +Optimizer - AdamW +Padding Token - Same as eos_token + +The training was done on CPU due to hardware constraints, meaning slower runtime but functional with a reduced dataset. + + +### How the Model Makes Decisions +Once trained, the model makes predictions using causal decoding: + +1) It receives an instruction (question or prompt). + +2) It tokenizes the input and passes it through the transformer layers. + +3) Based on its internal weights (adjusted during fine-tuning), it predicts the next token one-by-one until a stop condition is met (e.g., end-of-sequence token or max length). + +4) The response is decoded back into human-readable text. + +The model uses self-attention, which means it considers all previous tokens in the context window when generating each new token. Fine-tuning makes the model more likely to prefer responses grounded in your data. + +**Link to the training code**: *link* + +**Links to the initial model artifacts**: *links* + +## Internal demo + + +During the internal demo we noticied several bugs and parts to improve: +- when main character turn around - it sometimes overflow the locations model +- not understandable how to continue during the dialogue +- dialogue text in some parts is boring +- text font looks weird +- during the scene with Professor Burmyakov the sprite of the bg of cava looks weird +- Professor Burmyakov and 2nd security guard without skin +- Animation of moving should be more realistic, and also shadow glitching during the animation +- The 3d model contains some redundant sprite of the glass in the corner +- Good to add light + +Then we discussed the priority of this ideas + +**Priority tasks(will completed during next week)** +- update collaiders sizes(to avoid overflow) +- add text hint "click to continue" +- update texts +- update font, colors and fix alignment of text +- change camera position + +**Need to be discussed (need help in resolving issues)** +- fix bug with skin texture of 2 characters + +**Need to be done, but later(week 7 with resolving bugs)** +- Update animation of character moving and fix shadow +- Fix 3d location corner texture +- Add light + +After all we updtaed the backlog and splitted the task for the next week between the team + +# Weekly commitments + +## Individual contribution of each participant + +**Marina Lavrova(Lead)** - organized work and 3 team meets(sprint planning, tasks check in the mid of week and sprint retrospective with planning for next week), collected the feedback from testing session, updated the [backlog](https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog?assignee=712020%3Aaa1621bd-0ebc-4918-974f-e4df728ce60d), created a [demo](https://drive.google.com/drive/folders/1FiEUsC9ZYDPfgYo-tCPPDZgA6FGsVrWJ?usp=sharing), add init version of [gh-pages](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/e9fd282da6feb8b6e6706e98f1332dcb4be3510d) with solving bugs + +**Merkulov Leonid** - [fixed](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/993a44051fea7e8034f11da50d5c69f45e0840f8) character moving and added animation, [add](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/03750f0d0a54f59bd2532194ac532fc1c7839c61) dialog interactions and implement them for 3 characters, [add camera transition](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/74c7c6854db9837510269a977d6b7d0903e67ed4), upload 3d models of [characters and location](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/59fddc818f8d4bbd9affa855e454828ae88e0800), check all commits [here](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/v1.1.0/). + +**Ivan Makarov** - finalized the [dataset](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-), train a [model](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-). + +**Tarubarova Nadia** - created 3D models of [characters](https://drive.google.com/drive/folders/1SCWUktnMDkrhyACH4vOi0N1BnLhQe6C3?usp=share_link) for the first location, and fixed 3D model of the [first location](https://drive.google.com/drive/folders/1DzZf5G3drAUxYQ7efT0owwVSzABO9ym5?usp=share_link) + +**Pokhodyaeva Polina** - created [sprites](https://drive.google.com/drive/folders/1KsW154ZuQXik0OXDuvlWU6mL0Q5XtTSD) for dialogue screens, "!" marks and stated fonts, created detailed [prototype](https://drive.google.com/drive/folders/18uRJz-ha5B0eQUZthT0oTfeQjx_a9wBX) for the second location + +## Plan for Next Week +- Fix bugs noticed in first location +- Create a sprites for background for the 2nd location +- Create a first version of 3D model the second location +- Create sprites for first part of interactions (108 auditorium) +- Upload 2nd location to Unity and implement first part of interactions(108 auditorium and professor Shilov) +- Create a connection of trained model to Unity +- Add Unit tests +- Add CI and fix CD +- Start creation of prototypes for characters on the second locations +- Start creation of characters for the second location + + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [✓] In working condition. +- [✓] Run via docker-compose (or another alternative described in the `README.md`). \ No newline at end of file From 893c5e19a6a798d2e337d98ebb4b82f1e7038240 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 25 Jun 2025 20:51:25 +0300 Subject: [PATCH 09/15] fix: add screenshoots and links --- content/docs/2025/UniTrip/week3.md | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/content/docs/2025/UniTrip/week3.md b/content/docs/2025/UniTrip/week3.md index 8c01bbbb4..a3b3ae8a7 100644 --- a/content/docs/2025/UniTrip/week3.md +++ b/content/docs/2025/UniTrip/week3.md @@ -30,8 +30,20 @@ During the deploy to the gh-pages we faced some issues with access to github act 8) Click continue and go to turnstille to go to the second location ## Demonstration of the working MVP +You could see full demo and screenshoots [here](https://drive.google.com/drive/folders/1FiEUsC9ZYDPfgYo-tCPPDZgA6FGsVrWJ?usp=sharing) -You could see our demo and screenshoots [here](https://drive.google.com/drive/folders/1FiEUsC9ZYDPfgYo-tCPPDZgA6FGsVrWJ?usp=sharing) +### First interaction +![First interaction](https://github.com/IU-Capstone-Project-2025/UniTrip/blob/main/assets/week3/first_interaction.gif) + +### Update states of "!" + +![Update states](https://github.com/IU-Capstone-Project-2025/UniTrip/blob/main/assets/week3/states_updates.png) + +### Dialog +![Dialog](https://github.com/IU-Capstone-Project-2025/UniTrip/blob/main/assets/week3/dialog.png) + +### Dialog with choices +![Dialog with choices](https://github.com/IU-Capstone-Project-2025/UniTrip/blob/main/assets/week3/choices.png) ## ML @@ -85,9 +97,8 @@ Once trained, the model makes predictions using causal decoding: The model uses self-attention, which means it considers all previous tokens in the context window when generating each new token. Fine-tuning makes the model more likely to prefer responses grounded in your data. -**Link to the training code**: *link* - -**Links to the initial model artifacts**: *links* +**Link to the training code**: [link](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-) +**Links to the initial model artifacts**: [link](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-) ## Internal demo From 6f5f5ef1b90921a3735ad205500b4524665f642e Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 2 Jul 2025 22:45:52 +0300 Subject: [PATCH 10/15] week4 submit report --- content/docs/2025/UniTrip/week4.md | 110 +++++++++++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 content/docs/2025/UniTrip/week4.md diff --git a/content/docs/2025/UniTrip/week4.md b/content/docs/2025/UniTrip/week4.md new file mode 100644 index 000000000..779d063c4 --- /dev/null +++ b/content/docs/2025/UniTrip/week4.md @@ -0,0 +1,110 @@ +--- +title: "Week #4" +--- + +# **Week #4** + +## Testing and QA + +To ensure quality and stability, we implemented automated Edit Mode tests covering key gameplay interactions and dialogue logic using the Unity Test Framework with NUnit. + +Our testing approach includes: +- Unit tests for backend logic (e.g., destination setting in the ClickToMove component). +- Integration-like tests for UI and dialogue components (ClickableChoiceNPC, ClickableNPC) written in EditMode using UnityTest and coroutines. +- Although written in Edit Mode, some tests simulate runtime behavior such as player interaction with NPCs and dialogue state changes. + +We focused on: +- Core user interaction logic +- NPC dialogue flow and feedback +- UI state updates based on input + +We grouped all tests under the EditMode folder for simplicity and CI integration. No PlayMode folder was used at this stage, though test logic simulates in-game behavior using coroutines and Unity APIs. + + + +### Evidence of test execution + +We configured GitHub Actions to automatically run Edit tests on every push to main. This ensures immediate feedback on regressions. + +For know its covered most core functionallity implemented parts of the game. + +Evidence includes: +- Console output confirming test case execution and results +- CI test passed or not +![photo](https://github.com/IU-Capstone-Project-2025/UniTrip/blob/main/assets/week4/tests.png) +## CI/CD + +We used GitHub Actions to implement a Continuous Integration (CI) pipeline that automatically builds and tests the Unity project upon each push or pull request. + + CI (Continuous Integration) +Tool: GameCI +Jobs: +- Install Unity via game-ci/unity-installer +- Run tests via game-ci/unity-test-runner +- Shows the output +- Triggers: push to main branch + +During the creating test we faced many issues, most of them with pipeline and unity licence activation. Then with tests and showing it. It was hard without hard knowledges in unity and ci. + +Also we asked for help for another team and they suggested us to add code linting, which we used in our CI pipeline. +Thanks them for help, also they suggested us to add password and email to the pipeline, which help to solve problem with licence + +🎯 CD (Continuous Deployment) + +We are preparing to deploy the project as a WebGL build to GitHub Pages. +But also faced many issues and decided to stop this week on partially manualy deploy (will be fixed next week). + + +### Links to CI/CD configuration files +[yml file](https://github.com/IU-Capstone-Project-2025/UniTrip/tree/main/.github/workflows). +[pipeline with tests](https://github.com/IU-Capstone-Project-2025/UniTrip/actions/runs/16034237688/job/45242016411) + +## Deployment + +For now we have a manual deploy by using gh-pages, becuase we had a lot of issues with github actions and with leak of knowledge is hard. +The pipeline for now is following: +1) Build new WebGL folder from Unity +2) Push it manually into branch gh-pages +3) Get the web verison of the game on ph-pages + +## Vibe Check + +We expressed everything from vibe check meet in note below. +If summarize - everything is okay, just keep going, try do our best, finish tasks fitted in deadlines and not burn out. Because of leakage of time the most part of team feel stressful, but our PM tried their best to balances the load on people to reduce it, however in some cases it is unavoidable. + +[Note](https://docs.google.com/document/d/1f6m22t6EfzSDliiiNOmndoccPE47s9JppX4Eyub-HZk/edit?tab=t.0) + + +# Weekly commitments + +## Individual contribution of each participant + +**Marina Lavrova(Lead)** - organized work and 2 team meets, including team [vibe check](https://docs.google.com/document/d/1f6m22t6EfzSDliiiNOmndoccPE47s9JppX4Eyub-HZk/edit?usp=sharing), help with solving problem of broken project, ci/ci pipeline and communicate with other teams for help, support team during difficulties and trim [backlog](https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog?selectedIssue=SCRUM-59) to prioritize tasks + +**Merkulov Leonid** - Fix bugs noticed in first location, upload 2nd location to Unity and implement first part of interactions(Student and professor Shilov without 3d models), add unit tests and ci/cd pipline with deploy. +all commits are [here](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) + +**Ivan Makarov** - trained a [model](https://drive.google.com/drive/folders/1tLW5yMGEfuf8ABdVGM7FMp_B2li4KbN-?ths=true) more, add a [connection](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) of model to Unity + +**Tarubarova Nadia** - created 3D model of [2nd location](https://drive.google.com/drive/folders/1DzZf5G3drAUxYQ7efT0owwVSzABO9ym5), fixed [texts](https://docs.google.com/document/d/1mmvHvr4fpMwKyKiBfT46mgTayXwXYcIJl-K7-KaqPdQ/edit?usp=sharing) + +**Pokhodyaeva Polina** - сreated [sprites](https://drive.google.com/drive/folders/1IYyMJyNqzhusT-nD66-ULbLXSscwRTMB?ths=true) for the 108 auditorium, created [sprites](https://drive.google.com/drive/folders/18uRJz-ha5B0eQUZthT0oTfeQjx_a9wBX?ths=true) for background for the 2nd location, collected fonts and fixed [text sprites](https://drive.google.com/drive/folders/1KsW154ZuQXik0OXDuvlWU6mL0Q5XtTSD?usp=sharing) + + +## Plan for Next Week + +- Create prototypes for characters on the second location +- Create a characters for the second location +- Fix 2nd location 3D model and update in Unity +- Create sprites for vending mashine +- Implement the second part of interactions in the second location +- Provide QA session with feedback +- Finalize training a model +- Add chat with ML model to the information desk(without design) +- Find soundtracks and sound effects + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [✓] In working condition. +- [✓] Run via docker-compose (or another alternative described in the `README.md`). \ No newline at end of file From d580a65b8a1ede4417ac3f8a5625eb9d22ca325b Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 2 Jul 2025 22:47:47 +0300 Subject: [PATCH 11/15] rm lint --- content/docs/2025/UniTrip/week4.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/docs/2025/UniTrip/week4.md b/content/docs/2025/UniTrip/week4.md index 779d063c4..7e70a6ba9 100644 --- a/content/docs/2025/UniTrip/week4.md +++ b/content/docs/2025/UniTrip/week4.md @@ -46,8 +46,7 @@ Jobs: During the creating test we faced many issues, most of them with pipeline and unity licence activation. Then with tests and showing it. It was hard without hard knowledges in unity and ci. -Also we asked for help for another team and they suggested us to add code linting, which we used in our CI pipeline. -Thanks them for help, also they suggested us to add password and email to the pipeline, which help to solve problem with licence +Also we asked for help for another team and thanks them for help, also they suggested us to add password and email to the pipeline, which help to solve problem with licence 🎯 CD (Continuous Deployment) From 41adb7c53250965304948c599b93051d52d7b439 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 2 Jul 2025 22:49:16 +0300 Subject: [PATCH 12/15] fix link --- content/docs/2025/UniTrip/week4.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/2025/UniTrip/week4.md b/content/docs/2025/UniTrip/week4.md index 7e70a6ba9..546331c4c 100644 --- a/content/docs/2025/UniTrip/week4.md +++ b/content/docs/2025/UniTrip/week4.md @@ -56,7 +56,7 @@ But also faced many issues and decided to stop this week on partially manualy de ### Links to CI/CD configuration files [yml file](https://github.com/IU-Capstone-Project-2025/UniTrip/tree/main/.github/workflows). -[pipeline with tests](https://github.com/IU-Capstone-Project-2025/UniTrip/actions/runs/16034237688/job/45242016411) +[pipeline with tests](https://github.com/IU-Capstone-Project-2025/UniTrip/actions/runs/16034371739) ## Deployment From f8ab6e97127a00904b0ea7911c91fce698f1bba9 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 9 Jul 2025 16:42:03 +0300 Subject: [PATCH 13/15] feat: week 5 submit report --- content/docs/2025/UniTrip/week5.md | 95 ++++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 content/docs/2025/UniTrip/week5.md diff --git a/content/docs/2025/UniTrip/week5.md b/content/docs/2025/UniTrip/week5.md new file mode 100644 index 000000000..89f7619ce --- /dev/null +++ b/content/docs/2025/UniTrip/week5.md @@ -0,0 +1,95 @@ +--- +title: "Week #5" +--- + +# **Week #5** + +## Feedback + +### Sessions +We conducted several meets with different categories of people. +First of all - with our customer to check if the game suits his vision and if he likes it. So, if summarize his words - he accept the game interface and flow. Say to add more interactions and we imediately complete it during this sprint. + +Then - with our students to check if the game close to real university vibe and atmosphere. And they noticed that game has a calm mood, which close to their feelings in university, what is good. + +And the last section - the potenial users. People from other cities, which never was here and interested in Innopolis as a city. They like the game, the flow and also say some suggestions to improve + +Full feedback description you could see [here](https://docs.google.com/document/d/18jO7jkPARBSpUbOItuzbafxS_JxLzX5jkgCeENqB4MU/edit?tab=t.0) + + +### Analyze + +*Describe the important points that you received from the user feedback, what issues and with which priority you created.*. +We recieved that our game is interesting, funny and good looking, but we need to fix a lot of bugs to make user expereince better. +People suggest us to add more interactions, shadows with light, fill the background and fix some bugs with walking, animation and interactions. + +We created several issues, parts of them completed this week: +1. Add more interactions - add 2 interactions(108 auditorium and vending mashine) +2. Add the correct characters to the 2nd location +3. Fill the background with the color. +Also for next week we planned to continue fixes according to feedback and will: + +1. Fig bug with Professor Burmyakov asset +2. Improve interaction flow +3. Improve moving of the main character +4. Improve the animation of character's moving +5. Add shadows and ligth to the scenes + +All the tasks stays with priority order. We focused first of all on main things, which is crutial for our project and will do as much as we can, but in priority way to not miss important things. +First priority - good performance without bugs, second - the better visual. + +## Iteration & Refinement + +### Implemented features based on feedback +As we wrote above, the implemented features are following: +1. Add more interactions - add 2 interactions(108 auditorium and vending mashine) +2. Add the correct characters to the 2nd location +3. Fill the background with the color. + + +### Performance & Stability + +Our main measure of performance is a user interess and involvement in game process. It is absolutely random and not consistent parameter, but we could increase the probability of fullfiling it by enhancing the stability and quality of our game. +So, during final week we need to focus on the bug fixed to provide users more comfort user flow without some erros and easier in use. Also we need to focus on visual part, so will increase animations performance and add a main welcome screen to make a good first impression of the game. + +### Documentation + +To be honest, for now we do not have any documentation, because our users will have only game and actually do not need nothing except the game. All user flow is intuitive and not needed to be explained. + +For futute we will make a documentation for the guides, which will provide our game during excoursions, with tips for better user experience. But for now we do not have any functionality and extra features in the game, which needed to be explain. + +So the only thing that we need to document - is to how download/open our game and we still want to complete autodeploy, but faced many issues which we cannot solve yet. +So, we will add full description for setup the game in main [README](https://github.com/IU-Capstone-Project-2025/UniTrip) file in the repo. + +### ML Model Refinement + +To improve model we increased dataset size, update the marking and fine tune the model. Also we transfered it to cloud, because it takes a lot of time to train it locally. +Also to improve model we need to increased the dataset more and tune it, until we get the satisfied results. +# Weekly commitments + +## Individual contribution of each participant + +**Marina Lavrova(Lead)** - organized work and testing sessions with processing [feedback](https://docs.google.com/document/d/18jO7jkPARBSpUbOItuzbafxS_JxLzX5jkgCeENqB4MU/edit?usp=sharing), updated and re-prioritized the [backlog](https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog?selectedIssue=SCRUM-29), updated [ci/cd](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/310fa3b88d0286b4436193e6a34e96bb3f90d6c2) and tried to fix bugs with deploy (for now still unsuccessful) + +**Merkulov Leonid** - implemented the second part of [interactions](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/), [uploaded](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) 3d characters to the second location, added [background](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) with color to locations, fixed bug with [passing throug 1st guard](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/fbcb8eeced956ba8cd1fa666020cf13539e4f766), fixed [bugs with dialogues](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/a5384183b894242749f32dfdb6f3b5174caa31b0) on the second scene + +**Ivan Makarov** - learned model, transfered model to the [cloud]() to finalize learning, created [script](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/3e930e661fc34a4ecddb3c609ba8fdd2af5db01f) for the chat implementation in Unity + +**Tarubarova Nadia** - created [3D models of characters](https://drive.google.com/drive/folders/1SCWUktnMDkrhyACH4vOi0N1BnLhQe6C3?usp=sharing) for the second location, participated in collecting [feedback](https://docs.google.com/document/d/18jO7jkPARBSpUbOItuzbafxS_JxLzX5jkgCeENqB4MU/edit?usp=sharing) with testing session + +**Pokhodyaeva Polina** - created prototypes for [characters](https://drive.google.com/drive/folders/19CA7RVZOQfAbg5DHafCf4LmoHkSbdUoy?ths=true) on the second location, created sprites for vending machine [interaction](https://drive.google.com/drive/folders/1l544Uui6k347hi8mKcw143-x9YVVuBGj?ths=true) +## Plan for Next Week +- Design of the first screen(logo and start button) +- Create sprites for chat with ML +- Add design of the welcome screen to Unity +- Add interaction with ML chat in Unity +- Improve the visual part and fix bugs +- Add soundtracks +- Create a final presentation + + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [+] In working condition. +- [+] Run via docker-compose (or another alternative described in the `README.md`). \ No newline at end of file From dd64e66fc9613086c2d12799cb748adda30252ab Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 9 Jul 2025 23:50:53 +0300 Subject: [PATCH 14/15] fix: update info --- content/docs/2025/UniTrip/week5.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/docs/2025/UniTrip/week5.md b/content/docs/2025/UniTrip/week5.md index 89f7619ce..0bdbebecb 100644 --- a/content/docs/2025/UniTrip/week5.md +++ b/content/docs/2025/UniTrip/week5.md @@ -25,15 +25,15 @@ People suggest us to add more interactions, shadows with light, fill the backgro We created several issues, parts of them completed this week: 1. Add more interactions - add 2 interactions(108 auditorium and vending mashine) -2. Add the correct characters to the 2nd location -3. Fill the background with the color. +2. Fill the background with the color. Also for next week we planned to continue fixes according to feedback and will: -1. Fig bug with Professor Burmyakov asset -2. Improve interaction flow -3. Improve moving of the main character -4. Improve the animation of character's moving -5. Add shadows and ligth to the scenes +1. Add the correct characters to the 2nd location +2. Fig bug with Professor Burmyakov asset +3. Improve interaction flow +4. Improve moving of the main character +5. Improve the animation of character's moving +6. Add shadows and ligth to the scenes All the tasks stays with priority order. We focused first of all on main things, which is crutial for our project and will do as much as we can, but in priority way to not miss important things. First priority - good performance without bugs, second - the better visual. @@ -71,7 +71,7 @@ Also to improve model we need to increased the dataset more and tune it, until w **Marina Lavrova(Lead)** - organized work and testing sessions with processing [feedback](https://docs.google.com/document/d/18jO7jkPARBSpUbOItuzbafxS_JxLzX5jkgCeENqB4MU/edit?usp=sharing), updated and re-prioritized the [backlog](https://unitrip.atlassian.net/jira/software/projects/SCRUM/boards/1/backlog?selectedIssue=SCRUM-29), updated [ci/cd](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/310fa3b88d0286b4436193e6a34e96bb3f90d6c2) and tried to fix bugs with deploy (for now still unsuccessful) -**Merkulov Leonid** - implemented the second part of [interactions](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/), [uploaded](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) 3d characters to the second location, added [background](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) with color to locations, fixed bug with [passing throug 1st guard](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/fbcb8eeced956ba8cd1fa666020cf13539e4f766), fixed [bugs with dialogues](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/a5384183b894242749f32dfdb6f3b5174caa31b0) on the second scene +**Merkulov Leonid** - implemented the second part of [interactions](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/), added [background](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/main/) with color to locations, fixed bug with [passing throug 1st guard](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/fbcb8eeced956ba8cd1fa666020cf13539e4f766), fixed [bugs with dialogues](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/a5384183b894242749f32dfdb6f3b5174caa31b0) on the second scene **Ivan Makarov** - learned model, transfered model to the [cloud]() to finalize learning, created [script](https://github.com/IU-Capstone-Project-2025/UniTrip/commit/3e930e661fc34a4ecddb3c609ba8fdd2af5db01f) for the chat implementation in Unity @@ -84,7 +84,7 @@ Also to improve model we need to increased the dataset more and tune it, until w - Add design of the welcome screen to Unity - Add interaction with ML chat in Unity - Improve the visual part and fix bugs -- Add soundtracks +- Add soundtracks (if will have time) - Create a final presentation From b82a35a38e37bec40837dbb35732997620a852e1 Mon Sep 17 00:00:00 2001 From: mc_lavrushka Date: Wed, 16 Jul 2025 23:24:42 +0300 Subject: [PATCH 15/15] feat: lab06 submit --- content/docs/2025/UniTrip/week6.md | 92 ++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 content/docs/2025/UniTrip/week6.md diff --git a/content/docs/2025/UniTrip/week6.md b/content/docs/2025/UniTrip/week6.md new file mode 100644 index 000000000..b8659f364 --- /dev/null +++ b/content/docs/2025/UniTrip/week6.md @@ -0,0 +1,92 @@ +--- +title: "Week #6" +--- + +# **Week #6** + +Code Freeze date is this Sunday 20th of June. + +## Links + +- **Deployment**: https://github.com/IU-Capstone-Project-2025/UniTrip/deployments +https://github.com/IU-Capstone-Project-2025/UniTrip/releases +- **Design**: https://drive.google.com/drive/folders/1tUE_X1SlwDvRpjWii1ShtD2xwbUh5oWw?usp=sharing +- **Demo**: https://drive.google.com/drive/folders/1V3TFQ9x-W3XwaodKQAQTNzkMqSIU2pbS?usp=share_link +- **ML model**: https://huggingface.co/cody82/innopolis_bot_model + + +## Final deliverables + +### Project overview + + + +**UniTrip** is an interactive Unity-based game that offers a virtual tour of Innopolis University. +It is designed to help students, parents, and tourists explore university life even if they cannot visit it physically. + +The player explores detailed 2.5D university locations, interacts with NPCs (students and professors), and participates in mini-quests and dialogues to learn more about student life, infrastructure, and feel the atmosphere of the university. + +At the current stage, two locations are fully implemented — including quests, navigation, and NPC interactions. + +### Features + +- ✅ Two fully functional locations: + - **The outer hall**: 3 NPC's with dialogues, passing through metal detector and turnstile + - **Main Hall**: 2 NPC's and 2 miniquests: + - **Auditorium** - explore 108 room and find 3 objects + - **Vending Machine Zone**: buy some snacks or drinks +- ✅ Dialogue system for NPC's (professors, guards and student) +- ✅ Scene transition system +- ✅ Character movement + interaction trigger zones +- ✅ 3D models and assets designed in Blender and Procreate +- ✅ Signal "!" and "i" sings to all interactions +- 🚧 Basic implementation of chat interface (UI without final design) +- 🚧 ML model for AI-guide (integration pending, will be completed before Sunday) + +### Tech stack + +- **Unity** 2022.3.56f1 — game engine +- **Blender** — 3D modeling of characters and environment +- **Procreate** — 2D design of characters, objects, and UI +- **C#** — scripting and logic +- **Google Drive** — collaborative design/documents +- **GitHub + GitHub Pages** — version control and deployment +- **LLM-based AI (planned)** — used for contextual dialogue (in progress) + + +### Setup instructions + +Follow the webpage and open the game +https://github.com/IU-Capstone-Project-2025/UniTrip/deployments + +if it doesnt work becuase of some issues you could also use our released build here: +https://github.com/IU-Capstone-Project-2025/UniTrip/releases +## Presentation draft + +https://www.figma.com/design/i53mGIjdl5nX5xkG6WmsJ2/UniTrip?node-id=39-2&t=Y8yohbemqqmK2liK-1 +# Weekly commitments + +## Individual contribution of each participant + +**Marina Lavrova(Lead)** - organized work and managed the last tasks of the work, wrote [text](https://docs.google.com/document/d/1-o0qwfHCAGDmvtK15Bc0ViVmdquCL1-UFHGuJlWN9Gw/edit?usp=share_link) for final demo, created [demo](https://drive.google.com/drive/folders/1V3TFQ9x-W3XwaodKQAQTNzkMqSIU2pbS?usp=sharing) + +**Merkulov Leonid** - fixed interactions on the second location, added start screen with design, implemented chat screen - all [here](https://github.com/IU-Capstone-Project-2025/UniTrip/commits/v2.0.1/) + +**Ivan Makarov** - load the model to [hudging faces](https://huggingface.co/cody82/innopolis_bot_model), tune the model, trying to create connection with Untiy + +**Tarubarova Nadia** - created the [first screen](https://drive.google.com/drive/folders/1L1DSVXuyZEBRLMX37ywX76_2UyVmoYyY?usp=sharing) of the game, fixed the [text](https://docs.google.com/document/d/1-o0qwfHCAGDmvtK15Bc0ViVmdquCL1-UFHGuJlWN9Gw/edit?usp=share_link) for presentation + +**Pokhodyaeva Polina** - created a [prototype](https://drive.google.com/drive/folders/1mqKbgIN0dFVr1hg1rUJXAJVL_0jLILtM?usp=share_link) design of chat with ML, created the [draft](https://www.figma.com/design/i53mGIjdl5nX5xkG6WmsJ2/UniTrip?node-id=39-2&t=Y8yohbemqqmK2liK-1) of presentation + +## Plan for Next Week +> Until the Sunday + +- Finalize the chat with ML +- Add description to the 2 mini quests in 2nd location +- Minor bug fixes + +## Confirmation of the code's operability + +We confirm that the code in the main branch: +- [+] In working condition. +- [+] Run via docker-compose (or another alternative described in the `README.md`). \ No newline at end of file