{"id":31768822,"url":"https://github.com/mehmetmasa/finova","last_synced_at":"2026-04-29T20:34:20.167Z","repository":{"id":318568724,"uuid":"1071850061","full_name":"mehmetmasa/finova","owner":"mehmetmasa","description":"Open-source AI-powered financial management platform built with Laravel. Features: Multi-currency tracking, CRM, project management, AI assistant, and real-time analytics.","archived":false,"fork":false,"pushed_at":"2025-10-08T01:13:40.000Z","size":6352,"stargazers_count":30,"open_issues_count":0,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-25T12:38:52.080Z","etag":null,"topics":["ai","crm","finance","financial-management","fintech","laravel","livewire","open-source","php","tailwindcss"],"latest_commit_sha":null,"homepage":"https://finans.mikpa.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mehmetmasa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-10-07T22:42:57.000Z","updated_at":"2025-12-08T23:47:53.000Z","dependencies_parsed_at":"2025-10-08T00:28:03.773Z","dependency_job_id":"af5df500-e6a0-45eb-9cf3-21f1ab53df70","html_url":"https://github.com/mehmetmasa/finova","commit_stats":null,"previous_names":["mehmetmasa/finova"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mehmetmasa/finova","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetmasa%2Ffinova","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetmasa%2Ffinova/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetmasa%2Ffinova/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetmasa%2Ffinova/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mehmetmasa","download_url":"https://codeload.github.com/mehmetmasa/finova/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetmasa%2Ffinova/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32443563,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T20:22:27.477Z","status":"ssl_error","status_checked_at":"2026-04-29T20:22:26.507Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["ai","crm","finance","financial-management","fintech","laravel","livewire","open-source","php","tailwindcss"],"created_at":"2025-10-10T02:15:11.696Z","updated_at":"2026-04-29T20:34:20.146Z","avatar_url":"https://github.com/mehmetmasa.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 Finova - Modern Financial Management Platform\n\n[![PHP Version](https://img.shields.io/badge/PHP-8.2+-blue.svg)](https://php.net)\n[![Laravel Version](https://img.shields.io/badge/Laravel-11.x-red.svg)](https://laravel.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n[![GitHub Stars](https://img.shields.io/github/stars/mehmetmasa/finova?style=social)](https://github.com/mehmetmasa/finova)\n\n**Finova** is an open-source, AI-powered financial management platform built with Laravel. It combines comprehensive financial tracking, CRM, project management, and intelligent AI assistance in one powerful system.\n\n\u003e 🚀 **Perfect for:** Freelancers, Small Businesses, Agencies, and Financial Professionals\n\n## 🎯 Live Demo\n\nTry it out without installation:\n- **Demo URL:** [https://finans.mikpa.com](https://finans.mikpa.com)\n- **Admin Login:** Use demo credentials on the login page\n- **Employee Login:** Test employee role features\n\n\u003e 💡 **Note:** Demo resets every 30 minutes.\n\n\n## ✨ Features\n\n### 💳 **Financial Management**\n- [x] **Multi-Currency Support** - Track finances in multiple currencies with automatic conversion\n- [x] **Account Management** - Support for bank accounts, credit cards, crypto wallets, virtual POS, and cash\n- [x] **Transaction Tracking** - Comprehensive income, expense, and transfer management\n- [x] **Installment \u0026 Subscription** - Automatic recurring transaction management\n- [x] **Tax \u0026 Withholding** - Built-in tax calculation and withholding management\n\n### 👥 **Customer \u0026 Supplier Management**\n- [x] **Customer Management** - Complete customer database with contact information and history\n- [x] **Supplier Management** - Supplier tracking with debt and payment management\n- [x] **Lead Management** - Lead tracking and conversion system\n- [x] **Customer Agreements** - Contract and agreement management\n- [x] **Customer Credentials** - Secure storage of sensitive customer information\n\n### 🏗️ **Project Management**\n- [x] **Project Tracking** - Create and manage projects with boards and task lists\n- [x] **Task Management** - Kanban-style task management with labels and assignments\n\n### 📊 **Planning \u0026 Analytics**\n- [x] **Savings Plans** - Goal-based savings tracking\n- [x] **Investment Plans** - Investment portfolio management\n- [x] **Debt Management** - Loan and debt tracking with payment schedules\n- [x] **Commission System** - Agent commission tracking and management\n\n### 🤖 **AI Integration**\n- [x] **AI Assistant** - Integrated AI chat assistant for financial insights\n- [x] **Document Analysis** - AI-powered document processing and analysis\n- [x] **Smart Suggestions** - AI recommendations for financial decisions\n- [x] **Multi-Provider Support** - OpenAI and Google Gemini integration\n\n### 🔐 **User Management \u0026 Security**\n- [x] **Role-Based Access Control** - Comprehensive role and permission management system\n- [x] **Custom Roles** - Create and manage custom roles with specific permissions\n- [x] **Permission Management** - Granular permission control for all system features\n- [x] **User Management** - Create, edit, and manage team members with role assignments\n\n### 📱 **Modern UI/UX**\n- [x] **Livewire Components** - Reactive, modern user interface\n- [x] **Responsive Design** - Mobile-first responsive design\n- [x] **Real-time Updates** - Live data updates and notifications\n\n## 🚀 Roadmap \u0026 Upcoming Features\n\n### 🔶 Enhanced Multi-Language Support\n- [ ] **Complete Translation System** - Full translation coverage for all UI elements\n- [ ] **Dynamic Language Switching** - Change language without page refresh\n- [ ] **RTL Support** - Right-to-left language support (Arabic, Hebrew)\n- [ ] **Custom Translation Management** - Admin panel for managing translations\n\n### 🔶 Advanced Currency Management\n- [ ] **Default Currency Selection** - Set preferred currency\n- [ ] **Currency Rate Auto-Update** - Automatic exchange rate updates from APIs\n- [ ] **Custom Exchange Rates** - Manual override for specific rates\n- [ ] **Currency Formatting** - Localized number and currency formatting\n\n### 🔶 Automated Setup Wizard\n- [ ] **One-Click Installation** - Streamlined setup process\n- [ ] **Database Configuration** - Interactive database setup\n- [ ] **Demo Data Installation** - Optional sample data loading\n- [ ] **AI Configuration** - Easy API key setup for AI features\n- [ ] **Email \u0026 Notification Setup** - Configure SMTP and notifications\n\n\u003e 💡 **Want to contribute?** Check out our [Contributing Guide](#-contributing) and pick a feature to work on!\n\n## 🛠️ Technology Stack\n\n### Backend\n- **Laravel 11** - PHP web framework\n- **MySQL/PostgreSQL** - Database\n- **Livewire 3** - Reactive components\n- **Filament 3** - Admin panel\n\n### Frontend\n- **Tailwind CSS** - Utility-first CSS framework\n- **Alpine.js** - Lightweight JavaScript framework\n- **Chart.js** - Data visualization\n- **TipTap Editor** - Rich text editing\n\n### AI \u0026 External Services\n- **OpenAI API** - Chat and document analysis\n- **Google Gemini** - Alternative AI provider\n- **Telegram Bot API** - Notification system\n\n### Development Tools\n- **Vite** - Fast build tool\n- **Pint** - PHP code style fixer\n- **PHPStan** - Static analysis\n- **Pest** - PHP testing framework\n\n## 📋 Requirements\n\n- **PHP** 8.2 or higher\n- **Composer** - PHP dependency manager\n- **Node.js** 18.x or higher\n- **NPM** or **Yarn** - JavaScript dependency manager\n- **MySQL** 5.7+ or **PostgreSQL** 10+\n- **Redis** (optional, for caching and queues)\n\n## 🚀 Installation\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/mehmetmasa/finova.git\ncd finova\n```\n\n### 2. Install PHP Dependencies\n```bash\ncomposer install\n```\n\n### 3. Install JavaScript Dependencies\n```bash\nnpm install\n# or\nyarn install\n```\n\n### 4. Environment Configuration\n```bash\ncp .env.example .env\n```\n\nEdit the `.env` file and configure:\n- Database credentials (DB_DATABASE, DB_USERNAME, DB_PASSWORD)\n- Mail configuration (for notifications)\n- AI API keys (OpenAI, Gemini)\n- Application settings\n\n### 5. Generate Application Key\n```bash\nphp artisan key:generate\n```\n\n### 6. Database Setup\n```bash\nphp artisan migrate --seed\n```\n\nThis will create all database tables and populate with sample data.\n\n### 7. Storage Setup\n```bash\nphp artisan storage:link\n```\n\n### 8. Build Frontend Assets\n```bash\nnpm run build\n# For development\nnpm run dev\n```\n\n### 9. Start the Application\n```bash\nphp artisan serve\n```\n\nThe application will be available at `http://localhost:8000`\n\n## 🔑 Default Credentials\n\n**Admin User:**\n- Email: `admin@admin.com`\n- Password: `admin123`\n\n## 📖 Usage\n\n### Dashboard\n- Overview of financial status\n- Recent transactions and activities\n- Quick action buttons for common tasks\n\n### Financial Management\n- **Transactions**: Add, edit, and categorize financial transactions\n- **Accounts**: Manage different account types and balances\n- **Categories**: Organize transactions with custom categories\n- **Budgets**: Set and track spending limits\n\n### Customer Management\n- **Customers**: Manage customer information and history\n- **Leads**: Track potential customers and conversion\n- **Agreements**: Manage contracts and recurring agreements\n\n### Project Management\n- **Projects**: Create and manage projects\n- **Boards**: Kanban-style project boards\n- **Tasks**: Task management with assignments and due dates\n\n### AI Assistant\n- Access AI chat assistant for financial insights\n- Upload and analyze documents\n- Get AI-powered recommendations\n\n## 🔧 Configuration\n\n### AI Integration Setup\n1. Get API keys from [OpenAI](https://platform.openai.com) or [Google AI](https://ai.google.dev)\n2. Add keys to `.env` file:\n```env\nOPENAI_API_KEY=your_openai_key\nGEMINI_API_KEY=your_gemini_key\n```\n\n### Telegram Notifications (Optional)\n1. Create a Telegram bot via [@BotFather](https://t.me/botfather)\n2. Add bot token to `.env`:\n```env\nTELEGRAM_BOT_TOKEN=your_bot_token\nTELEGRAM_CHAT_ID=your_chat_id\n```\n\n## 🤝 Contributing\n\n**We love contributions!** Whether it's bug fixes, new features, or documentation improvements, all contributions are welcome!\n\n### How to Contribute\n\n1. **Fork** the repository\n2. **Clone** your fork: `git clone https://github.com/YOUR_USERNAME/finova.git`\n3. **Create** a feature branch: `git checkout -b feature/amazing-feature`\n4. **Make** your changes\n5. **Commit** your changes: `git commit -m 'Add amazing feature'`\n6. **Push** to the branch: `git push origin feature/amazing-feature`\n7. **Open** a Pull Request\n\n### Development Guidelines\n- ✅ Follow **PSR-12** coding standards\n- ✅ Use **meaningful commit messages**\n- ✅ Keep PRs **focused and small**\n- ✅ Add **comments** for complex logic\n\n### Good First Issues\n\nLook for issues labeled with:\n- 🟢 `good first issue` - Perfect for first-time contributors\n- 🟡 `help wanted` - We need your help!\n- 🔵 `documentation` - Help improve our docs\n\n### Questions?\n\n- 💬 Open a [Discussion](https://github.com/mehmetmasa/finova/discussions)\n- 🐛 Found a bug? [Open an Issue](https://github.com/mehmetmasa/finova/issues)\n- 💡 Have an idea? [Create a Feature Request](https://github.com/mehmetmasa/finova/issues/new)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Laravel](https://laravel.com) - The PHP framework\n- [Livewire](https://laravel-livewire.com) - Reactive components\n- [Filament](https://filamentphp.com) - Admin panel\n- [Tailwind CSS](https://tailwindcss.com) - Utility-first CSS framework\n- [Alpine.js](https://alpinejs.dev) - Lightweight JavaScript framework\n- [OpenAI](https://openai.com) - AI integration\n- [Google Gemini](https://ai.google.dev) - AI integration\n\n\n## 💬 Community \u0026 Support\n\n### Get Help\n\n- 📖 **Documentation:** Check out our [Wiki](https://github.com/mehmetmasa/finova/wiki)\n- 💬 **Discussions:** Join [GitHub Discussions](https://github.com/mehmetmasa/finova/discussions)\n- 🐛 **Bug Reports:** [Open an Issue](https://github.com/mehmetmasa/finova/issues)\n- ⭐ **Feature Requests:** Share your ideas in [Issues](https://github.com/mehmetmasa/finova/issues/new)\n\n### Show Your Support\n\nIf you find Finova helpful, please:\n- ⭐ **Star** this repository\n- 🐦 **Share** it on social media\n- 🔗 **Link** to it from your projects\n- 💬 **Tell** others about it\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the open-source community**\n\n*Developed and maintained by [Mikpa](https://mikpa.com)*\n\n[⬆ Back to Top](#-finova---modern-financial-management-platform)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehmetmasa%2Ffinova","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmehmetmasa%2Ffinova","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehmetmasa%2Ffinova/lists"}