Move BQL documentation to Castle repo

Moved BQL-BALANCE-QUERIES.md from beancounter project to Castle docs/ folder.
Updated all code references from misc-docs/ to docs/ for proper documentation
location alongside implementation.

The document contains comprehensive BQL investigation results showing that
BQL is not feasible for Castle's current ledger format where SATS are stored
in posting metadata rather than position amounts.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
padreug 2025-11-10 23:41:48 +01:00
parent 89710a37a3
commit 397b5e743e
2 changed files with 646 additions and 3 deletions

View file

@ -502,7 +502,7 @@ class FavaClient:
It CANNOT access posting metadata (like 'sats-equivalent'). For Castle's current
ledger format where SATS are stored in metadata, manual aggregation is required.
See: misc-docs/BQL-BALANCE-QUERIES.md for detailed analysis and test results.
See: docs/BQL-BALANCE-QUERIES.md for detailed analysis and test results.
FUTURE CONSIDERATION: If Castle's ledger format changes to use SATS as position
amounts (instead of metadata), BQL could provide significant performance benefits.
@ -571,7 +571,7 @@ class FavaClient:
amounts (e.g., "100000 SATS {100.00 EUR}"), this method would become feasible and
provide significant performance benefits.
See: misc-docs/BQL-BALANCE-QUERIES.md for detailed test results and analysis.
See: docs/BQL-BALANCE-QUERIES.md for detailed test results and analysis.
Args:
user_id: User ID
@ -678,7 +678,7 @@ class FavaClient:
FUTURE CONSIDERATION: If Castle's ledger format changes to store SATS as position
amounts, this method would provide significant performance benefits for admin views.
See: misc-docs/BQL-BALANCE-QUERIES.md for detailed test results and analysis.
See: docs/BQL-BALANCE-QUERIES.md for detailed test results and analysis.
Returns:
[