wtandClaude Opus 5.5 94177dbb0b
Build / Build (watchOS Simulator) (push) Canceled after 0s
Build / Build (watchOS Device) (push) Canceled after 0s
Fix launch crash: rename SyncRecord.entity to entityName
CoreData treats `entity` as the managed object's entity, so the predicate
`entity == "setting"` became a fetch of an entity named "setting" and the
app aborted at launch ("setting" is not a valid entity name). The model is
new in the unreleased contract v2 change, so no migration is needed.

Verified on the watchOS 27.2 simulator: launch, login to a local
BalanceServer v2, total balance 57 800 ₽ with a USD account converted at
the synced rate and a cross-currency transfer, per-account balances
39 800 ₽ and $200.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 01:53:36 +07:00
2026-10-30 12:24:11 +07:00
2026-10-30 12:24:11 +07:00
2026-10-30 16:58:03 +07:00
2026-10-30 12:24:11 +07:00

BalanceWatch — учёт личных финансов на Apple Watch

BalanceWatch

Самостоятельное (watch-only) приложение Balance для watchOS 10+, выделенное из монорепозитория Balance (Balance/BalanceWatch + общий код).

Стек: SwiftUI + SwiftData, синхронизация через self-hosted BalanceServer.

Структура

BalanceWatch/
├── branding/             # аватар и баннер для README (PNG + SVG-исходники)
├── docs/CONTRACT_V2.md   # общий контракт экосистемы v2 (копия, одинаковая во всех репозиториях)
├── BalanceWatch.xcodeproj/
└── BalanceWatch/
    ├── App/              # точка входа и экраны часов
    ├── Models/           # SwiftData-модели (копия из монорепы)
    ├── Shared/           # контейнер SwiftData, тема, ServerSync
    ├── Utilities/        # FinanceCalculations, Money (сотые, курсы), форматирование валют
    ├── Views/Components/ # CategoryIconView
    └── Assets.xcassets   # иконка приложения

Проект использует папки, синхронизируемые с файловой системой (Xcode 16+): любой .swift-файл, положенный в BalanceWatch/, автоматически попадает в таргет — править project.pbxproj вручную не нужно.

Контракт v2

Часы реализуют клиентскую часть docs/CONTRACT_V2.md в компактном виде:

  • синхронизируются и хранятся счета, переводы, курсы и настройка baseCurrency; общий баланс, аналитика и бюджеты считаются в базовой валюте, при отсутствии курса показывается «нет курса C→B»;
  • экран «Счета» (только чтение) с балансами счетов и «Без счёта»; при добавлении операции можно выбрать счёт, валюта следует за счётом;
  • общие бюджеты: в «Настройки → Сервер → Бюджет» выбирается личное или общее пространство, можно присоединиться по коду; данные каждого пространства лежат в отдельном хранилище;
  • регулярные операции, цели, долги, вложения и теги хранятся и не теряются при пересохранении, но интерфейса для них нет; регулярные операции часы не создают;
  • если GET /v1/capabilities отвечает 404 (сервер v1), счета и общие бюджеты скрыты, новые сущности не отправляются.

Сборка

  1. Открыть BalanceWatch.xcodeproj в Xcode 16 или новее.
  2. Выбрать схему BalanceWatch и симулятор Apple Watch.
  3. В Signing & Capabilities при необходимости поменять Team и bundle id (com.tolamironcenko.Balance.watchkitapp).

Из командной строки:

xcodebuild -project BalanceWatch.xcodeproj -scheme BalanceWatch \
  -destination 'generic/platform=watchOS Simulator' build

CI

GitHub Actions (.github/workflows/build.yml) собирает проект на macos-15 с последним стабильным Xcode для двух назначений — watchOS Simulator и watchOS device (без подписи). Запускается на push в main/develop, на pull request и вручную (Run workflow). При падении лог xcodebuild прикладывается к запуску как артефакт.

Важно

Модели, FinanceCalculations.swift и ServerSync.swift — копии общего кода из монорепозитория. Протокол синхронизации и правила расчётов должны совпадать с остальными клиентами Balance: при изменении контракта на сервере переносите правки и сюда.

S
Description
Standalone Apple Watch app for personal finance tracking. SwiftUI + SwiftData, syncs with a self-hosted Balance server. watchOS 10+.
Readme
2.6 MiB
0 Stars 1 Watchers 0 Forks
2026-10-31 19:23:45 +00:00
Languages
Swift 99.3%
Shell 0.7%