{"id":29286035,"url":"https://github.com/spy4x/financy","last_synced_at":"2026-04-07T08:31:59.907Z","repository":{"id":288291829,"uuid":"965065702","full_name":"spy4x/financy","owner":"spy4x","description":"Financy - Open-source, self-hostable finance tracking for individuals, families, and small businesses.","archived":false,"fork":false,"pushed_at":"2026-01-26T10:48:39.000Z","size":1727,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-27T00:36:31.433Z","etag":null,"topics":["deno","docker","finances-manager","honojs","postgres","preact"],"latest_commit_sha":null,"homepage":"https://financy.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spy4x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-12T10:36:04.000Z","updated_at":"2025-10-22T06:08:15.000Z","dependencies_parsed_at":"2025-04-16T23:23:57.714Z","dependency_job_id":"6b45b796-0c95-44c5-9271-8efeb4274c3d","html_url":"https://github.com/spy4x/financy","commit_stats":null,"previous_names":["spy4x/financy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/spy4x/financy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spy4x%2Ffinancy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spy4x%2Ffinancy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spy4x%2Ffinancy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spy4x%2Ffinancy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spy4x","download_url":"https://codeload.github.com/spy4x/financy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spy4x%2Ffinancy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31506562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deno","docker","finances-manager","honojs","postgres","preact"],"created_at":"2025-07-06T00:00:39.381Z","updated_at":"2026-04-07T08:31:59.902Z","avatar_url":"https://github.com/spy4x.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Financy\n\nOpen-source, self-hostable finance tracking for individuals, families, and small\nbusinesses.\n\nCheck it out at [financy.dev](https://financy.dev).\n\nFinancy is a double-entry financial\nmanagement web application focused on personal, family, and business expense\nmanagement. It emphasizes rich capabilities, transparency, and ease of use while\noffering advanced features like group collaboration, public API integrations,\nand Telegram bot integration.\n\n## 🗺️ Development Roadmap\n\n- ✅ **Completed** - 🟡 **In Progress** - ⚪ **Planned**\n\n### 🏗️ Core Infrastructure\n\n- ✅ **Database Schema** - Complete PostgreSQL schema with all tables\n- ✅ **CQRS Architecture** - Command/Event pattern with buses\n- ✅ **Real-time Communication** - WebSocket implementation\n- ✅ **Caching \u0026 Performance** - Valkey/Redis caching layer\n- ✅ **Containerization** - Docker setup for all services\n- ✅ **PWA Foundation** - Progressive Web App capabilities\n- 🟡 **Authentication System** - Basic auth complete, 2FA UI pending\n\n### 👥 User Management\n\n- 🟡 **User Registration/Login** - Basic flow complete, profile management needed\n- ✅ **Session Management** - Secure session handling\n- 🟡 **Role-Based Access Control** - Multi-tier permissions partially implemented\n- 🟡 **Two-Factor Authentication** - Backend ready, UI needs completion\n- 🟡 **Password Management** - Basic change functionality, reset needs work\n- ⚪ **User Profile Management** - Profile editing, preferences\n- ⚪ **Account Recovery** - Email-based recovery system\n\n### 🏢 Group Collaboration\n\n- 🟡 **Group Management** - Create, edit, list groups\n- ✅ **Group Settings** - Default currencies, preferences\n- ✅ **Real-time Updates** - Live sync across group members\n- 🟡 **Group Membership** - Role-based access partially implemented\n- ⚪ **Member Invitations** - Invite users via email/link\n- ⚪ **Member Management** - Add/remove group members\n\n### 🏦 Account Management\n\n- ✅ **Account CRUD** - Complete create, read, update, delete\n- ✅ **Account Management UI** - Edit details, currencies, balances\n- ✅ **Account List \u0026 Balances** - View all accounts with current balances\n- ✅ **Account Archiving** - Soft delete with undelete functionality\n- 🟡 **Multi-Currency Display** - Show amounts in different currencies\n- ⚪ **Cross-Group Sharing** - Share accounts between multiple groups\n\n### 📊 Transaction Management\n\n- ✅ **Transaction CRUD** - Complete transaction management via WebSockets\n- ✅ **Multi-Currency Support** - Original + converted amounts\n- ✅ **Transaction Forms** - Add income/expense/transfer forms\n- ✅ **Transaction History** - View and filter transaction list\n- ✅ **Transaction Editing** - Modify existing transactions\n- ✅ **Transaction Archiving** - Soft delete with undelete\n- ⚪ **Bulk Operations** - Import/export transactions\n- ⚪ **Transaction Templates** - Save frequently used transactions\n- ⚪ **Recurring Transactions** - Automated scheduled entries\n\n### 🏷️ Categories \u0026 Tags\n\n- ✅ **Category Management** - Complete CRUD with real-time sync\n- ✅ **Category Analytics** - Spending insights by category\n- ✅ **Monthly Spending Limits** - Budget tracking per category\n- 🟡 **Tag Management** - Schema ready, UI implementation pending\n- ⚪ **Tag-based Filtering** - Search transactions by tags\n\n### 📈 Dashboard \u0026 Analytics\n\n- ✅ **Financial Overview Cards** - Balance, income, expenses, net worth\n- ✅ **Recent Transactions** - Latest transactions with quick actions\n- ✅ **Budget Progress Bars** - Category spending vs limits\n- ✅ **Quick Actions Panel** - Fast access to common operations\n- ✅ **Account Balance Overview** - All accounts with trends\n- ✅ **Monthly Spending Trends** - 6-month spending patterns\n- ✅ **Cash Flow Summary** - Income vs expenses with trends\n- ⚪ **Advanced Reports** - Monthly/yearly analysis with charts\n- ⚪ **Goal Setting \u0026 Tracking** - Financial goals with progress monitoring\n\n### 💱 Multi-Currency\n\n- ✅ **Currency Schema** - Database support for multiple currencies\n- ✅ **Exchange Rates** - Rate storage structure\n- 🟡 **Currency Conversion** - Basic conversion display\n- ⚪ **Real-time Exchange Rates** - Automatic rate fetching\n- ⚪ **Historical Rate Tracking** - Exchange rate history\n\n### 🤖 Integrations \u0026 API\n\n- ✅ **WebSocket API** - Real-time data synchronization\n- 🟡 **Push Notifications** - Backend structure ready, UI pending\n- ⚪ **REST API** - Public API for integrations\n- ⚪ **API Documentation** - Comprehensive API documentation\n- ⚪ **Telegram Bot** - Natural language transaction entry\n- ⚪ **AI Transaction Entry** - LLM-powered natural language parsing\n\n### �️ Security \u0026 Infrastructure\n\n- ✅ **Authentication \u0026 Sessions** - Secure user authentication\n- ✅ **Input Validation** - Comprehensive data validation\n- ✅ **HTTPS Configuration** - SSL/TLS setup\n- 🟡 **Production Deployment** - Staging and production configs\n- 🟡 **Monitoring \u0026 Logging** - Grafana, Loki, Prometheus setup\n- 🟡 **Automated Testing** - Unit and integration tests\n- ⚪ **Security Headers** - Comprehensive security headers\n- ⚪ **Rate Limiting** - API abuse prevention\n- ⚪ **GDPR Compliance** - Data privacy compliance\n\n### � User Experience\n\n- ✅ **Mobile-First Design** - Responsive UI optimized for mobile\n- ✅ **PWA Features** - App-like experience with offline capabilities\n- ✅ **Real-time Updates** - Live data synchronization\n- 🟡 **Dark Mode** - Theme customization with system preference\n- 🟡 **Accessibility** - WCAG compliance improvements needed\n- 🟡 **Search \u0026 Filters** - Basic filtering, advanced search pending\n- ⚪ **Internationalization** - Multi-language support\n- ⚪ **Keyboard Shortcuts** - Power user productivity features\n\n### 🚀 Advanced Features\n\n- ⚪ **Split Expenses** - Shared expense management\n- ⚪ **Debt Tracking** - Track loans and debts\n- ⚪ **Investment Tracking** - Stocks and crypto portfolio\n- ⚪ **Receipt Scanning** - OCR for receipt processing\n- ⚪ **Mobile Apps** - Native iOS/Android with Capacitor\n- 🟡 **Enhanced Offline Mode** - Extended offline capabilities\n\n---\n\n**Next priorities:** API documentation, AI transaction entry, Telegram bot integration.\n\n## Contributing\n\nContributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n## Documentation\n\n- [**Project Overview**](docs/1.principles.md) - Core principles and vision\n- [**Features**](docs/2.features.md) - Detailed functionality and capabilities\n- [**Architecture**](docs/3.architecture.md) - System components and interactions\n- [**Technology Stack**](docs/4.tech-stack.md) - Tools and frameworks used\n- [**Deployment**](docs/5.deployment.md) - Installation and setup instructions\n- [**Infrastructure**](docs/6.infrastructure.md) - Deployment and hosting information\n- [**Recommendations \u0026 Gaps**](docs/7.recommendations-expanded.md) - Future improvements and missing pieces\n\n## Quick Start\n\nPrerequisites (unix-like OS):\n\n- [Deno](https://deno.land/): `curl -fsSL https://deno.land/install.sh | sh`\n- [Docker](https://www.docker.com/): `curl -fsSL https://get.docker.com | sudo sh`\n\nTo start local development:\n\n1. Clone the repository\n2. **Install git hooks** (important for code quality):\n   ```sh\n   deno task hooks:install\n   ```\n3. Start all services:\n   ```sh\n   deno task compose up -d\n   ```\n\n## Seed Data\n\nFor development and testing purposes, you can populate the database with comprehensive test data:\n\n```sh\ndeno task db:seed\n```\n\nThis command wipes all existing data (except migrations) and recreates seed data including:\n\n- Test user account (`test@test.com` / `pass1234`)\n- Sample groups, accounts, categories, and transactions\n- Historical exchange rates and multi-currency data\n- Complete authentication setup for testing\n\n## Development Commands\n\nFor development and code quality, use these commands:\n\n- **`deno task check`** - Run comprehensive checks (TypeScript, linting, formatting, tests)\n- **`deno task fix`** - Automatically fix linting and formatting issues\n- **`deno task test`** - Run test suite only\n- **`deno task ts:check`** - TypeScript check only\n\nThis will launch all necessary services \u0026 apps in Docker Compose.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspy4x%2Ffinancy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspy4x%2Ffinancy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspy4x%2Ffinancy/lists"}