Files
kawai-focus/README.md
2026-06-22 18:21:15 +03:00

101 lines
3.9 KiB
Markdown
Raw Permalink 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 (Linux):**
`poetry install && alembic upgrade head && poetry run filling_example_timers`
`poetry run kawai-focus`
**Linux:**
На данный момент ведутся работы над сборкой flathub пакета для Linux!
**Windows:**
В планах собрать установщик!
**Mac OS:**
В планах собрать установщик!
## Автор
**Разработчик проекта:**
- **Имя и Фамилия** - Евгений Каддо
- **Никнейм** - Arduinum628
<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>