Ozz Trade Diary

A Windows desktop trade journaling application for tracking trades across multiple markets — crypto, stocks, forex, futures, options, commodities, and more.

Status: Pre-release development (no public release yet)

Internal tracking versions: OzzTradeDiary 0.0.10, OzzTradeDiary.WPF 0.0.10, OzzTradeDiary.SQLite 0.0.10, OzzTradeDiary.i18n 0.0.10

Changelog

See CHANGELOG.md for release history.

Third-Party Assets

• This project uses icon paths derived from Bootstrap Icons.
• Source: https://icons.getbootstrap.com
• Project repository: https://github.com/twbs/icons
• Version: v1.13.1
• License: MIT
• SPDX License Identifier: MIT

Features

• DPI-aware multi-monitor window positioning
• Domain enums wired in models (including OrderType and TradeDirection)
• Generated SQLite schema includes OrderType for EntryOrder, TakeProfitOrder, and StopLossOrder
• Repositories implemented: Currency, Exchange, TradingAccount, Symbol
• AbstractDatabaseRepository base class provides shared ValidateOrThrow helper called in CreateAsync/UpdateAsync — throws ValidationException with all DataAnnotations error messages
• AbstractDiaryVM base ViewModel consolidates repository initialization and CRUD operations shared across ViewModels
• ModelValidator shared utility in TD.Validation for DataAnnotations-based model validation reusable by WPF, MAUI, and ASP.NET
• Dedicated localization project OzzTradeDiary.i18n with generated resources: ActionStrings, CommonStrings, ErrorStrings, LocalizedStrings, MessageStrings (default + tr)
• Model classes apply localized DataAnnotations using TD.i18n resources for display names and validation messages
• Maintenance window accessible from menu, with singleton window management (bring-to-front if already open)
• Maintenance window provides Add, Save, Refresh, and Delete (Exchange) CRUD operations for Currency, Exchange, TradingAccount, and Symbol
• DeleteExchangeCommand with CanExecute safety checks (disabled when exchange is referenced by Symbols or TradingAccounts) and Yes/No confirmation before deletion
• TradingAccountCreate dialog (renamed from CreateTradingAccount) and TradingAccountCreateVM (renamed from CreateTradingAccountVM) with icon-based action buttons, live per-field validation, inline error display, and OK button enabled only when all required fields are valid
• TradingAccountCreate and maintenance grids display ExchangeCode instead of numeric ExchangeId
• AccountCode property removed from TradingAccount model and generated DDL
• Shared validation styles ValidationTextBoxStyle and ValidationComboBoxStyle for consistent inline error display across forms
• ReadOnlyTextBoxStyle for non-editable fields with darker background cue; read-only bindings use Mode=OneWay
• TradingAccountEdit dialog for editing mutable fields (DisplayOrder, IsActive, Notes) of existing trading accounts; immutable fields (Title, ExchangeCode) displayed as read-only
• About dialog with auto-close on deactivation, high-resolution icon rendering, and GitHub link
• Bootstrap Icons rendered as window title bar icons via WindowExtensions
• Application version displayed in MainWindow title bar via AppVersion

Planned

• Remaining model repository classes in OzzTradeDiary.SQLite
• Functional data layer repositories and query logic
• Multi-market support: Stock, Forex, Crypto, Futures, Options, Commodities, and more
• Trade tracking with entry/exit orders, stop-loss, and take-profit levels
• Long and short trade directions
• Multiple order types: Market, Limit, Stop, StopLimit, TrailingStop
• Trade images with chart attachments and notes
• Multi-account and multi-exchange support
• Automatic SQLite database backup with ZIP archiving

Prerequisites

• .NET 10.0 SDK
• Windows 10 (build 19041) or later

Getting Started

# Clone the repository
git clone https://github.com/your-username/OzzTradeDiary.git
cd OzzTradeDiary

# Build
dotnet build OzzTradeDiary.slnx

# Run
dotnet run --project OzzTradeDiary.NET/OzzTradeDiary.WPF/OzzTradeDiary.WPF.csproj

Project Structure

View and ViewModel files use entity-first, verb-last naming (e.g., TradingAccountCreate.xaml, TradingAccountCreateVM.cs) so that files for the same entity sort together in Solution Explorer. Method names remain verb-first (e.g., CreateTradingAccount(), DeleteExchange()).

OzzTradeDiary.slnx
├── OzzTradeDiary.NET/
│   ├── OzzTradeDiary/            # Core models (TD namespace) — platform-independent
│   │   ├── Models/               # Trade, TradeImage, Symbol, Exchange, Currency, Orders, etc.
│   │   └── Validation/           # Shared DataAnnotations-based validation (TD.Validation.ModelValidator)
│   ├── OzzTradeDiary.i18n/       # Localization resources (TD.i18n namespace) — platform-independent, generated by OzzCodeGen/OzzGen
│   │   ├── *Strings.resx         # Base resources (Action/Common/Error/Localized/Message)
│   │   └── *Strings.tr.resx      # Turkish resources
│   ├── OzzTradeDiary.SQLite/     # Data access (TD.SQLite namespace) — platform-independent
│   │   ├── DbScripts/            # Generated SQL DDL scripts (one per model in OzzTradeDiary/Models)
│   │   └── Repositories/         # Data access repositories (one per entity)
│   └── OzzTradeDiary.WPF/        # Desktop UI (TD.WPF namespace) — Windows only
│       ├── Commands/             # ICommand implementations
│       ├── Extensions/           # String/text helpers
│       ├── Models/               # App settings, versioning, window positioning
│       ├── Resources/            # XAML styles, Bootstrap Icons
│       ├── Services/             # Database backup, auto-backup
│       ├── ViewModels/           # MVVM view models
│       │   └── Maintenance/      # ViewModels for maintenance screens (TD.WPF.ViewModels.Maintenance)
│       └── Views/                # XAML views
│           └── Maintenance/      # Maintenance window and related views (TD.WPF.Views.Maintenance)
└── OzzCodeGen/                   # Code generation settings
    ├── SqliteScriptsGen.settings # SQLite DDL generation config
    ├── ResourceGen.settings      # Localization resource generation config
    └── Vocabulary/               # English/Turkish translation files

Architecture

Four-project MVVM architecture layered for platform portability:

Project	Target	Role
OzzTradeDiary	net10.0	Core data models and shared validation utilities (for example TD.Validation.ModelValidator) with no platform dependencies
OzzTradeDiary.i18n	net10.0	Shared localization resources (*.resx/designer classes) generated from OzzCodeGen/OzzGen inputs
OzzTradeDiary.SQLite	net10.0	Data access layer — raw SQLite via Microsoft.Data.Sqlite, repository pattern
OzzTradeDiary.WPF	net10.0-windows10.0.19041.0	WPF desktop frontend — views, view models, commands, services

Core models, localization resources, and data access are platform-independent, enabling future frontends (MAUI, web, etc.) to reuse them. Model classes localize display metadata and validation messages through DataAnnotations that reference TD.i18n resource types.

SQLite Repository and Script Conventions

• Model names are singular; related table names are plural.
• Each model has a generated DDL file in OzzTradeDiary.SQLite/DbScripts with the same model name and .sql suffix.
• Some models have generated seed files named <PluralTableName>-Data.sql in OzzTradeDiary.SQLite/DbScripts.
• DDL and seed files are generated by OzzCodeGen; do not edit manually.
• Each repository CUD operation updates metadata timestamp via SaveLastUpdateUtcAsync in SqliteDatabaseMetadataRepository.
• When adding a generated seed file <PluralTableName>-Data.sql, the corresponding repository InitializeDatabase() should call SqliteDbScriptInitializer.SeedIfEmpty(connection, "<PluralTableName>", "<PluralTableName>-Data.sql").
• Immutable repository keys:
  • Currency.CurrencyTicker
  • Exchange.ExchangeCode
  • Symbol.TickerFull

Database Initialization and Seed Data

At repository startup, initialization executes generated DDL scripts and applies baseline seed scripts only when target tables are empty.

• Seeding is idempotent and uses SqliteDbScriptInitializer.SeedIfEmpty(...).
• Current generated seed scripts include:
  • OzzTradeDiary.SQLite/DbScripts/Currencies-Data.sql
  • OzzTradeDiary.SQLite/DbScripts/Exchanges-Data.sql
  • OzzTradeDiary.SQLite/DbScripts/Symbols-Data.sql

Dependencies

Package	Version	Project
Microsoft.Data.Sqlite	10.0.3	OzzTradeDiary.SQLite, OzzTradeDiary.WPF

Code Generation

SQLite DDL scripts and localization resources are generated by OzzCodeGen — a separate code generation tool. Configuration lives in OzzCodeGen/:

• SqliteScriptsGen.settings — maps C# models to SQLite CREATE TABLE scripts in DbScripts/
• ResourceGen.settings — generates localization resources from vocabulary XML files
• Vocabulary/ — bilingual term definitions (English/Turkish)
• LocalizedStrings.resx is sourced from OzzTradeDiary.OzzGen
• Model classes and database schema generation are sourced from OzzTradeDiary.OzzGen
• Generated model metadata includes DataAnnotations that use TD.i18n resources for UI display names and validation messages

Do not edit generated files manually (DbScripts/*.sql, generated .resx, and generated designer/model/schema outputs) — they are overwritten on regeneration.

License

MIT License — Copyright © 2026 Ozalp Donduren