n8n-nodes-leadtime 0.1.7 → 0.1.9

package/README.md

@@ -1,7 +1,367 @@
 # n8n-nodes-leadtime
 
-This library was generated with [Nx](https://nx.dev).
+n8n community node for Leadtime ERP - Project management, time tracking, billing, and more for digital service companies.
 
-## Building
+## 📦 Installation
 
-Run `nx build n8n-nodes-leadtime` to build the library.
+```bash
+npm install n8n-nodes-leadtime
+```
+
+After installation, restart n8n. The node will appear in the node palette under **Leadtime**.
+
+## 🔑 Authentication
+
+The node uses API key authentication. To get your API key:
+
+1. Log in to your Leadtime workspace
+2. Go to **Settings** → **API Keys**
+3. Create a new API key
+4. Copy the key and paste it into the node credentials
+
+## 🎯 Features
+
+### Comprehensive API Coverage
+
+The node provides access to **200+ operations** across all Leadtime ERP modules:
+
+### Project Management
+
+**Project** (12 operations)
+* Get Many, Get, Create, Update (Full/Partial), Delete
+* Upload File, Get File URL
+* Get Team Members, Get Statistics
+
+**Task** (18 operations)
+* Get Many (with filters), Get, Create, Update (Full/Partial), Delete
+* Bulk Create, Bulk Update, Bulk Delete
+* Add Comment, Get Comments
+* Get File URL, Upload File
+* Get Time Bookings, Get Statistics
+
+**Task Comment** (4 operations)
+* Get Many, Get, Create, Update, Delete
+
+**Task Template** (5 operations)
+* Get Many, Get, Create, Update, Delete
+
+**Sprint** (6 operations)
+* Get Many, Get, Create, Update, Delete
+
+**Project Template** (5 operations)
+* Get Many, Get, Create, Update, Delete
+
+### CRM & Contacts
+
+**Contact** (1 operation)
+* Get Many (with filters)
+
+**Organizations** (16 operations)
+
+**Organization** - Customer/partner management
+* Get Many, Get, Create, Update (Full/Partial), Delete
+
+**Organization Member** - External contacts
+* Get Many, Get, Create, Update, Delete
+
+**Organization Member Journal** - Member journal
+* Get Many, Get, Create, Update, Delete
+
+### Time & Attendance
+
+**Time Tracking** (22 operations)
+
+**Time Booking** - Log working hours
+* Get Many, Create, Update, Delete
+
+**Timetable** - Unified calendar view
+* Get (employee schedule)
+
+**Attendance** - Clock in/out
+* Create/Update, Delete
+
+**Vacation Management:**
+* Request, Update, Cancel
+* Approve, Decline
+* Get (Pending/Upcoming/History)
+* Stats & Compensation
+
+**Sick Days:**
+* Request, Update, Delete
+* History
+
+**Overtime:**
+* Get Stats
+* Get Compensation History
+
+### Analytics & Insights
+
+**Analytics** (5 operations)
+
+**Insight** - Business intelligence
+* Project Chart (working hours analysis)
+* Staff Chart (employee time analysis)
+* Turnover Chart (revenue analysis & forecast)
+* Goal Chart (employee goal progress)
+* Workload Chart (open tasks analysis)
+
+### Administration
+
+**Settings & Configuration** (29 operations)
+
+**Workspace:**
+* Details, Upload File
+* List Users, Quick Search
+* Product List, Manual Position Categories
+
+**Product Management:**
+* Product Catalog (CRUD with variants)
+* Product Categories (Get/Delete)
+
+**Settings:**
+* Subscription Status
+* Basic Settings (localization, attendance, sprints)
+* Company Settings (master data)
+* Permissions List
+
+**Roles:**
+* Get Many, Get (with permissions)
+
+**VAT Rates:**
+* Get Many
+
+**Task Settings:**
+* Custom Fields, Activities, Statuses, Types
+
+**Project Settings:**
+* Categories, Statuses, Phases
+* Custom Fields
+* Support Contingents
+
+### Personal
+
+**Personal Tools** (13 operations)
+
+**Account:**
+* Get Info
+* Get/Update Employee Data
+
+**Journal:**
+* Get Many, Create, Update (Full/Partial), Delete
+
+**Notification:**
+* Get Many (with unread filter)
+
+### Sales
+
+**Sales Tools** (2 operations)
+
+**Sales:**
+* Get Estimates
+* Get Opportunities
+
+## 💡 Usage Examples
+
+### Create a Task with Time Tracking
+
+```json
+{
+  "resource": "task",
+  "operation": "create",
+  "projectId": "{{ $json.projectId }}",
+  "title": "Implement new feature",
+  "typeId": "{{ $json.typeId }}",
+  "statusId": "{{ $json.statusId }}",
+  "priority": "High",
+  "estimatedTime": 8,
+  "assignedToId": "{{ $json.userId }}",
+  "description": "<p>Detailed task description</p>"
+}
+```
+
+### Add Comment with Time Booking
+
+```json
+{
+  "resource": "taskComment",
+  "operation": "create",
+  "taskIdentifier": "{{ $json.taskId }}",
+  "comment": "Completed implementation",
+  "statusId": "{{ $json.doneStatusId }}",
+  "timeBookingHours": 2,
+  "timeBookingActivityId": "{{ $json.activityId }}"
+}
+```
+
+### Get Invoice PDF
+
+```json
+{
+  "resource": "invoice",
+  "operation": "getFileUrl",
+  "invoiceId": "{{ $json.invoiceId }}",
+  "fileType": "pdf",
+  "documentType": "invoice"
+}
+```
+
+### Upload File to Workspace
+
+```json
+{
+  "resource": "workspace",
+  "operation": "uploadFile",
+  "file": "{{ $binary.file }}"
+}
+```
+
+### Get Project Analytics
+
+```json
+{
+  "resource": "insight",
+  "operation": "getProjectChart",
+  "projectIds": "{{ $json.projectIds }}",
+  "model": "timeSeries",
+  "period": "weeks",
+  "breakdown": "byUser",
+  "startDate": "2024-01-01",
+  "endDate": "2024-12-31"
+}
+```
+
+### Bulk Create Tasks
+
+```json
+{
+  "resource": "task",
+  "operation": "bulkCreate",
+  "tasksJson": JSON.stringify([
+    {
+      "title": "Task 1",
+      "projectId": "...",
+      "typeId": "...",
+      "statusId": "..."
+    },
+    {
+      "title": "Task 2",
+      "projectId": "...",
+      "typeId": "...",
+      "statusId": "..."
+    }
+  ])
+}
+```
+
+## 🎨 Dynamic Dropdowns
+
+The node provides **12 intelligent dropdown methods** that automatically populate with data from your Leadtime workspace:
+
+| Dropdown              | Purpose                   | Depends On |
+| --------------------- | ------------------------- | ---------- |
+| loadProjects          | Select projects           | -          |
+| loadEmployees         | Select employees          | -          |
+| loadTeams             | Select teams              | -          |
+| loadTaskStatuses      | Select task statuses      | -          |
+| loadTaskTypes         | Select task types         | -          |
+| loadActivities        | Select work activities    | -          |
+| loadProjectCategories | Select project categories | -          |
+| loadProjectStatuses   | Select project statuses   | -          |
+| loadProjectPhases     | Select project phases     | -          |
+| loadProjectTaskTypes  | Task types for project    | Project    |
+| loadTypeStatuses      | Statuses for task type    | Task Type  |
+| loadProjectUsers      | Team members              | Project    |
+
+### Cascading Dropdowns Example
+
+When creating a task, dropdowns cascade intelligently:
+
+```
+1. Select Project → loads project-specific task types
+2. Select Task Type → loads allowed statuses for that type
+3. Select Status → ready to assign
+4. Select Assignee → loads only team members from selected project
+```
+
+## 🔧 Development
+
+### Prerequisites
+
+* Node.js >= 18
+* n8n >= 1.0.0
+* TypeScript >= 5.x
+
+### Local Development
+
+```bash
+git clone https://github.com/workcio/workc.git
+cd workc
+npm install
+nx build n8n-nodes-leadtime
+
+# Link for local testing
+cd dist/libs/integrations/n8n-nodes-leadtime
+npm link
+cd ~/.n8n/custom
+npm link n8n-nodes-leadtime
+
+# Start n8n
+n8n start
+```
+
+## 📖 Documentation
+
+* **Leadtime API Documentation** - Official API reference
+* **n8n Community Nodes** - n8n developer docs
+
+## 🐛 Known Limitations
+
+* ⚠️ No webhook/trigger support (would require separate trigger node)
+* ⚠️ Batch file upload not implemented (single file upload works)
+* ⚠️ Some complex nested data structures require JSON input
+
+## 🤝 Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Coding Guidelines
+
+* ✅ TypeScript strict mode
+* ✅ Consistent error handling (try/catch with type guards)
+* ✅ Use `i === 0` pattern for array responses to avoid duplicates
+* ✅ Full URLs for all API calls
+* ✅ Conditional fields with `displayOptions.show`
+
+## 📝 License
+
+MIT License - see LICENSE file
+
+Copyright (c) 2024 Lukas Ebner / Leadtime Labs GmbH
+
+## 👤 Author
+
+**Lukas Ebner**  
+Leadtime Labs GmbH  
+<https://leadtime.de>
+
+## 📮 Support
+
+* 🐛 GitHub Issues
+* 💬 n8n Community Forum
+* 📧 Email: support@leadtime.de
+* 📚 Leadtime Help Center
+
+## 🙏 Acknowledgments
+
+* n8n - Workflow automation platform
+* Leadtime - ERP for digital service companies
+
+---
+
+**Made with ❤️ for the n8n Community**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-leadtime",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "n8n community node for the Leadtime ERP Public API - Project management, time tracking, billing, and more for digital service companies",
   "keywords": [
     "n8n-community-node-package",
@@ -19,6 +19,7 @@
     "type": "git",
     "url": "https://github.com/workcio/workc.git"
   },
+  "homepage": "https://leadtime.de",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",