Commit Graph
5 Commits
Author SHA1 Message Date
rick f9dbb889f9 Add Database Layer and Common/Basic types (sections 5-6)
CI / docker (push) Has been cancelled
CI / build-and-test (push) Has started running
Section 6 — Common & Basic Layers:
- Money value type: Int64 cents, currency-aware arithmetic, ToCurrency
  with double intermediate (deliberate), display formatting for fiat
  (2 decimal) and crypto (6 decimal)
- 16 Basic types matching v6 schema: BasicOrganization (all denormalized
  OOD fields), BasicUser, BasicFinancialAccount (OwnerUserId, native
  currency, bitcoin fields), BasicFinancialTransaction (OrganizationSequenceId,
  BlockchainHash), BasicFinancialTransactionRow (foreign currency, bitcoin
  derivation), BasicExpenseClaim, BasicInboundInvoice, BasicOutboundInvoice,
  BasicPayout, BasicPayment, BasicPaymentGroup, BasicRefund, BasicDocument,
  BasicCurrency, BasicHotWalletAddress, BasicHotWalletUtxo

Section 5 — Database Layer:
- DatabaseConnection: three-tier factory (read/write/admin), Galera-aware,
  MySqlConnector-based
- DatabaseCredentials + DatabaseConfig for appsettings binding
- RepositoryBase: stored proc + text command helpers, parameter binding,
  type-safe reader helpers
- FinancialRepository: accounts, transactions, rows, dependencies,
  balances, budgets, unbalanced tx detection, period closing
- ApArRepository: expense claims, inbound/outbound invoices, payouts
- UserRepository: users, RBAC permissions, role assignment
- OrganizationRepository: orgs with full denormalized settings
- CryptoRepository: hot wallet addresses, UTXOs
- DocumentRepository: document metadata, typed foreign object queries
- CurrencyRepository: currencies, exchange rate snapshots/datapoints
  with micro-BTC scaling awareness
- SupportRepository: mail queue, event queue, system settings, templates

Made-with: Cursor
2026-04-08 16:38:59 +02:00
rick 40eefc6163 Add stored procedures, triggers, grants, and seed data (section 4)
CI / docker (push) Has been cancelled
CI / build-and-test (push) Has started running
Stored procedures organized by domain:
- 003-procedures-financial.sql: CreateFinancialTransaction (with gap-free
  OrganizationSequenceId), AddTransactionRow (with foreign currency),
  tag/dependency management, account CRUD, budgets, period closing
- 004-procedures-apar.sql: Expense claims (with VatCents, groups),
  inbound/outbound invoices (with sequence IDs, VAT), payouts, payments,
  payment groups, refunds, documents
- 005-procedures-support.sql: Users, RBAC (roles/permissions/assignments),
  organizations (VAT config, tax info), crypto (hot wallet addresses,
  UTXOs), exchange rates (micro-BTC scaling), mail queue, event queue,
  system settings

Security layer:
- 006-triggers.sql: INSERT/UPDATE/DELETE triggers on FinancialTransactionRows
  that reject operations where the transaction date falls in a closed
  fiscal period (defense-in-depth alongside application enforcement)
- 007-grants.sql: Three-tier MySQL users (uc_read SELECT, uc_write
  EXECUTE, uc_admin ALL)

Seed data:
- 008-seed.sql: Financial dependency types, BCH crypto chain, schema version

Combined initialization script:
- 000-initialize.sql: Runs all files in order

Made-with: Cursor
2026-04-08 16:28:33 +02:00
rick 0514b9bd18 Add v6 database schema DDL (sections 2-3)
Two schema files covering all v6 tables:
- 001-tables.sql: Organizations (denormalized OOD), Users, Roles/RBAC,
  FinancialAccounts (with OwnerUserId, native currency, bitcoin fields),
  FinancialTransactions (with OrganizationSequenceId, BlockchainHash),
  FinancialTransactionRows (with foreign currency, bitcoin derivation),
  Dependencies, Tags/TagSets/TagTypes, Budgets
- 002-tables-apar.sql: ExpenseClaims (with VatCents, groups),
  InboundInvoices (with native currency, bitcoin satoshis),
  OutboundInvoices + Items (with credit links, VAT),
  Payouts, PaymentGroups, Payments, Refunds, Documents,
  FinancialAccountDocuments, Currencies, ExchangeRateSnapshots +
  Datapoints (micro-BTC scaling), CryptoChains, HotWalletAddresses,
  HotWalletUtxos, MailQueue, MailTemplates, EventQueue, SystemSettings

Key v5→v6 differences:
- ObjectOptionalData EAV denormalized to first-class columns
- FinancialTransactionRowsNativeCurrency merged into Rows table
- People → Users (simplified, no geography/membership)
- utf8mb4 throughout, no legacy latin1
- Amount (double) columns removed; AmountCents (bigint) only
- Budget tables unified (annual + monthly in one table)
- v5 FlatData → SystemSettings

Also updates data-migration spec for mysqldump-based workflow.

Made-with: Cursor
2026-04-08 16:25:58 +02:00
rick 8aafe681b1 Scaffold v6 solution, frontend, CI, and Docker
CI / docker (push) Has been cancelled
CI / build-and-test (push) Has been cancelled
Section 1 complete (tasks 1.1-1.7):
- .NET 8 solution with 8 projects (Common, Basic, Database, Logic, Api,
  Backend, Migration, Tests) and correct dependency graph
- NuGet deps: MySqlConnector, NBitcoin, Microsoft.Extensions.Hosting,
  xunit, coverlet
- Common layer: IHasIdentity, enums (Permission, FinancialAccountType,
  DocumentType, CryptoChain, ExpenseClaimStatus, InvoiceStatus,
  PayoutStatus, FinancialDependencyType)
- React + TypeScript + Vite frontend with MUI, react-router, react-i18next
- Localization: EN, SV, DE translation files
- Vite builds to src/UsingCash.Api/wwwroot for static serving
- Multi-stage Dockerfile: Node build + .NET build -> aspnet runtime
- Gitea Actions CI: build, test, lint, Docker image
- appsettings.json with read/write/admin DB credential structure

Also updates data-migration spec/design for mysqldump-based workflow.

Made-with: Cursor
2026-04-08 16:21:00 +02:00
rick 212f19ac19 Add v6-rewrite OpenSpec: proposal, design, specs, and tasks
Complete specification for rewriting Swarmops v5 as using.cash v6:
- Proposal: scope buckets (Working Rewrite / First Beyond Working / Maybe),
  non-goals (governance, geography, memberships permanently cut)
- Design: 18 architectural decisions including preserved patterns
  (Basic/Logic, stored procs, credential split), new patterns (repository
  classes, chain abstraction, rate providers), and operational concerns
  (Galera awareness, continuation transactions, VAT booking, OOD
  denormalization)
- Specs: 17 capability specifications with SHALL/MUST requirements and
  WHEN/THEN scenarios, covering accounting core, AP/AR, crypto treasury,
  exchange rates, organizations, users/auth, documents, comms, dashboard,
  end-of-month, backend worker, event bus, data migration, API layer,
  frontend app, and CI/packaging
- Tasks: 145 implementation tasks grouped by subsystem, ordered by
  dependency (migration gates API/frontend work)

Two rounds of adversarial review incorporated.

Made-with: Cursor
2026-04-08 16:02:58 +02:00