@rglabs/butterfly 1.0.4 → 1.2.0

package/.claude/settings.local.json

@@ -18,7 +18,11 @@
       "Bash(BUTTERFLY_DEBUG=true npm run start -- download -t objects)",
       "Bash(cat:*)",
       "Bash(BUTTERFLY_DEBUG=true npm run start:*)",
-      "Bash(npm run start:*)"
+      "Bash(npm run start:*)",
+      "Bash(xargs:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)"
     ],
     "deny": []
   }

package/POC-Generator/README.md

@@ -0,0 +1,85 @@
+# POC Generator
+
+A repository containing ready-to-use prompts for automatically extracting table structures and generating system documentation from mock files (Excel, Word, PDF).
+
+## Project Structure
+
+```
+poc-generator/
+├── mocks/                          # Place your source files here (gitignored)
+│   ├── .gitkeep
+│   └── table_examples/             # Example JSON outputs
+├── prompts/                        # Ready-to-use prompt templates
+│   ├── 01-extract-tables.md
+│   ├── 02-extract-structure.md
+│   ├── 03-generate-html.md
+│   └── 04-generate-erd.md
+├── tables/                         # Generated JSON files (gitignored)
+│   ├── partials/                   # Related table group
+│   │   ├── users.json              # Individual table
+│   │   ├── orders.json             # Individual table
+│   │   └── partials_all.json       # Combined tables
+│   └── [other_module]/             # Other table groups
+│       ├── table1.json
+│       └── [module]_all.json
+├── output/                         # Generated HTML outputs (gitignored)
+└── README.md
+```
+
+## Usage
+
+### 1. Add Your Source Files
+
+Place the following file types in the `mocks/` folder:
+- Excel files (.xlsx) - Table structures, screen designs
+- Word documents (.docx) - System documentation
+- PDF files (.pdf) - Technical specifications
+
+### 2. Use Prompts Sequentially
+
+Each prompt file is designed for a specific task:
+
+| Prompt | Purpose |
+|--------|---------|
+| `00-master.md` | **Master prompt** - Reads all prompts and executes complete flow |
+| `01-extract-tables.md` | Extracts table structures from Excel to JSON (with groups) |
+| `02-extract-structure.md` | Extracts system structure from Word documents |
+| `03-generate-html.md` | Generates HTML documentation from JSON |
+| `04-generate-erd.md` | Creates ERD diagrams from table structures |
+| `05-table-differences.md` | Compares with existing tables and generates diff report |
+
+### 3. Table Output Structure
+
+Tables are organized hierarchically:
+- **Individual files**: Each table gets its own JSON file (`users.json`)
+- **Combined files**: All tables in a folder are combined into `[folder]_all.json`
+- **Folders**: Related tables are grouped (e.g., `partials/`, `auth/`, `inventory/`)
+
+### 4. Outputs
+
+- JSON files are saved to `tables/[module]/` folders
+- HTML files are saved to `output/` folder
+
+## Example Workflow
+
+```bash
+# 1. Add your files to mocks folder
+cp your-files/* mocks/
+
+# 2. Use the prompts with Claude or another AI tool
+# Start with prompts/01-extract-tables.md
+
+# 3. Check your outputs
+ls tables/partials/
+# users.json  orders.json  products.json  partials_all.json
+
+ls output/
+# documentation.html  erd.html
+```
+
+## Notes
+
+- This repo is designed as a "tool" - you don't need to push changes
+- `mocks/` and `tables/` folders are gitignored, so your personal files won't be shared
+- Prompts support both Turkish and English documents
+- Each table group (folder) has both individual and combined JSON files

package/POC-Generator/examples/reports/examples/query_code.twig

@@ -0,0 +1,225 @@
+{# ============================================
+   Report: Example Report Template
+   Description: Demonstrates report structure with Tailwind CSS
+   ============================================ #}
+
+{# Required CSS Libraries #}
+<link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet">
+<link href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/css/all.min.css" rel="stylesheet">
+
+{# Required JS Libraries #}
+<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js" defer></script>
+
+{# ============================================
+   QUERY EXAMPLES
+   ============================================ #}
+
+{# Simple Query - Select All #}
+{% set examples = db().from('examples').orderBy('id').get() %}
+
+{# Simple Query - Order Descending #}
+{% set examples = db().from('examples').orderByDesc('id').get() %}
+
+{# Query with Filters and Selected Columns #}
+{% set examples = db()
+    .from('examples', ['title', 'id', 'created_at', 'status'])
+    .where('created_at', '>=', todayStart)
+    .where('created_at', '<=', todayEnd)
+    .whereIn('status', [3, 4])
+    .get()
+%}
+
+{# Query with JOIN #}
+{% set examples = db()
+    .from('examples', [
+        'examples.dropped_at',
+        'examples.part_number',
+        'example_groups.name',
+        'examples.release_state'
+    ])
+    .join('example_groups', 'example_groups.id', '=', 'examples.example_group_id')
+    .orderBy('example_groups.created', 'desc')
+    .limit(50)
+    .get()
+%}
+
+{# Query with Aggregation #}
+{% set summary = db()
+    .from('orders')
+    .select([
+        'COUNT(*) as total_orders',
+        'SUM(total_amount) as total_revenue',
+        'AVG(total_amount) as avg_order_value'
+    ])
+    .where('status', '!=', 'cancelled')
+    .first()
+%}
+
+{# Query with Date Range #}
+{% set dailyOrders = db()
+    .from('orders')
+    .select([
+        'DATE(created_at) as order_date',
+        'COUNT(*) as order_count',
+        'SUM(total_amount) as daily_revenue'
+    ])
+    .where('created_at', '>=', startDate)
+    .where('created_at', '<=', endDate)
+    .groupBy('DATE(created_at)')
+    .orderBy('order_date')
+    .get()
+%}
+
+{# Query with Subquery / Nested #}
+{% set topCustomers = db()
+    .from('users', ['users.id', 'users.name', 'users.email'])
+    .selectRaw('(SELECT COUNT(*) FROM orders WHERE orders.user_id = users.id) as order_count')
+    .selectRaw('(SELECT SUM(total_amount) FROM orders WHERE orders.user_id = users.id) as total_spent')
+    .orderByDesc('total_spent')
+    .limit(10)
+    .get()
+%}
+
+{# ============================================
+   REPORT TEMPLATE
+   ============================================ #}
+
+<div class="min-h-screen bg-gray-100 py-8" x-data="reportData()">
+
+    {# Header #}
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="bg-white rounded-lg shadow-lg p-6 mb-6">
+            <div class="flex justify-between items-center">
+                <div>
+                    <h1 class="text-2xl font-bold text-gray-900">
+                        <i class="fas fa-chart-line text-blue-500 mr-2"></i>
+                        Report Title
+                    </h1>
+                    <p class="text-gray-500 mt-1">Generated: {{ "now"|date("Y-m-d H:i:s") }}</p>
+                </div>
+                <div class="flex gap-2">
+                    <button @click="exportCSV()" class="bg-green-500 hover:bg-green-600 text-white px-4 py-2 rounded-lg">
+                        <i class="fas fa-file-csv mr-1"></i> Export CSV
+                    </button>
+                    <button @click="printReport()" class="bg-blue-500 hover:bg-blue-600 text-white px-4 py-2 rounded-lg">
+                        <i class="fas fa-print mr-1"></i> Print
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {# Summary Cards #}
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 mb-6">
+        <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
+            <div class="bg-white rounded-lg shadow p-6">
+                <div class="flex items-center">
+                    <div class="p-3 rounded-full bg-blue-100 text-blue-500">
+                        <i class="fas fa-shopping-cart text-2xl"></i>
+                    </div>
+                    <div class="ml-4">
+                        <p class="text-sm font-medium text-gray-500">Total Orders</p>
+                        <p class="text-2xl font-bold text-gray-900">{{ summary.total_orders|number_format }}</p>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-lg shadow p-6">
+                <div class="flex items-center">
+                    <div class="p-3 rounded-full bg-green-100 text-green-500">
+                        <i class="fas fa-euro-sign text-2xl"></i>
+                    </div>
+                    <div class="ml-4">
+                        <p class="text-sm font-medium text-gray-500">Total Revenue</p>
+                        <p class="text-2xl font-bold text-gray-900">{{ summary.total_revenue|number_format(2, ',', '.') }} EUR</p>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-lg shadow p-6">
+                <div class="flex items-center">
+                    <div class="p-3 rounded-full bg-yellow-100 text-yellow-500">
+                        <i class="fas fa-calculator text-2xl"></i>
+                    </div>
+                    <div class="ml-4">
+                        <p class="text-sm font-medium text-gray-500">Avg Order Value</p>
+                        <p class="text-2xl font-bold text-gray-900">{{ summary.avg_order_value|number_format(2, ',', '.') }} EUR</p>
+                    </div>
+                </div>
+            </div>
+
+            <div class="bg-white rounded-lg shadow p-6">
+                <div class="flex items-center">
+                    <div class="p-3 rounded-full bg-red-100 text-red-500">
+                        <i class="fas fa-clock text-2xl"></i>
+                    </div>
+                    <div class="ml-4">
+                        <p class="text-sm font-medium text-gray-500">Pending</p>
+                        <p class="text-2xl font-bold text-gray-900">{{ summary.pending_count|number_format }}</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {# Chart #}
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 mb-6">
+        <div class="bg-white rounded-lg shadow p-6">
+            <h3 class="text-lg font-semibold text-gray-900 mb-4">Trend Chart</h3>
+            <canvas id="trendChart" height="100"></canvas>
+        </div>
+    </div>
+
+    {# Data Table #}
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="bg-white rounded-lg shadow overflow-hidden">
+            <table class="min-w-full divide-y divide-gray-200">
+                <thead class="bg-gray-50">
+                    <tr>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">ID</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Name</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Status</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Date</th>
+                        <th class="px-6 py-3 text-right text-xs font-medium text-gray-500 uppercase">Actions</th>
+                    </tr>
+                </thead>
+                <tbody class="bg-white divide-y divide-gray-200">
+                    {% for item in examples %}
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-6 py-4 whitespace-nowrap text-sm font-medium text-gray-900">{{ item.id }}</td>
+                        <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-900">{{ item.title }}</td>
+                        <td class="px-6 py-4 whitespace-nowrap">
+                            {% set statusColors = {
+                                'draft': 'bg-gray-100 text-gray-800',
+                                'pending': 'bg-yellow-100 text-yellow-800',
+                                'approved': 'bg-green-100 text-green-800',
+                                'rejected': 'bg-red-100 text-red-800'
+                            } %}
+                            <span class="px-2 py-1 text-xs rounded-full {{ statusColors[item.status] ?? 'bg-gray-100 text-gray-800' }}">
+                                {{ item.status|capitalize }}
+                            </span>
+                        </td>
+                        <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                            {{ item.created_at|date("d.m.Y H:i") }}
+                        </td>
+                        <td class="px-6 py-4 whitespace-nowrap text-right text-sm">
+                            <a href="#" class="text-blue-600 hover:text-blue-900 mr-2">
+                                <i class="fas fa-eye"></i>
+                            </a>
+                            <a href="#" class="text-green-600 hover:text-green-900 mr-2">
+                                <i class="fas fa-edit"></i>
+                            </a>
+                        </td>
+                    </tr>
+                    {% else %}
+                    <tr>
+                        <td colspan="5" class="px-6 py-4 text-center text-gray-500">No data found</td>
+                    </tr>
+                    {% endfor %}
+                </tbody>
+            </table>
+        </div>
+    </div>
+</div>
+