Back to the catalog

Datasets

Bundle OKF 0.1 · 2 conceitos · growerp/growerp

Open source Repository Open in the app JSON README (API)

About

# Datasets

* [GrowERP Data Model](datasets/growerp.md) - The GrowERP multi-company ERP data model: runtime Moqui entity definitions (mantle + growerp).

# Tables

* [Tables Index](tables/index.md) - All 446 entity concepts of the GrowERP data model.

Details

Kind
OKF bundles
Topic
Government & public data
Publisher
growerp
Origin
okf_github
Category
dados
Version
0.1
Stars
111
Forks
52
Last push
2026-09-08T23:55:52Z
Repository state
ativo
Language
Dart
License
Apache-2.0
Added
2026-09-08 02:17:33
Updated
2026-09-08 02:17:33
Origin id
growerp/growerp:backend/okf/growerp/index.md

README

# GrowERP - Open Source Modular ERP Platform

[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
[![Flutter](https://img.shields.io/badge/Flutter-3.33.0-blue.svg)](https://flutter.dev/)
[![Moqui](https://img.shields.io/badge/Moqui-Framework-green.svg)](https://www.moqui.org/)

GrowERP 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.

## 🚀 Quick Start

### Try GrowERP Now

**Production Applications:** Free trial 2 weeks period without credit card
- **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)

**Applications limited availability under test:** dummy credit card always approved 
- **Admin next version**: [admin.growerp.org](https://admin.growerp.org)
- **Hotel**: [hotel.growerp.org](https://hotel.growerp.org)
- **Freelance**: [freelance.growerp.org](https://freelance.growerp.org)

*Create a new company, select demo data, and explore! Login credentials will be sent to your email.*

### Install Locally: see the manual installation below

## 📚 Documentation

> **🚀 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.

> **📖 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.

### ⭐ Phase 12 - Assessment Landing Page Implementation (LATEST)

- **[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
- **[GrowERP Assessment & Landing Page Architecture](./docs/GROWERP_ASSESSMENT_AND_LANDING_PAGE_ARCHITECTURE.md)** - Package design and dual-ID strategy

### 🏗️ Core Development & Architecture

- **[📖 Extensibility Overview](./docs/README.md)** - Complete guide to GrowERP's modular architecture and development patterns (41+ documents, 9,500+ lines)
- **[🧩 Building Blocks Guide](./docs/Building_Blocks_Development_Guide.md)** - Create Flutter packages (growerp_* packages)
- **[⚙️ Backend Components Guide](./docs/Backend_Components_Development_Guide.md)** - Develop Moqui components and services
- **[🎨 Design Patterns](./docs/GrowERP_Design_Patterns.md)** - Established patterns and conventions for consistent development
- **[📝 Code Templates](./docs/GrowERP_Code_Templates.md)** - Ready-to-use templates for rapid development
- **[🤖 AI Development Guide](./docs/GrowERP_AI_Instructions.md)** - AI-assisted development best practices

### 🔧 Integration & APIs

- **[🔗 Data Models Guide](./docs/basic_explanation_of_the_frontend_REST_Backend_data_models.md)** - Frontend-backend data model integration
- **[📡 Flutter-Moqui REST Backend Interface](./docs/Flutter_Moqui_REST_Backend_Interface.md)** - Complete guide to REST API communication with practical code examples
- **[🔐 Registration, Login & Trial Specification](./docs/Registration_Login_Specification.md)** - Startup company resolution, registration, tenant setup, login state machine and evaluation period
- **[🤖 Invoice Scan & AI Extraction](./docs/Invoice_Scan_Documentation.md)** - Invoice scanning and AI-powered data extraction with Google Gemini
- **[🤖 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
- **[🧠 Agent Control Center (ADK)](./docs/Agent_Control_Center_User_Guide.md)** - Guide to multi-agent orchestration, tool scoping, and RAG knowledge ingest
- **[🎮 Agent Demo Walkthrough](./docs/Agent_Control_Center_Demo.md)** - Test the operations assistant and specialist agent team
- **[✨ AI Landing Page Generation](./docs/AI_GENERATED_LANDING_PAGE_PLAN.md)** - Generate professional landing pages with AI and internet research
- **[💳 Stripe Payment Processing](./docs/Stripe_Payment_Processing_Documentation.md)** - Complete payment integration guide
- **[🌐 WebSocket Notifications](./docs/WebSocket_Notification_System.md)** - Real-time notification system
- **[🕐 Timezone Management](./docs/GrowERP_Timezone_Management_Guide.md)** - Handle timezone differences between client and server

### 🚀 Deployment & Operations

- **[🐳 Docker Installation](./docker/README.md)** - Containerized deployment and development
- **[📦 Snap Distribution](./docs/snap_linux_distribution.md)** - Linux Snap package distribution
- **[⚙️ Backend URL Selection](./docs/Backend_URL_Selection_System_Documentation.md)** - Backend configuration and routing

### 📋 Business & Management

- **[📣 Marketing & Sales Plan](./docs/GrowERP_Marketing_Sales_Plan.md)** - Master go-to-market plan, dogfooded on GrowERP itself
- **[📖 Marketing, Outreach & CRM User Manual](./docs/GrowERP_User_Manual_Marketing_CRM.md)** - End-user guide for the marketing, outreach and CRM modules
- **[📊 Management Summary](./docs/Management_Summary_Open_Source_Extensibility.md)** - Strategic overview for decision makers
- **[📈 Leads Management](./docs/leads_upload_process.md)** - Lead import and export processes
- **[💰 Subscription Functions](./docs/Moqui_Subscription_Function.md)** - Subscription and billing management

### 🤝 Contributing & Community

- **[🔧 Contributing Guide](./CONTRIBUTING.md)** - How to contribute to GrowERP
- **[📜 Code of Conduct](./CODE_OF_CONDUCT.md)** - Community guidelines and expectations
- **[📄 License](./LICENSE)** - Apache License 2.0
- **[🎯 AI Development Guide](./docs/GrowERP_AI_Instructions.md)** - AI-assisted development best practices and prompts

### 📖 Additional Resources

- **[🌐 User Documentation](https://www.growerp.com)** - End-user guides, tutorials, and support
- **[📚 Technical Documentation](./GrowERPObs/)** - Comprehensive technical documentation and examples
- **[📂 Documentation Examples](./docs/examples/)** - Code examples and implementation samples

### 📝 Documentation Status & Maintenance

The GrowERP documentation is actively maintained and regularly updated. Key features:

- **📊 Comprehensive Coverage**: 25+ detailed guides covering all aspects of development and deployment
- **🔗 Cross-Referenced**: All documents include links to related topics and examples
- **🎯 Use Case Focused**: Documentation organized by developer needs and experience levels
- **📱 Multi-Platform**: Covers Web, Android, iOS, Linux, Windows, and macOS development
- **🤖 AI-Ready**: Includes AI integration guides and MCP server documentation

> **💡 Documentation Navigation Tip**: 
> 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.

> **🔄 Contributing to Documentation**: 
> Found something missing or outdated? We welcome documentation contributions! See our [Contributing Guide](./CONTRIBUTING.md) for how to improve the docs.

## 🏛️ Architecture Overview

GrowERP uses a modular architecture that promotes reusability and extensibility:

```
┌─────────────────────────────────────────────────────────────┐
│                    Applications Layer                        │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │
│  │ Admin App   │ │ Hotel App   │ │Freelance App│ │Custom...│ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                  Building Blocks Layer                      │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │growerp_core  │ │growerp_catalog│ │growerp_order │ │ ...  │ │
│ │growerp_models│ │growerp_inventory│ │_accounting  │ │      │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                    Backend Layer                            │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │GrowERP Comp. │ │Custom Comp.  │ │Mantle UDM    │ │Moqui │ │
│ │              │ │              │ │Mantle USL    │ │Frame │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘
```

### 🧩 Building Blocks (Frontend)
- **growerp_core** - Foundation templates and UI components
- **growerp_models** - Data models and API clients
- **growerp_catalog** - Product and category management
- **growerp_inventory** - Warehouse and stock management
- **[growerp_manufacturing](./flutter/packages/growerp_manufacturing/README.md)** - Bill of Materials, Work Orders, and Routings
- **[growerp_manuf_liner](./flutter/packages/growerp_manuf_liner/README.md)** - Custom liner manufacturing and production PDF generation
- **growerp_order_accounting** - Orders, invoices, and accounting
- **growerp_user_company** - User and company management
- **growerp_marketing** - Marketing campaigns and analytics
- **growerp_website** - Website content management
- **growerp_activity** - Task and activity tracking
- **growerp_chat** - Real-time communication
- **growerp_courses** - eLearning course and content management
- **growerp_sales** - Sales pipeline and opportunity management
- **growerp_outreach** - Outreach and lead engagement

### ⚙️ Backend Components
- **moqui-adk** - Agent Development Kit for multi-agent orchestration and governance
- **moqui-mcp** - Model Context Protocol for external AI tool integration
- **Moqui Framework** - Enterprise-grade backend framework
- **REST APIs** - Automatic JSON serialization and authentication
- **Entity Engine** - ORM with automatic CRUD operations
- **Service Engine** - Business logic with transactions
- **Security** - Role-based access control

## 🌟 Key Features

### ✨ For Businesses
- **Multi-platform** - Web, Android, iOS from single codebase
- **Modular Design** - Use only what you need
- **Industry-Specific** - Pre-built applications for different sectors
- **Scalable** - From small business to enterprise
- **Open Source** - No licensing fees, full control

### 🛠️ For Developers
- **Extensible Architecture** - Create custom building blocks and components
- **Modern Tech Stack** - Flutter frontend, Moqui backend
- **Comprehensive Documentation** - Detailed guides for all aspects
- **Active Community** - Collaborative development environment
- **Best Practices** - Established patterns and conventions

### 🏢 For Organizations
- **Cost Effective** - 60% reduction in Total Cost of Ownership
- **Rapid Development** - 50% faster application development
- **Customizable** - Adapt to specific business requirements
- **Future-Proof** - Modular architecture supports evolution
- **Community-Driven** - Benefit from collective innovation

## 🚀 Getting Started

### Prerequisites

- **OpenJDK 21** - `sudo apt install openjdk-21-jdk` or [Download](https://openjdk.org/install/)
- **Flutter stable** - [Install](https://flutter.dev/)
- **Chrome Browser** - [Download](https://www.google.com/chrome/)
- **Git** - [Download](https://git-scm.com/downloads)
- **Android Studio** - [Download](https://developer.android.com/studio) (optional)
- **VS Code** - [Download](https://code.visualstudio.com/) (optional)

### Manual Installation

1. **Clone the repository with all submodules:**
   ```bash
   git clone https://github.com/growerp/growerp
   cd growerp
   git submodule update --init --recursive
   ./setup-backend.sh # (or windows: ./setup-backend.ps1)
   ```

2. **Start the backend** (in separate terminal):
   ```bash
   cd moqui
   # First time only — build and load initial data
   ./gradlew build
   java -jar moqui.war load types=seed,seed-initial,install no-run-es

   # Regular startup
   java -jar moqui.war no-run-es
   ```

3. **Run the Flutter application:**
   ```bash
   cd flutter
   # First time only
   dart pub global activate melos
   export PATH="$PATH":"$HOME/.pub-cache/bin"
   melos clean && melos bootstrap #(windows: ignore error with flutter-startup.sh)
   melos l10n --no-select
   melos build --no-select

   # Run the admin app
   cd packages/admin
   flutter run
   ```

4. **Access the backend admin:**
   - URL: http://localhost:8080/vapps
   - User: SystemSupport
   - Password: moqui

### Docker Installation

For Docker-based installation, see the [Docker README](./docker/README.md).

## 🎯 Use Cases & Applications

### 🏢 Admin Application
Complete ERP solution with:
- Product catalog management
- Inventory tracking
- Order processing
- Accounting and invoicing
- User and company management
- Website content management
- Marketing campaigns
- AI Agent orchestration and control center
- LLM system usage tracking and token limits

### 🏨 Hotel Application
Specialized for hospitality:
- Room management
- Reservation system
- Guest services
- Housekeeping
- Billing and accounting

### 💼 Freelance Application
Project management focused:
- Client management
- Time tracking
- Project organization
- Invoicing
- Activity monitoring



### 🏥 Health Application
Healthcare management:
- Patient management
- Appointment scheduling
- Health records
- Billing and accounting

### 🎧 Support Application
Customer support and ticketing:
- Ticket management
- Customer communication
- Issue tracking and resolution
- Reporting

### 📊 Assessment Application
Lead capture and AI-scored assessment platform:
- AI-powered assessment scoring
- Landing page generation
- Lead capture and management
- Integration with Admin ERP

### 🔧 Custom Applications
Build your own using:
- Existing building blocks
- Custom components
- Industry-specific workflows
- Tailored user interfaces

## 🤝 Contributing

We welcome contributions from developers of all skill levels! Here's how you can help:

### 🎯 Contribution Areas
- **🐛 Bug Fixes** - Report and fix issues
- **✨ New Features** - Building blocks, backend components, integrations
- **📚 Documentation** - Improve guides, add examples, translations
- **🧪 Testing** - Unit tests, integration tests, quality assurance
- **🎨 UI/UX** - Design improvements, accessibility, themes

### 🚀 Getting Started
1. Read our [Contributing Guide](./CONTRIBUTING.md)
2. Check the [Extensibility Documentation](./docs/README.md)
3. Follow our [Code of Conduct](./CODE_OF_CONDUCT.md)
4. Join the community discussions

### 📈 High-Priority Areas
- Industry-specific building blocks (healthcare, education, manufacturing)
- Integration modules (payment, shipping, analytics)
- Localization and internationalization
- Performance and scalability improvements

## 📱 Screenshots

### Admin Application

<div align="center">

#### Mobile Screenshots
| Dashboard | Company | Ledger |
|-----------|---------|--------|
| <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"> |

| Orders | Employees |
|--------|-----------|
| <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"> |

#### Web/Tablet Screenshots
| Dashboard |
|-----------|
| <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"> |

| Company |
|---------|
| <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"> |

| Orders |
|--------|
| <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"> |

| Ledger |
|--------|
| <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"> |

| Employees |
|-----------|
| <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"> |

</div>

### Hotel Application

<div align="center">

#### Mobile Screenshots
| Daily View | Room Categories | Rooms |
|------------|-----------------|-------|
| <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"> |

| Reservations | Hotel Info | Ledger |
|--------------|------------|--------|
| <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"> |

#### Web/Tablet Screenshots
| Daily View |
|------------|
| <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"> |

| Room Categories |
|-----------------|
| <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"> |

| Rooms |
|-------|
| <img src="https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/rooms.png" width="600"> |

| Reservations |
|--------------|
| <img src="https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/reservations.png" width="600"> |

| Hotel Info |
|------------|
| <img src="https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/accounting.png" width="600"> |

| Ledger |
|--------|
| <img src="https://raw.githubusercontent.com/growerp/growerp/master/flutter/packages/hotel/android/fastlane/metadata/android/en-US/images/tenInchScreenshots/ledger.png" width="600"> |

</div>

### Generated Business Website

<div align="center">

| E-commerce Website |
|-------------------|
| <img src="https://raw.githubusercontent.com/growerp/growerp/master/GrowERPObs/media/website.png" width="600"> |

</div>

## 🌐 Community & Support

### 📞 Contact & Support
- **Email**: support@growerp.com
- **Website**: [www.growerp.com](https://www.growerp.com)
- **GitHub Issues**: [Report bugs and request features](https://github.com/growerp/growerp/issues)
- **GitHub Discussions**: [Community discussions](https://github.com/growerp/growerp/discussions)

### 🤝 Community
- **Contributors**: Join our growing community of developers
- **Documentation**: Help improve and translate documentation
- **Testing**: Test new features and report issues
- **Mentorship**: Learn from experienced contributors

### 📈 Project Status
- **Latest Release**: 1.15.0
- **License**: Apache License 2.0
- **Status**: Active development
- **Stability**: Production ready
- **Community**: Growing open source ecosystem

## 🎯 Roadmap

### 🔮 Upcoming Features
- Enhanced mobile responsiveness
- Advanced reporting and analytics
- Additional industry-specific modules
- Improved internationalization
- Performance optimizations

### 🚀 Long-term Vision
- Comprehensive ecosystem of building blocks
- Industry-leading extensibility platform
- Global community of contributors
- Enterprise-grade scalability and performance

---

<div align="center">

**🌟 Star this repository if you find GrowERP useful!**

**🤝 Join our community and help shape the future of open-source ERP!**

[⭐ Star](https://github.com/growerp/growerp/stargazers) • [🍴 Fork](https://github.com/growerp/growerp/fork) • [📝 Contribute](./CONTRIBUTING.md) • [💬 Discuss](https://github.com/growerp/growerp/discussions)

</div>

More