{
  "markdown": "# GrowERP - Open Source Modular ERP Platform\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n[![Flutter](https://img.shields.io/badge/Flutter-3.33.0-blue.svg)](https://flutter.dev/)\n[![Moqui](https://img.shields.io/badge/Moqui-Framework-green.svg)](https://www.moqui.org/)\n\nGrowERP is an open-source, multi-platform ERP application built with a modular architecture that allows for unprecedented extensibility and customization. Whether you're a small business or an enterprise, GrowERP adapts to your needs through its flexible building block system.\n\n## 🚀 Quick Start\n\n### Try GrowERP Now\n\n**Production Applications:** Free trial 2 weeks period without credit card\n- **Admin App with complete functionality**: [Web](https://admin.growerp.com) | [Linux](https://snapcraft.io/growerp-admin) | [Windows](https://apps.microsoft.com/detail/9nwx6kftjnql?hl=en-US&gl=TH) | [MacOs](https://apps.apple.com/us/app/growerp-admin-open-source/id1545521755)  | [Android](https://play.google.com/store/apps/details?id=org.growerp.admin) | [iOS](https://apps.apple.com/us/app/growerp-admin-open-source/id1545521755)\n\n**Applications limited availability under test:** dummy credit card always approved \n- **Admin next version**: [admin.growerp.org](https://admin.growerp.org)\n- **Hotel**: [hotel.growerp.org](https://hotel.growerp.org)\n- **Freelance**: [freelance.growerp.org](https://freelance.growerp.org)\n\n*Create a new company, select demo data, and explore! Login credentials will be sent to your email.*\n\n### Install Locally: see the manual installation below\n\n## 📚 Documentation\n\n> **🚀 Quick Start**: New to GrowERP? Start with the [Extensibility Overview](./docs/README.md) for a complete roadmap, then check the [Building Blocks Guide](./docs/Building_Blocks_Development_Guide.md) for frontend development or the [Backend Components Guide](./docs/Backend_Components_Development_Guide.md) for backend development.\n\n> **📖 Full Documentation Index**: See **[docs/README.md](./docs/README.md)** for the complete documentation index — 41+ guides organised by role, with reading paths for Project Managers, Architects, Frontend/Backend Developers, DevOps, QA, and more.\n\n### ⭐ Phase 12 - Assessment Landing Page Implementation (LATEST)\n\n- **[Assessment Landing Page Explanation](./docs/Assessment_Landing_Page_Explanation.md)** ⭐ **PHASE 12** - Complete technical guide for FTL landing page + Flutter app integration, MIME type configuration, and Phase 12 updates\n- **[GrowERP Assessment & Landing Page Architecture](./docs/GROWERP_ASSESSMENT_AND_LANDING_PAGE_ARCHITECTURE.md)** - Package design and dual-ID strategy\n\n### 🏗️ Core Development & Architecture\n\n- **[📖 Extensibility Overview](./docs/README.md)** - Complete guide to GrowERP's modular architecture and development patterns (41+ documents, 9,500+ lines)\n- **[🧩 Building Blocks Guide](./docs/Building_Blocks_Development_Guide.md)** - Create Flutter packages (growerp_* packages)\n- **[⚙️ Backend Components Guide](./docs/Backend_Components_Development_Guide.md)** - Develop Moqui components and services\n- **[🎨 Design Patterns](./docs/GrowERP_Design_Patterns.md)** - Established patterns and conventions for consistent development\n- **[📝 Code Templates](./docs/GrowERP_Code_Templates.md)** - Ready-to-use templates for rapid development\n- **[🤖 AI Development Guide](./docs/GrowERP_AI_Instructions.md)** - AI-assisted development best practices\n\n### 🔧 Integration & APIs\n\n- **[🔗 Data Models Guide](./docs/basic_explanation_of_the_frontend_REST_Backend_data_models.md)** - Frontend-backend data model integration\n- **[📡 Flutter-Moqui REST Backend Interface](./docs/Flutter_Moqui_REST_Backend_Interface.md)** - Complete guide to REST API communication with practical code examples\n- **[🔐 Registration, Login & Trial Specification](./docs/Registration_Login_Specification.md)** - Startup company resolution, registration, tenant setup, login state machine and evaluation period\n- **[🤖 Invoice Scan & AI Extraction](./docs/Invoice_Scan_Documentation.md)** - Invoice scanning and AI-powered data extraction with Google Gemini\n- **[🤖 LLM & API Key Architecture](./docs/GrowERP_LLM_And_API_Key_Architecture.md)** - How GrowERP uses LLMs, resolves API keys, and enforces token limits, plus a catalog of Gemini/Vertex AI (Veo 2) and GenUI features\n- **[🧠 Agent Control Center (ADK)](./docs/Agent_Control_Center_User_Guide.md)** - Guide to multi-agent orchestration, tool scoping, and RAG knowledge ingest\n- **[🎮 Agent Demo Walkthrough](./docs/Agent_Control_Center_Demo.md)** - Test the operations assistant and specialist agent team\n- **[✨ AI Landing Page Generation](./docs/AI_GENERATED_LANDING_PAGE_PLAN.md)** - Generate professional landing pages with AI and internet research\n- **[💳 Stripe Payment Processing](./docs/Stripe_Payment_Processing_Documentation.md)** - Complete payment integration guide\n- **[🌐 WebSocket Notifications](./docs/WebSocket_Notification_System.md)** - Real-time notification system\n- **[🕐 Timezone Management](./docs/GrowERP_Timezone_Management_Guide.md)** - Handle timezone differences between client and server\n\n### 🚀 Deployment & Operations\n\n- **[🐳 Docker Installation](./docker/README.md)** - Containerized deployment and development\n- **[📦 Snap Distribution](./docs/snap_linux_distribution.md)** - Linux Snap package distribution\n- **[⚙️ Backend URL Selection](./docs/Backend_URL_Selection_System_Documentation.md)** - Backend configuration and routing\n\n### 📋 Business & Management\n\n- **[📣 Marketing & Sales Plan](./docs/GrowERP_Marketing_Sales_Plan.md)** - Master go-to-market plan, dogfooded on GrowERP itself\n- **[📖 Marketing, Outreach & CRM User Manual](./docs/GrowERP_User_Manual_Marketing_CRM.md)** - End-user guide for the marketing, outreach and CRM modules\n- **[📊 Management Summary](./docs/Management_Summary_Open_Source_Extensibility.md)** - Strategic overview for decision makers\n- **[📈 Leads Management](./docs/leads_upload_process.md)** - Lead import and export processes\n- **[💰 Subscription Functions](./docs/Moqui_Subscription_Function.md)** - Subscription and billing management\n\n### 🤝 Contributing & Community\n\n- **[🔧 Contributing Guide](./CONTRIBUTING.md)** - How to contribute to GrowERP\n- **[📜 Code of Conduct](./CODE_OF_CONDUCT.md)** - Community guidelines and expectations\n- **[📄 License](./LICENSE)** - Apache License 2.0\n- **[🎯 AI Development Guide](./docs/GrowERP_AI_Instructions.md)** - AI-assisted development best practices and prompts\n\n### 📖 Additional Resources\n\n- **[🌐 User Documentation](https://www.growerp.com)** - End-user guides, tutorials, and support\n- **[📚 Technical Documentation](./GrowERPObs/)** - Comprehensive technical documentation and examples\n- **[📂 Documentation Examples](./docs/examples/)** - Code examples and implementation samples\n\n### 📝 Documentation Status & Maintenance\n\nThe GrowERP documentation is actively maintained and regularly updated. Key features:\n\n- **📊 Comprehensive Coverage**: 25+ detailed guides covering all aspects of development and deployment\n- **🔗 Cross-Referenced**: All documents include links to related topics and examples\n- **🎯 Use Case Focused**: Documentation organized by developer needs and experience levels\n- **📱 Multi-Platform**: Covers Web, Android, iOS, Linux, Windows, and macOS development\n- **🤖 AI-Ready**: Includes AI integration guides and MCP server documentation\n\n> **💡 Documentation Navigation Tip**: \n> Start with the [Extensibility Overview](./docs/README.md) for a complete roadmap of all available documentation. Each guide includes cross-references and practical examples to help you find exactly what you need for your specific use case.\n\n> **🔄 Contributing to Documentation**: \n> Found something missing or outdated? We welcome documentation contributions! See our [Contributing Guide](./CONTRIBUTING.md) for how to improve the docs.\n\n## 🏛️ Architecture Overview\n\nGrowERP uses a modular architecture that promotes reusability and extensibility:\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    Applications Layer                        │\n│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │\n│  │ Admin App   │ │ Hotel App   │ │Freelance App│ │Custom...│ │\n│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────┘ │\n└─────────────────────────────────────────────────────────────┘\n┌─────────────────────────────────────────────────────────────┐\n│                  Building Blocks Layer                      │\n│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │\n│ │growerp_core  │ │growerp_catalog│ │growerp_order │ │ ...  │ │\n│ │growerp_models│ │growerp_inventory│ │_accounting  │ │      │ │\n│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │\n└─────────────────────────────────────────────────────────────┘\n┌─────────────────────────────────────────────────────────────┐\n│                    Backend Layer                            │\n│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │\n│ │GrowERP Comp. │ │Custom Comp.  │ │Mantle UDM    │ │Moqui │ │\n│ │              │ │              │ │Mantle USL    │ │Frame │ │\n│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 🧩 Building Blocks (Frontend)\n- **growerp_core** - Foundation templates and UI components\n- **growerp_models** - Data models and API clients\n- **growerp_catalog** - Product and category management\n- **growerp_inventory** - Warehouse and stock management\n- **[growerp_manufacturing](./flutter/packages/growerp_manufacturing/README.md)** - Bill of Materials, Work Orders, and Routings\n- **[growerp_manuf_liner](./flutter/packages/growerp_manuf_liner/README.md)** - Custom liner manufacturing and production PDF generation\n- **growerp_order_accounting** - Orders, invoices, and accounting\n- **growerp_user_company** - User and company management\n- **growerp_marketing** - Marketing campaigns and analytics\n- **growerp_website** - Website content management\n- **growerp_activity** - Task and activity tracking\n- **growerp_chat** - Real-time communication\n- **growerp_courses** - eLearning course and content management\n- **growerp_sales** - Sales pipeline and opportunity management\n- **growerp_outreach** - Outreach and lead engagement\n\n### ⚙️ Backend Components\n- **moqui-adk** - Agent Development Kit for multi-agent orchestration and governance\n- **moqui-mcp** - Model Context Protocol for external AI tool integration\n- **Moqui Framework** - Enterprise-grade backend framework\n- **REST APIs** - Automatic JSON serialization and authentication\n- **Entity Engine** - ORM with automatic CRUD operations\n- **Service Engine** - Business logic with transactions\n- **Security** - Role-based access control\n\n## 🌟 Key Features\n\n### ✨ For Businesses\n- **Multi-platform** - Web, Android, iOS from single codebase\n- **Modular Design** - Use only what you need\n- **Industry-Specific** - Pre-built applications for different sectors\n- **Scalable** - From small business to enterprise\n- **Open Source** - No licensing fees, full control\n\n### 🛠️ For Developers\n- **Extensible Architecture** - Create custom building blocks and components\n- **Modern Tech Stack** - Flutter frontend, Moqui backend\n- **Comprehensive Documentation** - Detailed guides for all aspects\n- **Active Community** - Collaborative development environment\n- **Best Practices** - Established patterns and conventions\n\n### 🏢 For Organizations\n- **Cost Effective** - 60% reduction in Total Cost of Ownership\n- **Rapid Development** - 50% faster application development\n- **Customizable** - Adapt to specific business requirements\n- **Future-Proof** - Modular architecture supports evolution\n- **Community-Driven** - Benefit from collective innovation\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- **OpenJDK 21** - `sudo apt install openjdk-21-jdk` or [Download](https://openjdk.org/install/)\n- **Flutter stable** - [Install](https://flutter.dev/)\n- **Chrome Browser** - [Download](https://www.google.com/chrome/)\n- **Git** - [Download](https://git-scm.com/downloads)\n- **Android Studio** - [Download](https://developer.android.com/studio) (optional)\n- **VS Code** - [Download](https://code.visualstudio.com/) (optional)\n\n### Manual Installation\n\n1. **Clone the repository with all submodules:**\n   ```bash\n   git clone https://github.com/growerp/growerp\n   cd growerp\n   git submodule update --init --recursive\n   ./setup-backend.sh # (or windows: ./setup-backend.ps1)\n   ```\n\n2. **Start the backend** (in separate terminal):\n   ```bash\n   cd moqui\n   # First time only — build and load initial data\n   ./gradlew build\n   java -jar moqui.war load types=seed,seed-initial,install no-run-es\n\n   # Regular startup\n   java -jar moqui.war no-run-es\n   ```\n\n3. **Run the Flutter application:**\n   ```bash\n   cd flutter\n   # First time only\n   dart pub global activate melos\n   export PATH=\"$PATH\":\"$HOME/.pub-cache/bin\"\n   melos clean && melos bootstrap #(windows: ignore error with flutter-startup.sh)\n   melos l10n --no-select\n   melos build --no-select\n\n   # Run the admin app\n   cd packages/admin\n   flutter run\n   ```\n\n4. **Access the backend admin:**\n   - URL: http://localhost:8080/vapps\n   - User: SystemSupport\n   - Password: moqui\n\n### Docker Installation\n\nFor Docker-based installation, see the [Docker README](./docker/README.md).\n\n## 🎯 Use Cases & Applications\n\n### 🏢 Admin Application\nComplete ERP solution with:\n- Product catalog management\n- Inventory tracking\n- Order processing\n- Accounting and invoicing\n- User and company management\n- Website content management\n- Marketing campaigns\n- AI Agent orchestration and control center\n- LLM system usage tracking and token limits\n\n### 🏨 Hotel Application\nSpecialized for hospitality:\n- Room management\n- Reservation system\n- Guest services\n- Housekeeping\n- Billing and accounting\n\n### 💼 Freelance Application\nProject management focused:\n- Client management\n- Time tracking\n- Project organization\n- Invoicing\n- Activity monitoring\n\n\n\n### 🏥 Health Application\nHealthcare management:\n- Patient management\n- Appointment scheduling\n- Health records\n- Billing and accounting\n\n### 🎧 Support Application\nCustomer support and ticketing:\n- Ticket management\n- Customer communication\n- Issue tracking and resolution\n- Reporting\n\n### 📊 Assessment Application\nLead capture and AI-scored assessment platform:\n- AI-powered assessment scoring\n- Landing page generation\n- Lead capture and management\n- Integration with Admin ERP\n\n### 🔧 Custom Applications\nBuild your own using:\n- Existing building blocks\n- Custom components\n- Industry-specific workflows\n- Tailored user interfaces\n\n## 🤝 Contributing\n\nWe welcome contributions from developers of all skill levels! Here's how you can help:\n\n### 🎯 Contribution Areas\n- **🐛 Bug Fixes** - Report and fix issues\n- **✨ New Features** - Building blocks, backend components, integrations\n- **📚 Documentation** - Improve guides, add examples, translations\n- **🧪 Testing** - Unit tests, integration tests, quality assurance\n- **🎨 UI/UX** - Design improvements, accessibility, themes\n\n### 🚀 Getting Started\n1. Read our [Contributing Guide](./CONTRIBUTING.md)\n2. Check the [Extensibility Documentation](./docs/README.md)\n3. Follow our [Code of Conduct](./CODE_OF_CONDUCT.md)\n4. Join the community discussions\n\n### 📈 High-Priority Areas\n- Industry-specific building blocks (healthcare, education, manufacturing)\n- Integration modules (payment, shipping, analytics)\n- Localization and internationalization\n- Performance and scalability improvements\n\n## 📱 Screenshots\n\n### Admin Application\n\n<div align=\"center\">\n\n#### Mobile Screenshots\n| Dashboard | Company | Ledger |\n|-----------|---------|--------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_main_menu.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_company.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_ledger.png\" width=\"200\"> |\n\n| Orders | Employees |\n|--------|-----------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_accounting.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_catalog_products.png\" width=\"200\"> |\n\n#### Web/Tablet Screenshots\n| Dashboard |\n|-----------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/Screenshot_main_menu.png\" width=\"600\"> |\n\n| Company |\n|---------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/Screenshot_company.png\" width=\"600\"> |\n\n| Orders |\n|--------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/Screenshot_orders.png\" width=\"600\"> |\n\n| Ledger |\n|--------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/Screenshot_ledger.png\" width=\"600\"> |\n\n| Employees |\n|-----------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/admin/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/Screenshot_accounting.png\" width=\"600\"> |\n\n</div>\n\n### Hotel Application\n\n<div align=\"center\">\n\n#### Mobile Screenshots\n| Daily View | Room Categories | Rooms |\n|------------|-----------------|-------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/main-day.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/main-week-menu.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/rooms.png\" width=\"200\"> |\n\n| Reservations | Hotel Info | Ledger |\n|--------------|------------|--------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/reservations.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/accounting.png\" width=\"200\"> | <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/phoneScreenshots/ledger.png\" width=\"200\"> |\n\n#### Web/Tablet Screenshots\n| Daily View |\n|------------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/main-day.png\" width=\"600\"> |\n\n| Room Categories |\n|-----------------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/main-week.png\" width=\"600\"> |\n\n| Rooms |\n|-------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/rooms.png\" width=\"600\"> |\n\n| Reservations |\n|--------------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/reservations.png\" width=\"600\"> |\n\n| Hotel Info |\n|------------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/accounting.png\" width=\"600\"> |\n\n| Ledger |\n|--------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/ledger.png\" width=\"600\"> |\n\n</div>\n\n### Generated Business Website\n\n<div align=\"center\">\n\n| E-commerce Website |\n|-------------------|\n| <img src=\"https://raw.githubusercontent.com/growerp/growerp/master/GrowERPObs/media/website.png\" width=\"600\"> |\n\n</div>\n\n## 🌐 Community & Support\n\n### 📞 Contact & Support\n- **Email**: support@growerp.com\n- **Website**: [www.growerp.com](https://www.growerp.com)\n- **GitHub Issues**: [Report bugs and request features](https://github.com/growerp/growerp/issues)\n- **GitHub Discussions**: [Community discussions](https://github.com/growerp/growerp/discussions)\n\n### 🤝 Community\n- **Contributors**: Join our growing community of developers\n- **Documentation**: Help improve and translate documentation\n- **Testing**: Test new features and report issues\n- **Mentorship**: Learn from experienced contributors\n\n### 📈 Project Status\n- **Latest Release**: 1.15.0\n- **License**: Apache License 2.0\n- **Status**: Active development\n- **Stability**: Production ready\n- **Community**: Growing open source ecosystem\n\n## 🎯 Roadmap\n\n### 🔮 Upcoming Features\n- Enhanced mobile responsiveness\n- Advanced reporting and analytics\n- Additional industry-specific modules\n- Improved internationalization\n- Performance optimizations\n\n### 🚀 Long-term Vision\n- Comprehensive ecosystem of building blocks\n- Industry-leading extensibility platform\n- Global community of contributors\n- Enterprise-grade scalability and performance\n\n---\n\n<div align=\"center\">\n\n**🌟 Star this repository if you find GrowERP useful!**\n\n**🤝 Join our community and help shape the future of open-source ERP!**\n\n[⭐ Star](https://github.com/growerp/growerp/stargazers) • [🍴 Fork](https://github.com/growerp/growerp/fork) • [📝 Contribute](./CONTRIBUTING.md) • [💬 Discuss](https://github.com/growerp/growerp/discussions)\n\n</div>\n",
  "bytes": 22455,
  "sha": "ed8c1785bf576b55553cfefeaa2c866a52b440448663daa8c1d4236319a5450a",
  "repo_slug": "growerp/growerp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_growerp_growerp_backend_okf_growerp_inde_eeced36e/readme"
}