Files
kawai-focus/README.md
2025-12-02 01:57:17 +03:00

103 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# kawai-focus
Kawai-Focus - приложение для фокусировки внимания на основе таймера Pomodoro.
Проект находится на стадии разработки MVP1:
- **Pomodoro** - таймеры для техники Pomodoro, которая управляет вашим временем работы и перерывами на отдых;
- **Гайд** - информация о том как использовать таймеры и приложение, а так же о самой технике Pomodoro;
- **Ограничение приложений** - управление ограничением работы отвлекающих от работы приложений.
## Стек
- **Python** - язык программирования;
- **Poetry** - инструмент для управления зависимостями и виртуальными окружениями;
- **Kivy** - фреймворк для создания кроссплатформенных приложений;
- **Форк KivyMD 2.0.0** - Material Design на Kivy.
## Экраны
**Экран Таймеры:**
![alt text](screen_examples/timers-1.png)
![alt text](screen_examples/timers-2.png)
**Экран Таймер:**
![alt text](screen_examples/timer-1.png)
![alt text](screen_examples/timer-2.png)
![alt text](screen_examples/timer-3.png)
![alt text](screen_examples/timer-4.png)
![alt text](screen_examples/timer-5.png)
**Экран Конструктор таймеров:**
В данный момент отключен, провобится работа по изменению дизана!
**Смена тем (примеры):**
![alt text](screen_examples/theme-1.png)
![alt text](screen_examples/theme-2.png)
![alt text](screen_examples/theme-3.png)
## Запуск
**Разработка dev:**
`poetry install && poetry run kawai-focus`
Для установки может потребоваться обновить хеши в poetry!
**Linux:**
На данный момент ведутся работы над сборкой flathub пакета для Linux!
**Windows:**
В планах собрать установщик!
**Mac OS:**
В планах собрать установщик!
## Автор
**Разработчик проекта:**
- **Имя и Фамилия** - Евгений Каддо
- **Никнейм** - Arduinum628
Подробно рассказываю о процессе написания кода приложения в своих статьях <a href="https://pressanybutton.ru/category/kawai-focus/">kawai-focus</a> на сайте <a href="https://pressanybutton.ru">Код на салфетке</a>.
<details>
<summary>
<strong>
Как оформлять ветки и коммиты
</strong>
</summary>
Пример ветки `nickname/name_task`
- **nickname** (никнейм в github);
- **name_task** (название задачи - название карточки на yougile).
Пример коммита `refactor: renaming a variable`
- **feat:** (новая функционал кода, БЕЗ учёта функционала для сборок);
- **devops:** (функционал для сборки, - добавление, удаление и исправление);
- **fix:** (исправление ошибок функционального кода);
- **docs:** (изменения в документации);
- **style:** (форматирование, отсутствующие точки с запятой и т.п., без изменения производственного кода);
- **refactor:** (рефакторинг производственного кода, например, переименование переменной);
- **test:** (добавление недостающих тестов, рефакторинг тестов; без изменения производственного кода);
- **chore:** (обновление рутинных задач и т. д.; без изменения производственного кода).
Оформление основано на https://www.conventionalcommits.org/en/v1.0.0/
</details>