Язык / Language: Русский · English

ZeTer OS

ZeTer OS — гибридное рабочее пространство для Windows на Python, pywebview, HTML, CSS и JavaScript. Оно объединяет заметки, задачи, календарь, файлы, таблицы, изображения и другие повседневные инструменты в одном локальном приложении.

Проект сочетает desktop-оболочку на Python с модульным web-интерфейсом и делает упор на локальное хранение данных, резервное копирование, восстановление и понятную архитектуру.

🌐 Веб-версия: https://dkl.do.am/portfolio/ZeTerOS/index.html

Что демонстрирует проект

• гибридную desktop-архитектуру Python + HTML/CSS/JavaScript;
• интеграцию frontend ↔ native через pywebview bridge;
• local-first подход к пользовательским данным;
• разбиение крупного frontend-кода на функциональные модули и зоны ответственности;
• экспорт данных, резервные копии и точки восстановления как часть продуктовой архитектуры;
• собственные структурные проверки и сценарные smoke-тесты;
• подготовку portable-релиза с отделением пользовательских данных от исходников и служебных файлов.

Основные возможности

• несколько независимых рабочих пространств;
• заметки, задачи, календарь, таблицы, файлы и работа с изображениями;
• локальное хранение пользовательских данных;
• интеграция Python ↔ JavaScript через pywebview;
• экспорт данных в привычные форматы Windows;
• резервные копии и точки восстановления;
• автозапуск Windows без обязательных прав администратора;
• portable-сборка;
• модульная JavaScript-архитектура;
• структурные проверки и smoke-тесты.

Установка

Вариант 1 — веб-версия

Чтобы посмотреть интерфейс и основные возможности, откройте веб-версию:

https://dkl.do.am/portfolio/ZeTerOS/index.html

Вариант 2 — локальная desktop-версия

1. Установите Python 3 для Windows.
2. Скачайте проект через Code → Download ZIP или Git:

git clone https://github.com/zeter1/ZeTer-OS.git
cd ZeTer-OS

3. Установите зависимости:

py -3 -m pip install -r requirements.txt

Для полного набора JavaScript-проверок рекомендуется Node.js 22.

Запуск

py -3 run_zeter_os.py

или:

start_zeter_os.cmd

Как пользоваться

1. Запустите ZeTer OS.
2. Создайте или выберите рабочее пространство.
3. Используйте нужные модули: заметки, задачи, календарь, таблицы, файлы и другие инструменты.
4. Данные сохраняются локально, поэтому после следующего запуска рабочее состояние можно продолжить.
5. Для важных данных используйте экспорт и резервное копирование.
6. Перед крупными изменениями или переносом программы создайте точку восстановления.

ZeTer OS задуман как единая локальная среда, поэтому основные разделы работают как части одного рабочего пространства, а не как набор независимых страниц.

Архитектура

ZeTer OS
├── run_zeter_os.py          # Python-точка входа и native bridge
├── problem_logs.py          # централизованная диагностика
├── app/
│   ├── index.html
│   ├── css/
│   └── js/
│       ├── app.js           # корневая композиция
│       └── core/            # функциональные модули
├── docs/
├── tools/
├── build_release.cmd
└── check_project.cmd

Frontend разделён на специализированные модули, а app/js/app.js остаётся центральной точкой композиции состояния приложения, DOM, окон, сохранения данных и native-адаптеров.

Данные и надёжность

Desktop-версия хранит рабочее состояние локально в каталоге data/ рядом с приложением. Пользовательские данные не включаются в Git.

Поддерживается экспорт важных данных, включая DOCX, CSV и ICS. Также предусмотрены резервные копии и точки восстановления. Portable-релизы создаются без пользовательских данных, логов и файлов разработки.

Проверка проекта

Базовая структурная проверка:

python tools/check_project.py

JavaScript smoke-тесты:

node tools/run_smokes.js

Полная Windows-проверка:

.\check_project.cmd --strict-node --no-pause

GitHub Actions компилирует Python-часть и запускает python tools/check_project.py --strict-node на Windows с Python и Node.js. Реальные desktop-сценарии с окном pywebview, файловыми диалогами и пользовательскими данными дополнительно требуют runtime-проверки.

Документация

Каталог docs/ описывает архитектуру и зоны ответственности модулей, модель данных, Python/native bridge, frontend-контракты, тестирование, диагностику и UI-сценарии.

AGENTS.md содержит правила разработки проекта с помощью AI-инструментов.

Поддержка и безопасность

• SUPPORT.md — какие данные полезно приложить к сообщению об ошибке;
• GitHub Issues — обычные воспроизводимые ошибки;
• SECURITY.md — сообщения о потенциальных уязвимостях.

Portable-сборка

build_release.cmd

Сборщик исключает пользовательские данные, Git-метаданные и служебные файлы разработки.

Лицензия

Проект не распространяется по открытой лицензии. Исходный код опубликован как часть портфолио и для ознакомления с реализацией.