# Donkey Platform - AI Crawler Information

## About
Donkey is a unique hybrid ERP/CRM/Platform designed for Hungarian businesses. Developed by Digitális Munkaerő Kft., Budapest.
Not boxed software - custom-built, isolated platform instances per client with enterprise-grade functionality.

## Core Product Architecture
- **Type:** Hybrid ERP/CRM/Platform (universal business logic), PaaS-like unique deployed solution
- **Backend:** FastAPI (Python 3.xx), SQLAlchemy (ORM), Pydantic (validation), PostgreSQL (GCP Cloud SQL)
- **Frontend:** Vanilla JS/HTML/CSS (no-framework), Responsive, Modal-UI
- **Cloud (GCP):** Cloud Run (compute), Cloud SQL (DB), Secret Manager, Buckets
- **AI Stack:** Vertex AI (Claude, Gemini 2.5/3.0, Imagen 4.0)
- **Integrations:** Google Drive & Gmail API, SMTP, UNAS, szamlazz.hu, Billingo
- **Security:** VPC, OAuth, Service Accounts, ENV, Secrets, Cookie-based session, granular permissions (Table/Endpoint/HTML level)

## Golden Sample Metrics (Current Platform State)
- **37 Python modules**
- **399 API endpoints**
- **77 Database models**
- **161 Core HTML pages**
- **Platform version:** v7.3

## Development Model
- **Golden Sample:** Base architecture serving as template for all client deployments
- **Isolated infrastructure:** Each client gets dedicated Cloud Run instance, database, and storage
- **Continuous evolution:** Platform develops with client requirements
- **LLM-powered development:** Built using multi-LLM orchestration (Gemini, Claude, Imagen)

## Platform Capabilities (Major Version Milestones)

### v1.0 - Foundation
Modularity, Golden Sample architecture. Core: Project Management, CRM, Quoting, Sales Orders.

### v1.5 - Inventory Management
Lot/Expiry tracking, multi-warehouse, manufacturing, COGS (ELÁBÉ), FIFO, automated document-based inventory movements.

### v2.0 - Workflow Engine
State machine (FSM), dynamic admin interface, condition-based business rule system.

### v3.0 - Pricing Engine
Multi-currency (HUF base), unlimited price lines, granular discount matrix (product/partner/group level).

### v4.0 - Security & Permissions
Granular permissions (HTML page + API endpoint level), CI/CD integration.

### v4.6 - Finance
Foreign currency accounts, partial fulfillment, expense management, extended metadata (weight, custom fields) on documents.

### v5.1 - FX Engine
Global base currency with transaction-level multi-currency support (Sales/Purchase/Finance).

### v5.5 - Billingo Integration
Full sync (Partner/Product/Invoice/NAV), Proforma → Advance → Final invoice aggregation (M:M relationships).

### v5.6 - UI/UX Refactor
Refactored CSS, interactive panels, internal link structure optimization.

### v5.7 - Gmail/Workspace
Domain-wide delegation, automated event-based email, in-app email client.

### v5.9 - UNAS Webshop
Bidirectional sync (Order/Product/Stock), scheduler, custom parameter mapping.

### v6.1 - AI & Mail
VertexAI (Gemini) integration (content generation, analysis), external SMTP support, attachment handling.

### v6.3 - Mobile Optimization
Responsive dashboard (<768px), dedicated mobile views (commission, worksheets, inventory).

### v6.4 - Document Management
Safe storage, file-object associations (Project/Task/Order), automated filename sanitization, Billingo auto-archive.

### v6.6 - Logistics
Mini head-menu UX, mobile terminal support (receiving, inventory, Lot/Expiry breakdown).

### v6.8 - Advanced AI/UI
Automated LLM product descriptions, Google Imagen (generative images), translation algorithms, UI skinning.

### v6.9 - Webshop Configurator
Frontend-based sync management, field mapping, directed data flow control.

### v7.0 - Work and task organization
Kanban system, time tracking, workload distribution, responsibility hierarchy.

### v7.1: User management update
UI + UX + safety upgrade and development through experience gained from daily use

### v7.2: Configuration CSS development
Faster appearance changes and UI

### v7.3: Unique Alembic usage (Current)
This way, upgrading old installations does not require constant supervision and sql modification is faster and more efficient


## Core Modules (23 Major Module Groups)

### 1. Dashboard & Control Panel
Personal dashboard with customizable widgets, classic control panel, task overview, manager views, note archive, KPI tracking.

### 2. Project Management
Project lists, 360 project view, project dashboard, new project creation, partner-user relationships, progress tracking.

### 3. Product & Inventory Management
Product central manager, list views, table views, category management, Excel import/export, product lifecycle tracking, current inventory value, inter-warehouse transfers, scrap management with detailed descriptions, warehouse editor.

### 4. Manufacturing
Recipe-based production, custom manufacturing (without recipe), recipe management, manufacturing history.

### 5. Complex Pricing Engine
Advanced pricing module with display and editor, price line editor, custom price display and management, multi-level discount matrices.

### 6. Partner Management (CRM Foundation)
Partner editor, table view, Excel import/export, partner segmentation, 360° partner view.

### 7. Webshop Integration (UNAS)
Webshop central manager, configuration display, product/order/partner sync configuration, downloaded products/partners/orders from webshop, unprocessed order management.

### 8. CRM Module (Advanced)
Lead management, pipeline tracking, communication history, sales funnel, customer segmentation, custom fields.

### 9. Request for Quotation (RFQ)
RFQ workflow, supplier management, quote comparison, approval chain.

### 10. Procurement
Purchase orders, receiving process, invoice matching, supplier portal, approval workflows.

### 11. Sales & Orders
Quote-to-order conversion, sales orders, delivery notes, commission tracking, approval workflows, order management.

### 12. Task Management (Kanban)
Task boards, Kanban system, task assignment, status tracking, FSM-based workflows.

### 13. Workforce & HR
Time tracking, workload distribution, responsibility hierarchies, employee management, task allocation.

### 14. Document Management
Object-based file associations (projects/tasks/orders), safe storage, automated archival, PDF generation, email integration, Billingo auto-archive.

### 15. AI Module (Vertex AI)
LLM configuration, visual pipeline builder, category prompt management, product description generation, cost tracking for LLM usage.

### 16. Executive Reports
Management dashboards, KPIs, executive summaries, strategic metrics.

### 17. Finance & Accounting
Cash/bank accounts, invoicing (proforma/advance/final), Billingo integration, szamlazz.hu integration, expense management, transaction tracking, bulk payment reconciliation.

### 18. Analytics & Statistics
Product-based reports, partner-based reports, inventory value reports, custom analytics, data export (XLSX).

### 19. Communication
Donkey mailer, email sending log, external portal editor, combined external portal editor.

### 20. Workflow Engine & Automation
Rule display, status editor, workflow rule editor, automated message settings, dashboard configuration, FSM implementation.

### 21. Documentation & System Tools
User guides, support portal, system-adapted automatic descriptions, system visualization, database model viewer, database model maintenance.

### 22. User & Permission Management
User management, event permissions, page-level permissions, granular permission management (table/endpoint/HTML level).

### 23. LLM Advanced Module
LLM configurator, pipeline builder, category tag manager, product description generator with LLM, cost tracking, legacy product editor.

## Target Market
Hungarian SMEs and mid-market companies across diverse industries requiring customized business solutions rather than boxed software.

## Active Client Industries
- Chocolate manufacturing
- Peat mining (industrial)
- Lighting technology (wholesale/retail)
- Beauty products (B2B wholesale)
- Confectionery supplies (B2B)
- Kitchen equipment & industrial kitchen design
- Psychology training institute
- Garden center operations
- Retail chains
- Manufacturing & distribution

## Business Model
**Premium Boutique Strategy:** Focus on high-value clients requiring fully customized solutions.
- **Pricing:** Subscription-based with custom implementation
- **Approach:** Same price for custom solution as boxed software competitors
- **Target:** 25-30 enterprise clients
- **Current Status:** 11 active contracted clients

## Unique Value Proposition
1. **Custom at boxed price:** Fully customized platform at competitive boxed software pricing
2. **Golden Sample + Customization:** Proven base architecture + client-specific modifications
3. **Complete isolation:** Each client gets dedicated infrastructure (Cloud Run, Database, Storage)
4. **Continuous development:** Platform evolves with client requirements
5. **"Dogfooding":** Company uses own platform daily for operations
6. **LLM-powered:** Built and continuously enhanced using multi-LLM orchestration

## Company Information
- **Organization:** Digitális Munkaerő Kft.
- **Location:** Budapest, Hungary
- **Contact:** donkey@digitalis-munkaero.hu
- **Phone:** +36 30/730-5490
- **Parent Site:** https://digitalis-munkaero.hu/

## Website Structure
**Main site:** https://donkey.hu/

### Primary Pages
- **Home:** opening-f6-donkey.html - Main landing page
- **Platform Features:** donkey-platform.html - Platform capabilities and unique features
- **ERP Functions:** donkey-funkciok.html - Detailed ERP module breakdown
- **Technology:** technologia.html - Technical architecture and stack
- **Why Choose Us:** donkey-landing.html - Value proposition and differentiation
- **Case Studies:** esettanulmanyok.html - Real client implementations
- **AI Analysis:** donkey-ai-analysis.html - LLM-optimized technical specification for AI evaluation
- **Implementation:** bevezetes-2.html - Onboarding and implementation process

### AI-Optimized Content
The **donkey-ai-analysis.html** page contains a comprehensive, structured technical specification specifically formatted for LLM analysis. Users can:
- Copy the full specification for AI assistant evaluation
- Ask AI to compare Donkey with other ERP systems
- Request AI to assess fit for their specific business needs

This approach leverages AI capabilities to help potential clients make informed decisions.

## Development Philosophy
- **Built with LLMs:** Platform developed using multi-LLM orchestration despite non-traditional coding background
- **Multi-LLM Workflow:**
  - **Gemini 2.5/3.0:** Backend logic, complex business rules, API development
  - **Claude:** Frontend development, UI/UX, documentation
  - **Imagen 4.0:** Visual content generation
  - **Perplexity:** Research, competitive analysis
- **Rapid iteration:** Continuous deployment, client-driven feature development
- **Real-world testing:** Own company operations serve as primary QA environment

## Technical Details
- **Database models:** 78 core models
- **API endpoints:** 391 endpoints
- **Modules:** 37 Python modules
- **Frontend pages:** 154 HTML pages
- **Integrations:** Google Workspace, Billingo, UNAS, szamlazz.hu
- **Cloud provider:** Google Cloud Platform
- **Deployment:** Cloud Run (serverless containers)
- **Database:** Cloud SQL (PostgreSQL)
- **Storage:** Cloud Storage (isolated buckets per client)

## Security & Compliance
- **Data isolation:** Complete infrastructure separation per client
- **Granular permissions:** Table, endpoint, and HTML-level access control
- **OAuth integration:** Google Workspace domain-wide delegation
- **Secret management:** Google Secret Manager
- **Session handling:** Secure cookie-based authentication
- **Audit trails:** Comprehensive logging and change tracking

## Content Language
- **Primary:** Hungarian
- **Target audience:** Hungarian business owners, entrepreneurs, and decision-makers
- **Documentation:** Hungarian with technical specifications in English where applicable

## Case Studies Available
Detailed implementations showcasing diverse industry applications and customization capabilities.

1. **Own Operations (Dogfooding)**
   - Platform used for internal operations
   - Client management, project tracking, invoicing
   - Real-world validation of features

3. **Webhook Autmation**
   - UNAS integration
   - Unique cupon system
   - Complex workflow in back
   
3. **Perfume B2C Webshop**
   - UNAS integration
   - Multi-currency inventory
   - Automated stock sync

4. **Peat Mine (Industrial)**
   - DOS → Cloud
   - Comprehensive industrial ERP
   - Custom logistics workflows

5. **Garden Center**
   - Map-based product navigation
   - LLM content generation for product descriptions
   - Seasonal inventory management

## Update Information
- **Last updated:** 2025-01-05
- **Format:** llm.txt specification
- **Crawl frequency:** Weekly recommended
- **Platform status:** Active development (v7.3)
- **Client base:** 11 contracted clients, actively growing

## Related Resources
- **Digital Workforce Services:** https://digitalis-munkaero.hu/
- **AI Analysis Page:** https://donkey.hu/donkey-ai-analysis.html
- **Technical Documentation:** Available on request for qualified leads

---
Generated: 2026-01-05
Format: llm.txt specification v3.0
Maintained by: Digitális Munkaerő Kft.