Chris Coutinho
109 lines
3.7 KiB
Markdown
109 lines
3.7 KiB
Markdown
# Deck App
|
|
|
|
### Deck Tools
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `deck_create_board` | Create a new Deck board with title and color |
|
|
| `deck_create_stack` | Create a new stack in a board |
|
|
| `deck_update_stack` | Update stack title and order |
|
|
| `deck_delete_stack` | Delete a stack and all its cards |
|
|
| `deck_create_card` | Create a new card in a stack with full options (title, description, due date, etc.) |
|
|
| `deck_update_card` | Update any aspect of a card (title, description, owner, order, etc.) |
|
|
| `deck_delete_card` | Delete a card |
|
|
| `deck_archive_card` | Archive a card |
|
|
| `deck_unarchive_card` | Unarchive a card |
|
|
| `deck_reorder_card` | Move/reorder cards within or between stacks |
|
|
| `deck_create_label` | Create a new label in a board |
|
|
| `deck_update_label` | Update label title and color |
|
|
| `deck_delete_label` | Delete a label |
|
|
| `deck_assign_label_to_card` | Assign a label to a card |
|
|
| `deck_remove_label_from_card` | Remove a label from a card |
|
|
| `deck_assign_user_to_card` | Assign a user to a card |
|
|
| `deck_unassign_user_from_card` | Remove a user assignment from a card |
|
|
|
|
### Deck Resources
|
|
| Resource | Description |
|
|
|----------|-------------|
|
|
| `nc://Deck/boards` | List all deck boards |
|
|
| `nc://Deck/boards/{board_id}` | Get details of a specific board |
|
|
| `nc://Deck/boards/{board_id}/stacks` | List all stacks in a board |
|
|
| `nc://Deck/boards/{board_id}/stacks/{stack_id}` | Get details of a specific stack |
|
|
| `nc://Deck/boards/{board_id}/stacks/{stack_id}/cards` | List all cards in a stack |
|
|
| `nc://Deck/boards/{board_id}/stacks/{stack_id}/cards/{card_id}` | Get details of a specific card |
|
|
| `nc://Deck/boards/{board_id}/labels` | List all labels in a board |
|
|
| `nc://Deck/boards/{board_id}/labels/{label_id}` | Get details of a specific label |
|
|
|
|
|
|
|
|
### Deck Project Management
|
|
|
|
The server provides complete Nextcloud Deck integration, enabling you to manage projects, tasks, and workflows:
|
|
|
|
- Create and manage boards, stacks, and cards
|
|
- Organize tasks with labels and user assignments
|
|
- Archive/unarchive cards and reorder within or between stacks
|
|
- Full CRUD operations on all Deck entities
|
|
- Browse project structure through hierarchical resources
|
|
|
|
**Usage Examples:**
|
|
|
|
```python
|
|
# Create a new project board
|
|
await deck_create_board(title="Website Redesign", color="1976D2")
|
|
|
|
# Create workflow stacks
|
|
await deck_create_stack(board_id=1, title="To Do", order=1)
|
|
await deck_create_stack(board_id=1, title="In Progress", order=2)
|
|
await deck_create_stack(board_id=1, title="Done", order=3)
|
|
|
|
# Create task cards with details
|
|
await deck_create_card(
|
|
board_id=1,
|
|
stack_id=1,
|
|
title="Design new homepage",
|
|
description="Create mockups for the new homepage layout",
|
|
type="plain",
|
|
order=1,
|
|
duedate="2025-08-15T17:00:00"
|
|
)
|
|
|
|
# Create and assign labels for organization
|
|
await deck_create_label(board_id=1, title="High Priority", color="F44336")
|
|
await deck_create_label(board_id=1, title="UI/UX", color="9C27B0")
|
|
|
|
# Assign labels and users to cards
|
|
await deck_assign_label_to_card(board_id=1, stack_id=1, card_id=1, label_id=1)
|
|
await deck_assign_user_to_card(board_id=1, stack_id=1, card_id=1, user_id="designer")
|
|
|
|
# Move cards through workflow
|
|
await deck_reorder_card(
|
|
board_id=1,
|
|
stack_id=1, # From "To Do"
|
|
card_id=1,
|
|
order=1,
|
|
target_stack_id=2 # To "In Progress"
|
|
)
|
|
|
|
# Update task progress
|
|
await deck_update_card(
|
|
board_id=1,
|
|
stack_id=2,
|
|
card_id=1,
|
|
description="Homepage mockups completed, starting development",
|
|
order=1
|
|
)
|
|
|
|
# Complete tasks
|
|
await deck_reorder_card(
|
|
board_id=1,
|
|
stack_id=2, # From "In Progress"
|
|
card_id=1,
|
|
order=1,
|
|
target_stack_id=3 # To "Done"
|
|
)
|
|
|
|
# Archive completed cards
|
|
await deck_archive_card(board_id=1, stack_id=3, card_id=1)
|
|
```
|