root/trading_bot_v4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: complete Nextcloud Deck integration with English emoji stack names

Browse Source 
- Renamed all stacks to English with emojis (Backlog, Planning, In Progress, Complete)
- Updated sync script to use new stack names
- Created all 3 initiative cards (IDs 189-191)
- Enhanced error handling with detailed debug output
- Updated documentation with API limitations and troubleshooting
- Fixed stack fallback from 'eingang' to '📥 Backlog'

Changes:
- scripts/sync-roadmap-to-deck.py: Updated STATUS_TO_STACK mapping, added verbose logging
- docs/NEXTCLOUD_DECK_SYNC.md: Updated stack table, added Known Limitations section, enhanced troubleshooting

Note: 6 duplicate/test cards (184-188, 192) must be deleted manually from Nextcloud UI
      due to API limitations (DELETE returns 405)
This commit is contained in:
mindesbunister
2025-11-14 11:25:09 +01:00
parent 77a22bae3f
commit a49db192f4
2 changed files with 74 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
docs/NEXTCLOUD_DECK_SYNC.md
View File

@@ -32,10 +32,10 @@ This will:
| Deck Stack | Roadmap Status | Purpose |
|------------|----------------|---------|
| `eingang` (inbox) | FUTURE | Backlog items, ideas, future phases |
| `in planung` (planning) | PENDING | Ready to implement, needs detailed specs |
| `in arbeit` (in progress) | IN PROGRESS (🔄) | Currently working on |
| `erledigt` (done) | COMPLETE (✅) | Finished and verified |
| 📥 Backlog | FUTURE | Backlog items, ideas, future phases |
| 📋 Planning | PENDING | Ready to implement, needs detailed specs |
| 🚀 In Progress | IN PROGRESS (🔄) | Currently working on |
| ✅ Complete | COMPLETE (✅) | Finished and verified |
## Usage
@@ -102,9 +102,34 @@ Nextcloud Deck API: `/index.php/apps/deck/api/v1.0`
Key endpoints used:
- `GET /boards` - List all boards
- `GET /boards/{boardId}` - Get board details
- `GET /boards/{boardId}/stacks` - Get stacks
- `GET /boards/{boardId}` - Get board details with stacks (no cards included)
- `GET /boards/{boardId}/stacks/{stackId}` - Get stack with cards (this works!)
- `POST /boards/{boardId}/stacks/{stackId}/cards` - Create card
- `PUT /boards/{boardId}/stacks/{stackId}` - Rename stack
**Note:** Many endpoints return 405 Method Not Allowed:
- `GET /boards/{boardId}/stacks/{stackId}/cards` - Not supported
- `DELETE /boards/{boardId}/cards/{cardId}` - Not supported
- `GET /boards/{boardId}/cards/{cardId}` - Not supported
## Known Limitations
1. **No Duplicate Detection**: The Deck API v1.0 doesn't support listing cards by stack, so:
- Running `--init` multiple times creates duplicate cards
- Delete duplicates manually from the Nextcloud Deck UI
- Always use `--dry-run` first to preview changes
2. **No Card Deletion API**: The DELETE endpoint returns 405, so:
- Test cards must be deleted manually from the web UI
- No automated cleanup possible
3. **Limited GET Support**: Most card-level GET endpoints return 405:
- Cannot verify card creation without checking full stack
- Use `GET /boards/{boardId}/stacks/{stackId}` to view cards
4. **No Bidirectional Sync**: Card position changes in Deck don't update markdown files
5. **Initiative-Level Only**: Currently only syncs high-level initiatives, not individual phases
## Troubleshooting
@@ -114,15 +139,25 @@ Key endpoints used:
- Verify name contains "trader" (case insensitive)
**"405 Method Not Allowed"**
- Nextcloud Deck version may have different API
- Check Nextcloud Deck version in settings
- Some GET endpoints may not be available
- Normal for most GET/DELETE card endpoints
- Use stack endpoint instead: `GET /boards/{boardId}/stacks/{stackId}`
- Check Nextcloud Deck API documentation for your version
**"Cards not showing in board"**
- Cards ARE created but not visible in `GET /boards/{boardId}` response
- Use `GET /boards/{boardId}/stacks/{stackId}` to view cards properly
- Or check the Nextcloud Deck web UI
**"Cards not syncing"**
- Check `/tmp/deck-config.json` exists
- Verify credentials in config
- Run with `--dry-run` first to test
**"Duplicate cards"**
- This is expected - API doesn't support duplicate checking
- Delete extras manually from Nextcloud Deck UI
- Always run `--dry-run` before `--init`
## Development
**Adding new roadmap files:**
@@ -140,7 +175,7 @@ ROADMAP_FILES = [
Edit `STATUS_TO_STACK` dict:
```python
STATUS_TO_STACK = {
'IN PROGRESS': 'in arbeit',
'YOUR_STATUS': 'your_stack', # Add here
'IN PROGRESS': '🚀 In Progress',
'YOUR_STATUS': '📋 Your Stack', # Add here (with emoji)
}
```