Repository navigation
Releases: kosavan/mashina
Release list
MASHINA 1.8.1 — faster vehicle profile photos
MASHINA 1.8.1
Vehicle profiles now display the same compact, authorized WebP preview as garage
cards, avoiding another full-size download when opening a car. Existing photos work
without uploading them again. Original attachment bytes, downloads and report photos
are unchanged. Images decode asynchronously.
A browser regression uploads a large synthetic photo, opens the mobile profile,
verifies that the image renders through the preview endpoint and confirms that the
download still returns the original. No schema, API, dependency or configuration
change; preserve browser storage and offline queues when updating.
Update and rollback · Russian update guide
Verified source: 1912d281dad5037f6055dbb6dabeb3091dce06b6. Exact-source Linux CI.
274 backend tests, 34 frontend unit tests and 53 browser scenarios pass. Includes native OCR, supported-schema upgrades and actual restore/restart inside the read-only non-root production container. Source-only release; no user data, secrets or server infrastructure changes.
MASHINA 1.8.0 — mobile, photos, languages and local OCR
MASHINA 1.8.0
A clearer installed PWA, lighter garage photos, eight languages and more capable local OCR.
- Safe-area-aware header/menu/title in portrait and landscape, with Chromium and WebKit regression coverage.
- Compact authorized WebP card previews for existing and new photos. Original files, hashes, IDs, downloads and report images stay intact.
- Simplified Chinese, Hindi, Spanish, Arabic (RTL) and French join Russian, English and German. New catalogs load on demand; offline switching remains available.
- Clockwise rotation, crop preview, up to three selected PDF pages and editable, opt-in line items from simple labelled service tables. Normal Save remains the only financial write.
- Preserve supported old payloads, schemas 001-007, settings, attachment references, exact amounts and offline operation IDs. No schema/configuration/dependency change from 1.7.
Update and rollback · Russian update guide · Languages · Local OCR · Validation
Back up the complete garage and retain the old image before updating. Old servers do not accept the new language/OCR options: update backend and frontend together. Preview caches are rebuildable and not operational backups. OCR uses local rus/eng data; complex tables and difficult instrument displays still need review. Physical iPhone validation remains separate from automated WebKit coverage.
Verified source: 6d53c791029b33b320a47db6982396437c45469c. Exact-source Linux CI.
274 backend tests, 34 frontend unit tests and 52 browser scenarios pass. Includes native OCR, supported-schema upgrades and actual restore/restart inside the read-only non-root production container. Source-only release; no user data, secrets or server infrastructure changes.
MASHINA 1.7.0 — German interface
MASHINA 1.7.0
German joins your garage, following community request #20.
- Choose Deutsch before setup/sign-in/demo or in Settings.
- Complete German interface and isolated demo, including forms, validation, body damage, sharing and import; German date/number formatting.
- Save account language through the durable offline queue without changing personal records, exact money, currency or units.
- German README and update/rollback walkthrough; updated English/Russian guides, roadmap and product-page language metadata.
- Bundled translation catalogs are cached with the app shell for offline switching. No external translation service.
- Scroll the sidebar on shorter screens so longer German labels keep the theme and account controls reachable.
German introduction · German update instructions · English update guide · Russian update guide · Validation
No schema change from 1.6.0 (007), new dependency or configuration. Update backend and frontend together; old servers reject German settings. Older installations still apply the intervening migrations. Keep a full backup and the previous image. PDF/CSV output labels, external notification payloads and OCR recognition languages retain their existing scope; German OCR is not added. User-entered content is never translated.
Verified source: 29c2cdfd66978facd646f81dfde9259edcef0685. Exact-source Linux CI.
247 backend tests, 29 frontend unit tests and 41 browser scenarios pass. Includes native OCR, supported-schema upgrades and actual restore/restart inside the read-only non-root production container. Source-only release; no user data, secrets or server infrastructure changes.
MASHINA 1.6.0 — Body condition and repair history
MASHINA 1.6.0
A bodywork history for every car.
- Five interactive body views with panel/point markers and multiple issues per panel.
- Damage types, owner-assessed severity, discovery/repair dates, notes and optional contextual mileage.
- Status filters, dated repair/reopening history, soft deletion and undo.
- Local before/after photos, existing image reuse and same-car service links. Estimates remain separate from actual costs; damage never creates an expense or odometer reading.
- Mobile English/Russian dark/light UI, keyboard controls, accessible list and isolated fictional demo issues.
- Durable offline text/marker create/edit and idempotent synchronization. New photo files require an online upload and stay only in the open editor until uploaded.
- JSON/CSV and full database/file backup include damage history. Additive schema 007 preserves supported installations and snapshots older schemas before upgrade.
- Fix sequential create/photo-link saves to check authorization against the latest client state.
Body condition guide · Russian guide · Update / rollback · Roadmap
Read the update guide first. Older images cannot open schema 007: rollback requires the matching pre-upgrade data and image. No new dependencies, external services or infrastructure changes. Generic diagrams and owner observations; physical iPhone/arm64 validation remains open.
Verified source: 015ba25c956058eb9b9377e4f181c508202296dd. Exact-source Linux CI.
Validation: 242 backend tests, 27 frontend unit tests and 38 browser scenarios.
Includes native OCR, supported-schema upgrades, all mobile/browser regressions and full damage/photo/history restore followed by restart in the read-only non-root production container. Source-only release; no user files or backups.
MASHINA 1.5.1 — Safe updates and maintenance audit
MASHINA 1.5.1
Maintenance audit, safe updates and a living bilingual roadmap.
- Fix backup restoration inside read-only non-root containers and recover from failures during every initial file swap.
- Preserve unrelated and future preferences on partial settings updates; language changes send only their own field.
- Before an installed schema upgrades, retain a private full recovery snapshot. Refuse newer/unknown/unversioned existing schemas without resetting data.
- Test actual Alembic upgrades for every supported schema 001–006 and retain immutable fingerprints of released migrations.
- Serialize overlapping offline/reconnect synchronization requests so pending records are not stranded.
- Serve bundled fonts as local files compatible with the existing self-only font policy.
- Publish shipped/planned/research roadmap, complete English user guides with separate Russian versions, and update/rollback walkthroughs for Linux, macOS and Windows.
- Extend CI with English documentation/link checks and a real production-container restore drill. Include the prior offline lazy-module caching fix.
Roadmap · Update / rollback · Russian update guide · Audit and remaining limits
No schema revision, external service or infrastructure change. Preserve your existing data and environment; read the update guide before switching versions. Publication requires full Linux/native OCR/browser/container CI. Hardware-specific validation and large-archive streaming remain open.
Verified main source: df8a894b272e79c38d4dd0681d5af44089d99c01. Linux CI: https://github.com/kosavan/mashina/actions/runs/38258923938
216 backend, 25 frontend and 35 browser tests pass; production read-only-container restore, health and actual PNG/PDF OCR pass. English documentation and released-migration checks pass.
MASHINA 1.5 — Local OCR
MASHINA 1.5.0
Fully local text OCR for receipts, workshop invoices/work orders, dashboard photographs and arbitrary screenshots.
- Read JPEG/PNG/WebP or a selected PDF page on the owner's server using bundled Tesseract rus+eng and Poppler. No external provider, paid API, cloud fallback or runtime model download.
- Inspect text, edit suggestions and explicitly select fields to apply to fuel, expense, maintenance or odometer drafts. All checkboxes start unchecked. Original attachment is opt-in.
- Recognition never saves a financial/mileage record. Normal Save preserves exact validation, historical mileage warnings and idempotency. Full tank, currency, trip/range/miles and ambiguous numbers are not guessed.
- Bounded on-demand processing, one job/CPU thread, private temporary files, time/resource limits, authorization and post-processing revocation checks.
- Updated roadmap includes general screenshots, workshop line-item extraction, crop/rotation and local-only future improvements.
Local OCR guide and limits · Roadmap
First local text-recognition slice, not universal document understanding. One PDF page per request; workshop line items remain manual from extracted text. Seven-segment/unlabelled/glare-heavy dashboards may require manual input. Offline OCR needs the local server; ordinary manual offline entry continues. No schema migration or infrastructure change. Real-engine Linux CI is mandatory before publication; Windows local native OCR is not installed.
Финальный Linux Docker CI успешно пройден: https://github.com/kosavan/mashina/actions/runs/38245792748
Проверенный исходный коммит: 2392dde998cda9bdb413164f44a8a2ce97a9d12a.
MASHINA 1.4 — English and Russian
MASHINA 1.4.0
English and Russian, from the first setup to daily use.
- Choose the interface language before setup/sign-in/demo and change it in Settings.
- Local UI resources cover navigation, forms, feedback, accessibility labels, date/number formatting and analytics. Account preferences synchronize safely after offline changes.
- User names, notes, documents, canonical categories, exact monetary values and units remain unchanged. The isolated demo has a separate localized presentation.
- English and Russian READMEs now have matching screenshots and Hyperframes infographics. Analytics screenshots select Volvo XC60 to avoid connecting different vehicles' fuel histories.
- Fixed administrator backup controls being hidden in Settings.
- Both README footers: Vibecoded with love ❤️
Validation and limitations · macOS / Windows testing
Russian remains the default. No schema migration, translation API or infrastructure change. Export/PDF contents and external notification payloads keep their existing language; no currency/unit conversion. Physical iPhone and separate macOS/arm64 Docker remain unverified. Existing OCR/AI and other future integrations are outside this release.
Финальный Linux Docker CI успешно пройден: https://github.com/kosavan/mashina/actions/runs/38227479354
Проверенный исходный коммит: 1822409d007ae6ede62a1c06ce8c3619d5ed513c.
MASHINA 1.3 — tire care and green Apex M
MASHINA 1.3.0
A more personal garage: dedicated tire care, clearer fuel analytics and a new green Apex M identity.
- Fixed Fuel → charts to keep the selected vehicle and fuel filter, including demo and mobile.
- Reworked welcome artwork, replaced branding with the owner-approved green logo, favicon and iOS/PWA icons.
- Added dedicated Tires navigation, oldest-tire DOT, dated tread measurements and a personal replacement threshold. Unknown condition stays unknown; guidance distinguishes manufacture age from service life.
- Added private service addresses and optional coordinates. Styled OpenStreetMap view loads only after an explicit disclosed action; no automatic geocoding or GPS tracking.
- Improved per-vehicle fuel defaults and receipt/payment entry guidance. Full tank requires confirmation; no automatic screenshot recognition is claimed.
- Rebuilt the GitHub landing page in English with a Russian option, a local Hyperframes infographic and isolated demo screenshots.
- Included macOS/Windows testing, self-hosting, capture strategy and tire/location documentation.
Installation and testing · Validation evidence and limitations
Source-only release. Back up database and attachments before updating; new JSON fields are additive and no destructive migration is added. Physical iPhone, separate arm64/macOS Docker and real external notifications remain unverified. OCR and the remaining 2.0 integrations are still future work.
Финальный Linux Docker CI успешно пройден: https://github.com/kosavan/mashina/actions/runs/38222370220
Проверенный исходный коммит: 4f43c10fcfcea41384ec8cf89fe601b4655b30ab.
MASHINA 1.2 — personal garage, bank review and scoped API/MCP
MASHINA 1.2.0
Проверенный текущий срез персонального self-hosted гаража. Релиз фиксирует готовый
функционал по просьбе владельца; дальнейшее расширение временно остановлено.
Это не полный запланированный релиз 2.0.
Что входит
Всё из 1.1: несколько автомобилей и их история, точные расходы/заправки/ТО,
файлы/документы, напоминания, аналитика, офлайн-очередь/PWA, изолированное демо,
шины/детали, бюджеты/план затрат, CSV, совместный доступ, локальный PDF для продажи,
опциональные Push/Telegram-напоминания, полный бэкап/восстановление/экспорт.
Дополнительно:
- Локальный банковский CSV с явным сопоставлением, проверкой совпадений и подтверждением
связи с уже учтённой заправкой/ТО. Стабильные ID и транзакционные receipts защищают
от повторного учёта; банковские данные приватны. - Выключенный по умолчанию ограниченный API: ключи с выбранными автомобилями,
сроком жизни, чтением по умолчанию и отдельным разрешением записи. Секрет показывается
один раз. Отзыв, смена пароля, отключение аккаунта и restore аннулируют доступ. - Необязательный read-only MCP через STDIO: машины, ограниченная история, напоминания
и эксплуатационная аналитика. Современный 2026-07-28 и совместимый 2025-11-25 протоколы,
проверяемый TLS, лимиты запросов/ответов и отмена. Документы/учётные записи/банковская
сверка/бэкапы этим ключам недоступны.
Как проверить и развернуть
Подробная инструкция с тестовыми сценариями.
Исходники не содержат паролей, API-ключей, личной истории и вложений.
Перед обновлением обязательно скачайте полный бэкап на другой диск.
Миграция 006 аддитивная; восстановление проверяет архивы старых схем 001–005.
После restore внешние уведомления на паузе, machine-ключи отозваны.
Проверки
Локально прошли 159 Pytest, 17 Vitest и все 21 headless Playwright, статические проверки
и production-сборка. Основной JS 129,1 КиБ gzip при бюджете 180 КиБ.
Отчёт проверки; успешный финальный Linux Docker CI
обязателен перед публикацией тега. Ссылка на него прилагается к GitHub-релизу.
Физический iPhone, реальные внешние уведомления и отдельная arm64-машина не проверялись.
Не включено
AI-распознавание документов с подтверждением черновика, поиск естественным языком,
Telegram-ввод расходов, OBD-II, Passkeys. Незавершённая основа распознавания сохранена
отдельно в codex/mashina-document-review; не подключена к стабильному UI/API.
Банковский импорт — CSV с явным сопоставлением, без прямого банковского доступа,
распознавания PDF/XLSX или автоматического принятия совпадений.
Предыдущий релиз: MASHINA 1.1.0.
Финальный Linux Docker CI успешно пройден: https://github.com/kosavan/mashina/actions/runs/38210619569
Проверенный исходный коммит: 094f6b9844327e417441d54f1d43eecc2d35dbc9.
Дополнение к инструкции: запуск и тестирование на macOS и Windows. Код приложения и тег1.2.0 не изменены.
MASHINA 1.1 — ownership, sharing and private reminders
MASHINA 1.1
Самостоятельный цифровой гараж с русским мобильным интерфейсом, локальными данными и изолированным интерактивным демо.
Что добавлено после MVP
- Комплекты шин и подтверждённая история использования; каталог установленных деталей из реальных ТО.
- Точные бюджеты, регулярные платежи и оценки ближайшего обслуживания. Неизвестные суммы и сроки по пробегу остаются явными; план не меняет расходы.
- Предпросмотр/подтверждение CSV и защита от повторного импорта.
- Локальные аккаунты, роли владельца/водителя, приватность документов и сохранение заблокированных офлайн-черновиков после отзыва доступа.
- Локальный PDF для продажи с отдельным согласием на раскрытие фотографий, идентификаторов, цен и описаний.
- Опциональные Push/Telegram с явным согласием, общим текстом без личных данных, безопасным транспортом, журналом неопределённых отправок и паузой после восстановления.
- Исправлены период владения при исторических показаниях и повторяющиеся сроки ТО; офлайн-завершение не придумывает пробег.
Проверки и эксплуатация
83 Pytest, 14 Vitest, 18 headless Playwright; static checks и production build. Linux Docker CI 38189942873 и healthcheck прошли; финальный коммит версии также прошёл полный CI перед тегом. Основной JS 129 КБ gzip при бюджете 180 КБ. Полные архивы включают SQLite и вложения; совместимы старые схемы 001–004. Расширение оценок ТО не меняет физическую схему 004.
Перед обновлением создайте полный приватный бэкап и остановите необязательный таймер уведомлений на время восстановления. Каналы после restore остаются на паузе. HTTPS настраивается владельцем сервера; iPhone физически не проверен. Реальные внешние доставки не выполнялись при разработке. Linux amd64 проверяется CI; arm64 поддерживает Dockerfile, но отдельная проверка аппаратуры не заявляется. Исходники не содержат личной истории, загруженных документов, токенов и рабочих конфигураций.
Следующий этап
Релиз 2.0: необязательное распознавание документов с обязательным подтверждением, поиск естественным языком, Telegram-ввод, банковский импорт с проверкой совпадений, открытый API/MCP и отдельный OBD-II-компонент. Эти возможности не заявляются готовыми в 1.1.