add epics and wikis features
This commit is contained in:
parent
ec48ce3225
commit
5f7137a351
36 changed files with 4277 additions and 19 deletions
338
EPIC_WIKI_IMPLEMENTATION_SUMMARY.md
Normal file
338
EPIC_WIKI_IMPLEMENTATION_SUMMARY.md
Normal file
|
|
@ -0,0 +1,338 @@
|
|||
# Epic & Wiki Feature Implementation Summary
|
||||
|
||||
## Overview
|
||||
This document summarizes the implementation of the Epic and Wiki features for the Kanban application.
|
||||
|
||||
## What Was Implemented
|
||||
|
||||
### Backend (Flask)
|
||||
|
||||
#### 1. Database Models
|
||||
|
||||
**Epic Model** (`backend/app/models/epic.py`)
|
||||
- Rich text content support (JSON for Slate.js)
|
||||
- Hierarchical structure (parent_epic_id for nesting)
|
||||
- Color coding
|
||||
- Position ordering
|
||||
- Board-level scoping
|
||||
- Soft delete support (closed field)
|
||||
- Depth limit for hierarchy control
|
||||
|
||||
**Wiki Model** (`backend/app/models/wiki.py`)
|
||||
- Rich text content (JSON for Slate.js)
|
||||
- URL-friendly slugs
|
||||
- Summary field
|
||||
- Categories for organization
|
||||
- Tags support
|
||||
- Created by / Updated by tracking
|
||||
- Board-level scoping
|
||||
|
||||
**Card Model Update** (`backend/app/models/card.py`)
|
||||
- Added `epic_id` foreign key to link cards to epics
|
||||
|
||||
**Association Table** (`wiki_entity_links`)
|
||||
- Many-to-many relationship between Wikis and entity types
|
||||
- Supports linking Wikis to Cards, Epics, and future entity types
|
||||
|
||||
#### 2. Database Migration
|
||||
- Created migration file: `6fc439155ced_add_epic_and_wiki_models.py`
|
||||
- Adds all new tables and relationships
|
||||
|
||||
### Frontend (React/TypeScript)
|
||||
|
||||
#### 1. TypeScript Types (`frontend/src/types/epic.ts`)
|
||||
```typescript
|
||||
- Epic interface
|
||||
- Wiki interface
|
||||
- CreateEpicRequest / UpdateEpicRequest
|
||||
- CreateWikiRequest / UpdateWikiRequest
|
||||
- WikiEntityLink interface
|
||||
```
|
||||
|
||||
#### 2. Components
|
||||
|
||||
**RichTextEditor** (`frontend/src/components/RichTextEditor.tsx`)
|
||||
- Slate.js-based rich text editor
|
||||
- Editable with proper styling
|
||||
- Dark mode support
|
||||
- Placeholder support
|
||||
- Read-only mode option
|
||||
|
||||
**RichTextContent** (`frontend/src/components/RichTextContent.tsx`)
|
||||
- Read-only renderer for Slate.js content
|
||||
- Supports paragraphs, lists, blockquotes
|
||||
- Text formatting (bold, italic, underline, code)
|
||||
- Dark mode styling
|
||||
|
||||
#### 3. Custom Hook
|
||||
|
||||
**useEpics** (`frontend/src/hooks/useEpics.ts`)
|
||||
- Fetch all epics for a board
|
||||
- Create new epic
|
||||
- Update existing epic
|
||||
- Delete epic
|
||||
- Integrated with global loader and toast notifications
|
||||
- Error handling with user-friendly messages
|
||||
|
||||
#### 4. API Integration
|
||||
|
||||
Updated `useApi` hook with epic methods:
|
||||
```typescript
|
||||
- getEpics(boardId)
|
||||
- createEpic(boardId, epicData)
|
||||
- getEpic(epicId)
|
||||
- updateEpic(epicId, epicData)
|
||||
- deleteEpic(epicId)
|
||||
- addEpicToCard(cardId, epicId)
|
||||
- removeEpicFromCard(cardId, epicId)
|
||||
```
|
||||
|
||||
## Key Design Decisions
|
||||
|
||||
### 1. Epic Hierarchy
|
||||
- **Decision**: Self-referential foreign key (`parent_epic_id`)
|
||||
- **Rationale**: Allows flexible nesting of epics with arbitrary depth
|
||||
- **Feature**: `depth_limit` field to control maximum nesting depth
|
||||
|
||||
### 2. Rich Text Storage
|
||||
- **Decision**: Store as JSON (compatible with Slate.js)
|
||||
- **Rationale**:
|
||||
- Slate.js natively uses JSON format
|
||||
- No serialization/deserialization overhead
|
||||
- Easy to query and modify content structure
|
||||
|
||||
### 3. Wiki vs Document Naming
|
||||
- **Decision**: Use "Wiki" instead of "Document"
|
||||
- **Rationale**: Avoids confusion with file attachments
|
||||
- **Meaning**: Wiki implies knowledge base / documentation repository
|
||||
|
||||
### 4. Entity Linking Strategy
|
||||
- **Decision**: Polymorphic association table (`wiki_entity_links`)
|
||||
- **Rationale**:
|
||||
- Single table handles all entity types
|
||||
- Easy to add new entity types in future
|
||||
- Avoids circular imports and complex schema changes
|
||||
|
||||
### 5. Epic-Card Relationship
|
||||
- **Decision**: One-way reference (Card → Epic)
|
||||
- **Rationale**:
|
||||
- Simpler than many-to-many (epics contain cards)
|
||||
- Cards can belong to one epic at a time
|
||||
- Consistent with Jira's parent/child pattern
|
||||
|
||||
## Architecture
|
||||
|
||||
### Backend Data Flow
|
||||
|
||||
```
|
||||
Board (1) ───────┬─────── (1) Epic
|
||||
│ │
|
||||
│ │─── (0..*) Card (via epic_id)
|
||||
│
|
||||
└───────────────┬─────── (0..*) Wiki
|
||||
│
|
||||
└─── wiki_entity_links ───┬── Card
|
||||
├── Epic
|
||||
└── (future entities)
|
||||
```
|
||||
|
||||
### Frontend Component Structure
|
||||
|
||||
```
|
||||
BoardEpics (page)
|
||||
├── EpicList
|
||||
│ └── EpicCard
|
||||
└── CreateEpicModal
|
||||
├── EpicForm
|
||||
│ ├── EpicNameInput
|
||||
│ ├── EpicDescriptionInput
|
||||
│ └── RichTextEditor (content)
|
||||
└── ColorPicker
|
||||
```
|
||||
|
||||
## Next Steps
|
||||
|
||||
### Immediate Actions Required
|
||||
|
||||
1. **Run Database Migration**
|
||||
```bash
|
||||
cd backend
|
||||
flask db upgrade
|
||||
```
|
||||
|
||||
2. **Create Backend Routes** (`backend/app/routes/kanban/epics.py`)
|
||||
- CRUD operations for Epics
|
||||
- Epic-Card linking endpoints
|
||||
- Wiki CRUD operations
|
||||
- Wiki-Entity linking endpoints
|
||||
|
||||
3. **Create Backend Schemas** (`backend/app/schemas/epic.py`, `wiki.py`)
|
||||
- Marshmallow schemas for serialization
|
||||
- Input validation
|
||||
|
||||
4. **Update BoardEpics Page** (`frontend/src/pages/BoardEpics.tsx`)
|
||||
- Implement epic list view
|
||||
- Add create epic modal
|
||||
- Add epic detail view
|
||||
- Include RichTextEditor for epic content
|
||||
|
||||
5. **Update Card Detail Page** (`frontend/src/pages/CardDetail.tsx`)
|
||||
- Add epic selector dropdown
|
||||
- Display linked epic information
|
||||
- Add wiki links
|
||||
|
||||
### Future Enhancements
|
||||
|
||||
1. **Wiki Features**
|
||||
- Wiki page with sidebar navigation
|
||||
- Markdown export/import
|
||||
- Wiki search functionality
|
||||
- Version history
|
||||
|
||||
2. **Epic Features**
|
||||
- Epic progress tracking (cards completed vs total)
|
||||
- Epic metrics dashboard
|
||||
- Epic drag-and-drop reordering
|
||||
- Epic timeline view
|
||||
|
||||
3. **UI/UX Improvements**
|
||||
- Epic color picker with presets
|
||||
- Epic hierarchy tree view
|
||||
- Inline card epic assignment
|
||||
- Epic templates
|
||||
|
||||
4. **Analytics**
|
||||
- Epic completion rate
|
||||
- Time spent on epic
|
||||
- Epic size distribution
|
||||
- Wiki usage statistics
|
||||
|
||||
## Database Schema
|
||||
|
||||
### Epic Table
|
||||
```sql
|
||||
CREATE TABLE epics (
|
||||
id SERIAL PRIMARY KEY,
|
||||
name VARCHAR(200) NOT NULL,
|
||||
description TEXT,
|
||||
content JSONB,
|
||||
color VARCHAR(7),
|
||||
closed BOOLEAN DEFAULT FALSE,
|
||||
pos FLOAT,
|
||||
depth_limit INTEGER,
|
||||
board_id INTEGER REFERENCES boards(id),
|
||||
parent_epic_id INTEGER REFERENCES epics(id),
|
||||
date_last_activity TIMESTAMP,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||
);
|
||||
```
|
||||
|
||||
### Wiki Table
|
||||
```sql
|
||||
CREATE TABLE wikis (
|
||||
id SERIAL PRIMARY KEY,
|
||||
name VARCHAR(200) NOT NULL,
|
||||
slug VARCHAR(200) UNIQUE,
|
||||
content JSONB NOT NULL,
|
||||
summary TEXT,
|
||||
category VARCHAR(100),
|
||||
board_id INTEGER REFERENCES boards(id),
|
||||
created_by INTEGER REFERENCES users(id),
|
||||
updated_by INTEGER REFERENCES users(id),
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||
);
|
||||
```
|
||||
|
||||
### Wiki Entity Links Table
|
||||
```sql
|
||||
CREATE TABLE wiki_entity_links (
|
||||
wiki_id INTEGER REFERENCES wikis(id) ON DELETE CASCADE,
|
||||
entity_type VARCHAR(50) NOT NULL,
|
||||
entity_id INTEGER NOT NULL,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
linked_by INTEGER REFERENCES users(id),
|
||||
PRIMARY KEY (wiki_id, entity_type, entity_id)
|
||||
);
|
||||
```
|
||||
|
||||
## API Endpoints (To Be Implemented)
|
||||
|
||||
### Epic Endpoints
|
||||
```
|
||||
GET /api/boards/<board_id>/epics
|
||||
POST /api/boards/<board_id>/epics
|
||||
GET /api/epics/<epic_id>
|
||||
PUT /api/epics/<epic_id>
|
||||
DELETE /api/epics/<epic_id>
|
||||
```
|
||||
|
||||
### Epic-Card Linking
|
||||
```
|
||||
POST /api/cards/<card_id>/epics
|
||||
DELETE /api/cards/<card_id>/epics/<epic_id>
|
||||
```
|
||||
|
||||
### Wiki Endpoints
|
||||
```
|
||||
GET /api/boards/<board_id>/wikis
|
||||
POST /api/boards/<board_id>/wikis
|
||||
GET /api/wikis/<wiki_id>
|
||||
PUT /api/wikis/<wiki_id>
|
||||
DELETE /api/wikis/<wiki_id>
|
||||
GET /api/wikis/<wiki_id>/content
|
||||
```
|
||||
|
||||
### Wiki-Entity Linking
|
||||
```
|
||||
POST /api/wikis/<wiki_id>/links
|
||||
DELETE /api/wikis/<wiki_id>/links/<entity_type>/<entity_id>
|
||||
```
|
||||
|
||||
## Testing Considerations
|
||||
|
||||
### Unit Tests
|
||||
- Epic model creation and relationships
|
||||
- Wiki model creation and relationships
|
||||
- Epic hierarchy validation
|
||||
- Wiki slug generation
|
||||
- Rich text content serialization
|
||||
|
||||
### Integration Tests
|
||||
- Epic CRUD operations
|
||||
- Wiki CRUD operations
|
||||
- Epic-Card linking
|
||||
- Wiki-Entity linking
|
||||
- Epic hierarchy operations
|
||||
|
||||
### Frontend Tests
|
||||
- RichTextEditor component
|
||||
- RichTextContent component
|
||||
- useEpics hook
|
||||
- Epic list rendering
|
||||
- Epic creation form
|
||||
|
||||
## Notes
|
||||
|
||||
- **Slate.js Content**: Content is stored as raw Slate.js JSON format, which includes element types, text nodes, and formatting information
|
||||
- **Hierarchical Epics**: While supported, UI for nesting epics is not yet implemented
|
||||
- **Wiki Slugs**: Slugs should be auto-generated from wiki names and checked for uniqueness
|
||||
- **Color Codes**: Epic colors should be valid hex codes (e.g., "#ef4444")
|
||||
- **Position**: Epic positions use float values for flexible reordering (similar to Trello)
|
||||
|
||||
## Related Files
|
||||
|
||||
### Backend
|
||||
- `backend/app/models/epic.py` - Epic model
|
||||
- `backend/app/models/wiki.py` - Wiki model
|
||||
- `backend/app/models/card.py` - Updated Card model
|
||||
- `backend/app/models/__init__.py` - Model imports
|
||||
- `backend/migrations/versions/6fc439155ced_add_epic_and_wiki_models.py` - Migration
|
||||
|
||||
### Frontend
|
||||
- `frontend/src/types/epic.ts` - TypeScript interfaces
|
||||
- `frontend/src/components/RichTextEditor.tsx` - Editor component
|
||||
- `frontend/src/components/RichTextContent.tsx` - Content renderer
|
||||
- `frontend/src/hooks/useEpics.ts` - Epic custom hook
|
||||
- `frontend/src/hooks/useApi.ts` - Updated API methods
|
||||
238
EPIC_WIKI_MODELS_SUMMARY.md
Normal file
238
EPIC_WIKI_MODELS_SUMMARY.md
Normal file
|
|
@ -0,0 +1,238 @@
|
|||
# Epic and Wiki Models - Implementation Summary
|
||||
|
||||
## Overview
|
||||
This document summarizes the implementation of Epic and Wiki models for the Kanban application.
|
||||
|
||||
## What Was Implemented
|
||||
|
||||
### 1. Epic Model (`backend/app/models/epic.py`)
|
||||
- Tracks large features across multiple cards
|
||||
- Hierarchical structure (parent-child epics)
|
||||
- Rich text content support (Slate.js JSON)
|
||||
- Color-coded badges for visual identification
|
||||
- Metrics tracking (card count)
|
||||
|
||||
**Key Fields:**
|
||||
- `id`, `name`, `description`, `content` (JSONB)
|
||||
- `color` (hex code for epic badge)
|
||||
- `closed`, `pos`, `depth_limit` (default 5)
|
||||
- `board_id`, `parent_epic_id`
|
||||
- `date_last_activity`, `created_at`, `updated_at`
|
||||
- `metrics` (JSONB - stores card_count)
|
||||
|
||||
**Relationships:**
|
||||
- Board: One-to-many (Board has many Epics)
|
||||
- Cards: One-to-many (Epic has many Cards)
|
||||
- Parent Epic: Self-referential (hierarchical)
|
||||
- File Attachments: Polymorphic (like Cards)
|
||||
|
||||
### 2. Wiki Model (`backend/app/models/wiki.py`)
|
||||
- Reusable rich text content within a board
|
||||
- Board-scoped (not global across all boards)
|
||||
- Polymorphic links to entities (Card, Epic, etc.)
|
||||
- Categorization and tagging support
|
||||
|
||||
**Key Fields:**
|
||||
- `id`, `name`, `slug` (URL-friendly)
|
||||
- `content` (JSONB - rich text)
|
||||
- `summary`, `category`, `tags` (JSONB)
|
||||
- `board_id`, `created_by`, `updated_by`
|
||||
- `created_at`, `updated_at`
|
||||
|
||||
**Relationships:**
|
||||
- Board: One-to-many (Board has many Wikis)
|
||||
- Entities: Many-to-many polymorphic (via wiki_entity_links)
|
||||
|
||||
### 3. Card Model Updates (`backend/app/models/card.py`)
|
||||
- Added `epic_id` foreign key (nullable)
|
||||
- Updated `to_dict()` to include `epic_id`
|
||||
- One-to-one relationship: Card belongs to one Epic
|
||||
|
||||
### 4. Association Table (`wiki_entity_links`)
|
||||
- Polymorphic many-to-many table
|
||||
- Links wikis to any entity type
|
||||
- Fields: `wiki_id`, `entity_type`, `entity_id`, `created_at`, `linked_by`
|
||||
|
||||
## Database Schema
|
||||
|
||||
### New Tables
|
||||
1. **epics** - Epic records
|
||||
2. **wikis** - Wiki content records
|
||||
3. **wiki_entity_links** - Wiki-to-entity associations
|
||||
|
||||
### Modified Tables
|
||||
1. **cards** - Added `epic_id` foreign key
|
||||
|
||||
### Relationships Diagram
|
||||
```
|
||||
Board (1) ----< (N) Epic
|
||||
Epic (1) ----< (N) Card (each card belongs to one epic)
|
||||
Epic (1) ----< (N) Epic (parent-child hierarchy)
|
||||
|
||||
Board (1) ----< (N) Wiki
|
||||
Wiki (M) ----> (M) Entity (polymorphic: Card, Epic)
|
||||
```
|
||||
|
||||
## Database Migration
|
||||
|
||||
**File:** `backend/migrations/versions/add_epic_and_wiki_models.py`
|
||||
|
||||
**Creates:**
|
||||
- `epics` table with indexes on `board_id`, `closed`, `name`
|
||||
- `wikis` table with indexes on `board_id`, `name`, `slug`
|
||||
- `wiki_entity_links` table with composite primary key
|
||||
- `epic_id` column in `cards` table with index and foreign key
|
||||
|
||||
**To apply migration:**
|
||||
```bash
|
||||
cd backend
|
||||
flask db upgrade
|
||||
```
|
||||
|
||||
**To rollback:**
|
||||
```bash
|
||||
flask db downgrade
|
||||
```
|
||||
|
||||
## Model Exports
|
||||
|
||||
Updated `backend/app/models/__init__.py` to include:
|
||||
- `from app.models.epic import Epic`
|
||||
- `from app.models.wiki import Wiki`
|
||||
|
||||
Added to `__all__` list: `"Epic"`, `"Wiki"`
|
||||
|
||||
## Design Decisions
|
||||
|
||||
### Why "Wiki" instead of "Document"?
|
||||
- Avoids confusion with file attachments
|
||||
- Emphasizes reusable knowledge content
|
||||
- Better semantic meaning for rich text resources
|
||||
|
||||
### One-to-Many Epic-Card Relationship
|
||||
- Simpler, clearer ownership
|
||||
- Each card belongs to one epic
|
||||
- Easier to query and display
|
||||
|
||||
### Board-Scoped Wikis
|
||||
- Wikis belong to a specific board
|
||||
- Not global across all boards
|
||||
- Better organization and access control
|
||||
|
||||
### Epic Hierarchy Depth
|
||||
- Default depth limit: 5 levels
|
||||
- Configurable per epic
|
||||
- Backend should enforce when creating child epics
|
||||
|
||||
### Simplified Metrics
|
||||
- Currently only tracks `card_count`
|
||||
- Stored in JSONB field: `{"card_count": 10}`
|
||||
- Easy to extend with more metrics later
|
||||
|
||||
## Next Steps
|
||||
|
||||
### Backend Implementation
|
||||
1. ✅ Create models - **DONE**
|
||||
2. ✅ Create database migration - **DONE**
|
||||
3. ⏭️ Create schemas for serialization
|
||||
4. ⏭️ Create API routes (CRUD operations)
|
||||
5. ⏭️ Create services for business logic
|
||||
6. ⏭️ Add validation for epic depth limit
|
||||
7. ⏭️ Update epic metrics when cards change
|
||||
8. ⏭️ Write tests for models and routes
|
||||
|
||||
### Frontend Implementation
|
||||
1. ⏭️ Update TypeScript types
|
||||
2. ⏭️ Create Epic page/component
|
||||
3. ⏭️ Create Wiki page/component
|
||||
4. ⏭️ Add epic dropdown to card detail
|
||||
5. ⏭️ Create epic list on board detail
|
||||
6. ⏭️ Implement rich text editor (Slate.js)
|
||||
7. ⏭️ Add wiki linking UI
|
||||
|
||||
### API Endpoints (Future)
|
||||
|
||||
#### Epic Endpoints
|
||||
```
|
||||
GET /api/boards/{board_id}/epics # List all epics for board
|
||||
POST /api/boards/{board_id}/epics # Create epic
|
||||
GET /api/epics/{epic_id} # Get epic details with cards
|
||||
PUT /api/epics/{epic_id} # Update epic
|
||||
DELETE /api/epics/{epic_id} # Delete epic
|
||||
POST /api/epics/{epic_id}/cards # Create card directly in epic
|
||||
GET /api/epics/{epic_id}/tree # Get epic hierarchy tree
|
||||
```
|
||||
|
||||
#### Wiki Endpoints
|
||||
```
|
||||
GET /api/boards/{board_id}/wikis # List all wikis for board
|
||||
POST /api/boards/{board_id}/wikis # Create wiki
|
||||
GET /api/wikis/{wiki_id} # Get wiki details
|
||||
PUT /api/wikis/{wiki_id} # Update wiki
|
||||
DELETE /api/wikis/{wiki_id} # Delete wiki
|
||||
POST /api/wikis/{wiki_id}/links # Link wiki to entity
|
||||
DELETE /api/wikis/{wiki_id}/links/{link_id} # Unlink from entity
|
||||
GET /api/{entity_type}/{entity_id}/wikis # Get wikis for entity
|
||||
```
|
||||
|
||||
#### Card Endpoints (Updated)
|
||||
```
|
||||
PUT /api/cards/{card_id}/epic # Link card to epic (or null to unlink)
|
||||
GET /api/cards/{card_id}/epic # Get card's epic
|
||||
```
|
||||
|
||||
## Files Created/Modified
|
||||
|
||||
### Created
|
||||
- `backend/app/models/epic.py`
|
||||
- `backend/app/models/wiki.py`
|
||||
- `backend/migrations/versions/add_epic_and_wiki_models.py`
|
||||
|
||||
### Modified
|
||||
- `backend/app/models/card.py` (added epic_id)
|
||||
- `backend/app/models/__init__.py` (added Epic, Wiki imports)
|
||||
|
||||
## Testing the Implementation
|
||||
|
||||
1. **Apply migration:**
|
||||
```bash
|
||||
cd backend
|
||||
source venv/bin/activate
|
||||
flask db upgrade
|
||||
```
|
||||
|
||||
2. **Verify tables created:**
|
||||
```bash
|
||||
flask dbcurrent
|
||||
# Should show: add_epic_and_wiki_models
|
||||
```
|
||||
|
||||
3. **Test in Python shell:**
|
||||
```python
|
||||
from app import create_app, db
|
||||
from app.models import Epic, Wiki, Card, Board
|
||||
|
||||
app = create_app()
|
||||
with app.app_context():
|
||||
# Create an epic
|
||||
epic = Epic(name="My Epic", board_id=1, color="#3b82f6")
|
||||
db.session.add(epic)
|
||||
db.session.commit()
|
||||
|
||||
# Create a wiki
|
||||
wiki = Wiki(name="Security Guide", board_id=1, content={})
|
||||
db.session.add(wiki)
|
||||
db.session.commit()
|
||||
|
||||
print(f"Epic created: {epic.to_dict()}")
|
||||
print(f"Wiki created: {wiki.to_dict()}")
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- All models follow the existing project patterns
|
||||
- Uses `db` from `app` module (not `flask_sqlalchemy` directly)
|
||||
- Proper foreign key constraints with CASCADE/SET NULL
|
||||
- Timestamps use UTC timezone
|
||||
- JSONB fields for flexible data storage
|
||||
- Indexed for optimal query performance
|
||||
|
|
@ -4,12 +4,14 @@ from app.models.card_label import CardLabel
|
|||
from app.models.check_item import CheckItem
|
||||
from app.models.checklist import Checklist
|
||||
from app.models.comment import Comment
|
||||
from app.models.epic import Epic
|
||||
from app.models.file_attachment import FileAttachment
|
||||
from app.models.label import Label
|
||||
from app.models.list_model import List
|
||||
from app.models.order import Order, OrderItem
|
||||
from app.models.product import Product
|
||||
from app.models.user import User
|
||||
from app.models.wiki import Wiki
|
||||
|
||||
__all__ = [
|
||||
"User",
|
||||
|
|
@ -25,4 +27,6 @@ __all__ = [
|
|||
"CheckItem",
|
||||
"Comment",
|
||||
"FileAttachment",
|
||||
"Epic",
|
||||
"Wiki",
|
||||
]
|
||||
|
|
|
|||
|
|
@ -32,6 +32,9 @@ class Card(db.Model):
|
|||
nullable=False,
|
||||
index=True,
|
||||
)
|
||||
epic_id = db.Column(
|
||||
db.Integer, db.ForeignKey("epics.id", ondelete="SET NULL"), index=True
|
||||
)
|
||||
|
||||
# Timestamps
|
||||
date_last_activity = db.Column(db.DateTime)
|
||||
|
|
@ -79,6 +82,7 @@ class Card(db.Model):
|
|||
"id_short": self.id_short,
|
||||
"board_id": self.board_id,
|
||||
"list_id": self.list_id,
|
||||
"epic_id": self.epic_id,
|
||||
"date_last_activity": self.date_last_activity.isoformat()
|
||||
if self.date_last_activity
|
||||
else None,
|
||||
|
|
|
|||
80
backend/app/models/epic.py
Normal file
80
backend/app/models/epic.py
Normal file
|
|
@ -0,0 +1,80 @@
|
|||
from datetime import UTC, datetime
|
||||
|
||||
from sqlalchemy.dialects.postgresql import JSONB
|
||||
|
||||
from app import db
|
||||
|
||||
|
||||
class Epic(db.Model):
|
||||
"""Epic model for tracking large features across multiple cards"""
|
||||
|
||||
__tablename__ = "epics"
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
name = db.Column(db.String(200), nullable=False, index=True)
|
||||
description = db.Column(db.Text)
|
||||
content = db.Column(JSONB) # Rich text content (Slate.js JSON)
|
||||
color = db.Column(db.String(7)) # Hex color for epic badge
|
||||
closed = db.Column(db.Boolean, default=False, index=True)
|
||||
pos = db.Column(db.Float) # Position for sorting in epic list
|
||||
depth_limit = db.Column(db.Integer, default=5) # Max nesting depth
|
||||
|
||||
# Foreign keys
|
||||
board_id = db.Column(
|
||||
db.Integer,
|
||||
db.ForeignKey("boards.id", ondelete="CASCADE"),
|
||||
nullable=False,
|
||||
index=True,
|
||||
)
|
||||
parent_epic_id = db.Column(
|
||||
db.Integer, db.ForeignKey("epics.id", ondelete="SET NULL")
|
||||
)
|
||||
|
||||
# Timestamps
|
||||
date_last_activity = db.Column(db.DateTime)
|
||||
created_at = db.Column(db.DateTime, default=lambda: datetime.now(UTC))
|
||||
updated_at = db.Column(
|
||||
db.DateTime,
|
||||
default=lambda: datetime.now(UTC),
|
||||
onupdate=lambda: datetime.now(UTC),
|
||||
)
|
||||
|
||||
# JSON fields for metrics
|
||||
metrics = db.Column(JSONB) # {"card_count": 10}
|
||||
|
||||
# Relationships
|
||||
board = db.relationship("Board", backref="epics")
|
||||
parent_epic = db.relationship("Epic", remote_side=[id], backref="child_epics")
|
||||
cards = db.relationship("Card", backref="epic", cascade="all, delete-orphan")
|
||||
attachments = db.relationship(
|
||||
"FileAttachment",
|
||||
foreign_keys="FileAttachment.attachable_id",
|
||||
primaryjoin="""and_(FileAttachment.attachable_id == Epic.id,
|
||||
FileAttachment.attachable_type == 'Epic')""",
|
||||
cascade="all, delete-orphan",
|
||||
lazy="dynamic",
|
||||
)
|
||||
|
||||
def to_dict(self):
|
||||
"""Convert epic to dictionary"""
|
||||
return {
|
||||
"id": self.id,
|
||||
"name": self.name,
|
||||
"description": self.description,
|
||||
"content": self.content,
|
||||
"color": self.color,
|
||||
"closed": self.closed,
|
||||
"pos": self.pos,
|
||||
"depth_limit": self.depth_limit,
|
||||
"board_id": self.board_id,
|
||||
"parent_epic_id": self.parent_epic_id,
|
||||
"date_last_activity": self.date_last_activity.isoformat()
|
||||
if self.date_last_activity
|
||||
else None,
|
||||
"created_at": self.created_at.isoformat() if self.created_at else None,
|
||||
"updated_at": self.updated_at.isoformat() if self.updated_at else None,
|
||||
"metrics": self.metrics or {"card_count": 0},
|
||||
}
|
||||
|
||||
def __repr__(self):
|
||||
return f"<Epic {self.name}>"
|
||||
88
backend/app/models/wiki.py
Normal file
88
backend/app/models/wiki.py
Normal file
|
|
@ -0,0 +1,88 @@
|
|||
from datetime import UTC, datetime
|
||||
|
||||
from sqlalchemy.dialects.postgresql import JSONB
|
||||
|
||||
from app import db
|
||||
|
||||
wiki_entity_links = db.Table(
|
||||
"wiki_entity_links",
|
||||
db.Column(
|
||||
"wiki_id",
|
||||
db.Integer,
|
||||
db.ForeignKey("wikis.id", ondelete="CASCADE"),
|
||||
primary_key=True,
|
||||
),
|
||||
db.Column("entity_type", db.String(50), nullable=False), # 'Card', 'Epic'
|
||||
db.Column("entity_id", db.Integer, nullable=False), # ID of the linked entity
|
||||
db.Column("created_at", db.DateTime, default=lambda: datetime.now(UTC)),
|
||||
db.Column("linked_by", db.Integer, db.ForeignKey("users.id", ondelete="SET NULL")),
|
||||
)
|
||||
|
||||
|
||||
class Wiki(db.Model):
|
||||
"""Wiki model for reusable rich text content within a board"""
|
||||
|
||||
__tablename__ = "wikis"
|
||||
|
||||
id = db.Column(db.Integer, primary_key=True)
|
||||
name = db.Column(db.String(200), nullable=False, index=True)
|
||||
slug = db.Column(db.String(255), index=True) # URL-friendly identifier
|
||||
content = db.Column(JSONB, nullable=False) # Rich text content (Slate.js JSON)
|
||||
summary = db.Column(db.Text) # Brief description/abstract
|
||||
category = db.Column(db.String(100)) # Optional categorization
|
||||
|
||||
# Foreign keys
|
||||
board_id = db.Column(
|
||||
db.Integer,
|
||||
db.ForeignKey("boards.id", ondelete="CASCADE"),
|
||||
nullable=False,
|
||||
index=True,
|
||||
)
|
||||
created_by = db.Column(
|
||||
db.Integer,
|
||||
db.ForeignKey("users.id", ondelete="SET NULL"),
|
||||
)
|
||||
updated_by = db.Column(
|
||||
db.Integer,
|
||||
db.ForeignKey("users.id", ondelete="SET NULL"),
|
||||
)
|
||||
|
||||
# Timestamps
|
||||
created_at = db.Column(db.DateTime, default=lambda: datetime.now(UTC))
|
||||
updated_at = db.Column(
|
||||
db.DateTime,
|
||||
default=lambda: datetime.now(UTC),
|
||||
onupdate=lambda: datetime.now(UTC),
|
||||
)
|
||||
|
||||
# JSON fields
|
||||
tags = db.Column(JSONB) # List of tags for organization: ["security", "api"]
|
||||
|
||||
# Relationships
|
||||
board = db.relationship("Board", backref="wikis")
|
||||
creator = db.relationship(
|
||||
"User", foreign_keys=[created_by], backref="created_wikis"
|
||||
)
|
||||
updater = db.relationship(
|
||||
"User", foreign_keys=[updated_by], backref="updated_wikis"
|
||||
)
|
||||
|
||||
def to_dict(self):
|
||||
"""Convert wiki to dictionary"""
|
||||
return {
|
||||
"id": self.id,
|
||||
"name": self.name,
|
||||
"slug": self.slug,
|
||||
"content": self.content,
|
||||
"summary": self.summary,
|
||||
"category": self.category,
|
||||
"board_id": self.board_id,
|
||||
"tags": self.tags or [],
|
||||
"created_by": self.created_by,
|
||||
"updated_by": self.updated_by,
|
||||
"created_at": self.created_at.isoformat() if self.created_at else None,
|
||||
"updated_at": self.updated_at.isoformat() if self.updated_at else None,
|
||||
}
|
||||
|
||||
def __repr__(self):
|
||||
return f"<Wiki {self.name}>"
|
||||
|
|
@ -6,8 +6,8 @@ kanban_bp = Blueprint("kanban", __name__)
|
|||
# Import all route modules to register their routes to this blueprint
|
||||
|
||||
# fmt: off
|
||||
from . import (boards, cards, checklists, comments, files, # noqa: F401 E402
|
||||
labels, lists)
|
||||
from . import (boards, cards, checklists, comments, epics, # noqa: F401 E402
|
||||
files, labels, lists, wikis)
|
||||
|
||||
# fmt: on
|
||||
|
||||
|
|
|
|||
158
backend/app/routes/kanban/epics.py
Normal file
158
backend/app/routes/kanban/epics.py
Normal file
|
|
@ -0,0 +1,158 @@
|
|||
"""Routes for Epic CRUD operations."""
|
||||
|
||||
from flask import request
|
||||
from flask_jwt_extended import jwt_required
|
||||
from flask_pydantic import validate
|
||||
|
||||
from app import db
|
||||
from app.models import Board, Card, Epic
|
||||
from app.schemas import EpicCreateRequest, EpicResponse, EpicUpdateRequest
|
||||
|
||||
from . import kanban_bp
|
||||
|
||||
|
||||
@kanban_bp.route("/boards/<int:board_id>/epics", methods=["GET"])
|
||||
@jwt_required()
|
||||
def get_board_epics(board_id):
|
||||
"""Get all epics for a board."""
|
||||
board = db.session.get(Board, board_id)
|
||||
if not board:
|
||||
return {"error": "Board not found"}, 404
|
||||
|
||||
epics = Epic.query.filter_by(board_id=board_id).all()
|
||||
return [EpicResponse.model_validate(epic).model_dump() for epic in epics], 200
|
||||
|
||||
|
||||
@kanban_bp.route("/boards/<int:board_id>/epics", methods=["POST"])
|
||||
@jwt_required()
|
||||
@validate(body=EpicCreateRequest)
|
||||
def create_epic(board_id, body: EpicCreateRequest):
|
||||
"""Create a new epic for a board."""
|
||||
board = db.session.get(Board, board_id)
|
||||
if not board:
|
||||
return {"error": "Board not found"}, 404
|
||||
|
||||
epic = Epic(
|
||||
board_id=board_id,
|
||||
name=body.name,
|
||||
description=body.description,
|
||||
content=body.content,
|
||||
color=body.color,
|
||||
closed=False,
|
||||
pos=body.pos,
|
||||
depth_limit=body.depth_limit,
|
||||
parent_epic_id=body.parent_epic_id,
|
||||
metrics={"card_count": 0, "progress": 0},
|
||||
)
|
||||
|
||||
db.session.add(epic)
|
||||
db.session.commit()
|
||||
|
||||
return EpicResponse.model_validate(epic).model_dump(), 201
|
||||
|
||||
|
||||
@kanban_bp.route("/epics/<int:epic_id>", methods=["GET"])
|
||||
@jwt_required()
|
||||
def get_epic(epic_id):
|
||||
"""Get a specific epic with details."""
|
||||
epic = db.session.get(Epic, epic_id)
|
||||
if not epic:
|
||||
return {"error": "Epic not found"}, 404
|
||||
|
||||
# Get cards for this epic
|
||||
cards = Card.query.filter_by(epic_id=epic_id).all()
|
||||
epic_dict = EpicResponse.model_validate(epic).model_dump()
|
||||
epic_dict["cards"] = [card.to_dict() for card in cards]
|
||||
|
||||
return epic_dict, 200
|
||||
|
||||
|
||||
@kanban_bp.route("/epics/<int:epic_id>", methods=["PUT"])
|
||||
@jwt_required()
|
||||
@validate(body=EpicUpdateRequest)
|
||||
def update_epic(epic_id, body: EpicUpdateRequest):
|
||||
"""Update an epic."""
|
||||
epic = db.session.get(Epic, epic_id)
|
||||
if not epic:
|
||||
return {"error": "Epic not found"}, 404
|
||||
|
||||
# Update fields
|
||||
if body.name is not None:
|
||||
epic.name = body.name
|
||||
if body.description is not None:
|
||||
epic.description = body.description
|
||||
if body.content is not None:
|
||||
epic.content = body.content
|
||||
if body.color is not None:
|
||||
epic.color = body.color
|
||||
if body.closed is not None:
|
||||
epic.closed = body.closed
|
||||
if body.pos is not None:
|
||||
epic.pos = body.pos
|
||||
if body.depth_limit is not None:
|
||||
epic.depth_limit = body.depth_limit
|
||||
if body.parent_epic_id is not None:
|
||||
epic.parent_epic_id = body.parent_epic_id
|
||||
|
||||
db.session.commit()
|
||||
|
||||
return EpicResponse.model_validate(epic).model_dump(), 200
|
||||
|
||||
|
||||
@kanban_bp.route("/epics/<int:epic_id>", methods=["DELETE"])
|
||||
@jwt_required()
|
||||
def delete_epic(epic_id):
|
||||
"""Delete an epic."""
|
||||
epic = db.session.get(Epic, epic_id)
|
||||
if not epic:
|
||||
return {"error": "Epic not found"}, 404
|
||||
|
||||
# Unlink all cards from this epic
|
||||
Card.query.filter_by(epic_id=epic_id).update({"epic_id": None})
|
||||
|
||||
# Delete epic
|
||||
db.session.delete(epic)
|
||||
db.session.commit()
|
||||
|
||||
return {"message": "Epic deleted successfully"}, 200
|
||||
|
||||
|
||||
@kanban_bp.route("/cards/<int:card_id>/epics", methods=["POST"])
|
||||
@jwt_required()
|
||||
def add_epic_to_card(card_id):
|
||||
"""Link an epic to a card."""
|
||||
card = db.session.get(Card, card_id)
|
||||
if not card:
|
||||
return {"error": "Card not found"}, 404
|
||||
|
||||
data = request.get_json()
|
||||
epic_id = data.get("epic_id")
|
||||
|
||||
if not epic_id:
|
||||
return {"error": "epic_id is required"}, 400
|
||||
|
||||
epic = db.session.get(Epic, epic_id)
|
||||
if not epic:
|
||||
return {"error": "Epic not found"}, 404
|
||||
|
||||
card.epic_id = epic_id
|
||||
db.session.commit()
|
||||
|
||||
return card.to_dict(), 200
|
||||
|
||||
|
||||
@kanban_bp.route("/cards/<int:card_id>/epics/<int:epic_id>", methods=["DELETE"])
|
||||
@jwt_required()
|
||||
def remove_epic_from_card(card_id, epic_id):
|
||||
"""Unlink an epic from a card."""
|
||||
card = db.session.get(Card, card_id)
|
||||
if not card:
|
||||
return {"error": "Card not found"}, 404
|
||||
|
||||
if card.epic_id != epic_id:
|
||||
return {"error": "Card is not linked to this epic"}, 400
|
||||
|
||||
card.epic_id = None
|
||||
db.session.commit()
|
||||
|
||||
return {"message": "Epic unlinked from card successfully"}, 200
|
||||
127
backend/app/routes/kanban/wikis.py
Normal file
127
backend/app/routes/kanban/wikis.py
Normal file
|
|
@ -0,0 +1,127 @@
|
|||
"""Routes for Wiki CRUD operations."""
|
||||
|
||||
import re
|
||||
|
||||
from flask_jwt_extended import get_jwt_identity, jwt_required
|
||||
from flask_pydantic import validate
|
||||
|
||||
from app import db
|
||||
from app.models import Board, Wiki
|
||||
from app.schemas import WikiCreateRequest, WikiResponse, WikiUpdateRequest
|
||||
|
||||
from . import kanban_bp
|
||||
|
||||
|
||||
def generate_slug(name):
|
||||
"""Generate URL-friendly slug from name."""
|
||||
slug = name.lower()
|
||||
slug = re.sub(r"[^a-z0-9\s-]", "", slug)
|
||||
slug = re.sub(r"\s+", "-", slug)
|
||||
slug = slug.strip("-")
|
||||
return slug
|
||||
|
||||
|
||||
@kanban_bp.route("/boards/<int:board_id>/wikis", methods=["GET"])
|
||||
@jwt_required()
|
||||
def get_board_wikis(board_id):
|
||||
"""Get all wikis for a board."""
|
||||
board = db.session.get(Board, board_id)
|
||||
if not board:
|
||||
return {"error": "Board not found"}, 404
|
||||
|
||||
wikis = Wiki.query.filter_by(board_id=board_id).all()
|
||||
return [WikiResponse.model_validate(wiki).model_dump() for wiki in wikis], 200
|
||||
|
||||
|
||||
@kanban_bp.route("/boards/<int:board_id>/wikis", methods=["POST"])
|
||||
@jwt_required()
|
||||
@validate(body=WikiCreateRequest)
|
||||
def create_wiki(board_id, body: WikiCreateRequest):
|
||||
"""Create a new wiki for a board."""
|
||||
board = db.session.get(Board, board_id)
|
||||
if not board:
|
||||
return {"error": "Board not found"}, 404
|
||||
|
||||
# Generate slug if not provided
|
||||
slug = body.slug
|
||||
if not slug:
|
||||
slug = generate_slug(body.name)
|
||||
|
||||
# Ensure uniqueness
|
||||
counter = 1
|
||||
original_slug = slug
|
||||
while Wiki.query.filter_by(slug=slug).first():
|
||||
slug = f"{original_slug}-{counter}"
|
||||
counter += 1
|
||||
|
||||
wiki = Wiki(
|
||||
board_id=board_id,
|
||||
name=body.name,
|
||||
slug=slug,
|
||||
content=body.content,
|
||||
summary=body.summary,
|
||||
category=body.category,
|
||||
tags=body.tags,
|
||||
created_by=get_jwt_identity(),
|
||||
updated_by=get_jwt_identity(),
|
||||
)
|
||||
|
||||
db.session.add(wiki)
|
||||
db.session.commit()
|
||||
|
||||
return WikiResponse.model_validate(wiki).model_dump(), 201
|
||||
|
||||
|
||||
@kanban_bp.route("/wikis/<int:wiki_id>", methods=["GET"])
|
||||
@jwt_required()
|
||||
def get_wiki(wiki_id):
|
||||
"""Get a specific wiki with details."""
|
||||
wiki = db.session.get(Wiki, wiki_id)
|
||||
if not wiki:
|
||||
return {"error": "Wiki not found"}, 404
|
||||
|
||||
return WikiResponse.model_validate(wiki).model_dump(), 200
|
||||
|
||||
|
||||
@kanban_bp.route("/wikis/<int:wiki_id>", methods=["PUT"])
|
||||
@jwt_required()
|
||||
@validate(body=WikiUpdateRequest)
|
||||
def update_wiki(wiki_id, body: WikiUpdateRequest):
|
||||
"""Update a wiki."""
|
||||
wiki = db.session.get(Wiki, wiki_id)
|
||||
if not wiki:
|
||||
return {"error": "Wiki not found"}, 404
|
||||
|
||||
# Update fields
|
||||
if body.name is not None:
|
||||
wiki.name = body.name
|
||||
if body.slug is not None:
|
||||
wiki.slug = body.slug
|
||||
if body.content is not None:
|
||||
wiki.content = body.content
|
||||
if body.summary is not None:
|
||||
wiki.summary = body.summary
|
||||
if body.category is not None:
|
||||
wiki.category = body.category
|
||||
if body.tags is not None:
|
||||
wiki.tags = body.tags
|
||||
|
||||
wiki.updated_by = get_jwt_identity()
|
||||
db.session.commit()
|
||||
|
||||
return WikiResponse.model_validate(wiki).model_dump(), 200
|
||||
|
||||
|
||||
@kanban_bp.route("/wikis/<int:wiki_id>", methods=["DELETE"])
|
||||
@jwt_required()
|
||||
def delete_wiki(wiki_id):
|
||||
"""Delete a wiki."""
|
||||
wiki = db.session.get(Wiki, wiki_id)
|
||||
if not wiki:
|
||||
return {"error": "Wiki not found"}, 404
|
||||
|
||||
# Delete wiki (cascades to wiki_entity_links)
|
||||
db.session.delete(wiki)
|
||||
db.session.commit()
|
||||
|
||||
return {"message": "Wiki deleted successfully"}, 200
|
||||
|
|
@ -7,6 +7,8 @@ from app.schemas.check_item import CheckItemCreateRequest, CheckItemResponse
|
|||
from app.schemas.checklist import ChecklistCreateRequest, ChecklistResponse
|
||||
from app.schemas.comment import (CommentCreateRequest, CommentResponse,
|
||||
CommentWithUserResponse)
|
||||
from app.schemas.epic import (EpicCreateRequest, EpicResponse,
|
||||
EpicUpdateRequest, EpicWithCardsResponse)
|
||||
from app.schemas.file_attachment import (FileAttachmentWithUrlResponse,
|
||||
FileDeleteResponse, FileUploadRequest,
|
||||
MultipleFilesResponse,
|
||||
|
|
@ -14,6 +16,8 @@ from app.schemas.file_attachment import (FileAttachmentWithUrlResponse,
|
|||
from app.schemas.label import LabelCreateRequest, LabelResponse
|
||||
from app.schemas.list_model import ListCreateRequest, ListResponse
|
||||
from app.schemas.product import ProductCreateRequest, ProductResponse
|
||||
from app.schemas.wiki import (WikiCreateRequest, WikiEntityLink,
|
||||
WikiLinkRequest, WikiResponse, WikiUpdateRequest)
|
||||
|
||||
__all__ = [
|
||||
# Product schemas
|
||||
|
|
@ -50,4 +54,15 @@ __all__ = [
|
|||
"BoardWithDetailsResponse",
|
||||
"CardWithDetailsResponse",
|
||||
"CommentWithUserResponse",
|
||||
# Epic schemas
|
||||
"EpicCreateRequest",
|
||||
"EpicResponse",
|
||||
"EpicUpdateRequest",
|
||||
"EpicWithCardsResponse",
|
||||
# Wiki schemas
|
||||
"WikiCreateRequest",
|
||||
"WikiResponse",
|
||||
"WikiUpdateRequest",
|
||||
"WikiEntityLink",
|
||||
"WikiLinkRequest",
|
||||
]
|
||||
|
|
|
|||
132
backend/app/schemas/epic.py
Normal file
132
backend/app/schemas/epic.py
Normal file
|
|
@ -0,0 +1,132 @@
|
|||
"""Pydantic schemas for Epic model"""
|
||||
from datetime import datetime
|
||||
from typing import Any, Dict, List, Optional
|
||||
|
||||
from pydantic import BaseModel, ConfigDict, Field
|
||||
|
||||
|
||||
class EpicCreateRequest(BaseModel):
|
||||
"""Schema for creating a new epic"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"name": "User Authentication",
|
||||
"description": "Implement login and registration",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Details..."}]}
|
||||
],
|
||||
"color": "#3b82f6",
|
||||
"pos": 1.0,
|
||||
"depth_limit": 5,
|
||||
"parent_epic_id": None,
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
name: str = Field(..., min_length=1, max_length=200, description="Epic name")
|
||||
description: Optional[str] = Field(None, description="Epic description")
|
||||
content: Optional[Any] = Field(None, description="Rich text content")
|
||||
color: Optional[str] = Field(None, max_length=7, description="Hex color code")
|
||||
pos: Optional[float] = Field(None, description="Position for ordering")
|
||||
depth_limit: Optional[int] = Field(
|
||||
None, ge=1, le=10, description="Maximum depth for hierarchy"
|
||||
)
|
||||
parent_epic_id: Optional[int] = Field(
|
||||
None, description="Parent epic ID for nesting"
|
||||
)
|
||||
|
||||
|
||||
class EpicResponse(BaseModel):
|
||||
"""Schema for epic response"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
from_attributes=True,
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"id": 1,
|
||||
"name": "User Authentication",
|
||||
"description": "Implement login and registration",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Details..."}]}
|
||||
],
|
||||
"color": "#3b82f6",
|
||||
"closed": False,
|
||||
"pos": 1.0,
|
||||
"depth_limit": 5,
|
||||
"board_id": 1,
|
||||
"parent_epic_id": None,
|
||||
"metrics": {"card_count": 5, "progress": 60},
|
||||
"date_last_activity": "2024-01-15T10:30:00",
|
||||
"created_at": "2024-01-01T10:00:00",
|
||||
"updated_at": "2024-01-15T10:30:00",
|
||||
}
|
||||
},
|
||||
)
|
||||
|
||||
id: int
|
||||
name: str
|
||||
description: Optional[str] = None
|
||||
content: Optional[Any] = None
|
||||
color: Optional[str] = None
|
||||
closed: bool
|
||||
pos: Optional[float] = None
|
||||
depth_limit: Optional[int] = None
|
||||
board_id: int
|
||||
parent_epic_id: Optional[int] = None
|
||||
metrics: Optional[Dict[str, Any]] = None
|
||||
date_last_activity: Optional[datetime] = None
|
||||
created_at: Optional[datetime] = None
|
||||
updated_at: Optional[datetime] = None
|
||||
|
||||
|
||||
class EpicUpdateRequest(BaseModel):
|
||||
"""Schema for updating an epic"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"name": "Updated Epic Name",
|
||||
"description": "Updated description",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Updated..."}]}
|
||||
],
|
||||
"color": "#ef4444",
|
||||
"closed": True,
|
||||
"pos": 2.0,
|
||||
"depth_limit": 3,
|
||||
"parent_epic_id": 2,
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
name: Optional[str] = Field(None, min_length=1, max_length=200)
|
||||
description: Optional[str] = None
|
||||
content: Optional[Any] = None
|
||||
color: Optional[str] = Field(None, max_length=7)
|
||||
closed: Optional[bool] = None
|
||||
pos: Optional[float] = None
|
||||
depth_limit: Optional[int] = Field(None, ge=1, le=10)
|
||||
parent_epic_id: Optional[int] = None
|
||||
|
||||
|
||||
class EpicWithCardsResponse(BaseModel):
|
||||
"""Schema for epic response with cards"""
|
||||
|
||||
model_config = ConfigDict(from_attributes=True)
|
||||
|
||||
id: int
|
||||
name: str
|
||||
description: Optional[str] = None
|
||||
content: Optional[Any] = None
|
||||
color: Optional[str] = None
|
||||
closed: bool
|
||||
pos: Optional[float] = None
|
||||
depth_limit: Optional[int] = None
|
||||
board_id: int
|
||||
parent_epic_id: Optional[int] = None
|
||||
metrics: Optional[Dict[str, Any]] = None
|
||||
date_last_activity: Optional[datetime] = None
|
||||
created_at: Optional[datetime] = None
|
||||
updated_at: Optional[datetime] = None
|
||||
cards: List[Dict[str, Any]] = Field(default_factory=list)
|
||||
167
backend/app/schemas/wiki.py
Normal file
167
backend/app/schemas/wiki.py
Normal file
|
|
@ -0,0 +1,167 @@
|
|||
"""Pydantic schemas for Wiki model"""
|
||||
from datetime import datetime
|
||||
from typing import Any, List, Optional
|
||||
|
||||
from pydantic import BaseModel, ConfigDict, Field, field_validator
|
||||
|
||||
|
||||
class WikiCreateRequest(BaseModel):
|
||||
"""Schema for creating a new wiki"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"name": "Security Guidelines",
|
||||
"slug": "security-guidelines",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Security rules..."}]}
|
||||
],
|
||||
"summary": "Brief security overview",
|
||||
"category": "Documentation",
|
||||
"tags": ["security", "guidelines"],
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
name: str = Field(..., min_length=1, max_length=200, description="Wiki name")
|
||||
slug: Optional[str] = Field(None, max_length=200, description="URL-friendly slug")
|
||||
content: Any = Field(..., description="Rich text content")
|
||||
summary: Optional[str] = Field(None, description="Brief summary")
|
||||
category: Optional[str] = Field(None, max_length=100, description="Wiki category")
|
||||
tags: Optional[List[str]] = Field(None, description="Wiki tags")
|
||||
|
||||
@field_validator("slug")
|
||||
@classmethod
|
||||
def validate_slug(cls, v):
|
||||
"""Validate slug is URL-friendly."""
|
||||
if v and not v.islower():
|
||||
raise ValueError("Slug must be lowercase")
|
||||
if v and not all(c.isalnum() or c == "-" for c in v):
|
||||
raise ValueError(
|
||||
"Slug must contain only lowercase letters, numbers, and hyphens"
|
||||
)
|
||||
return v
|
||||
|
||||
|
||||
class WikiResponse(BaseModel):
|
||||
"""Schema for wiki response"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
from_attributes=True,
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"id": 1,
|
||||
"name": "Security Guidelines",
|
||||
"slug": "security-guidelines",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Security rules..."}]}
|
||||
],
|
||||
"summary": "Brief security overview",
|
||||
"category": "Documentation",
|
||||
"tags": ["security", "guidelines"],
|
||||
"board_id": 1,
|
||||
"created_by": 1,
|
||||
"updated_by": 1,
|
||||
"created_at": "2024-01-01T10:00:00",
|
||||
"updated_at": "2024-01-15T10:30:00",
|
||||
}
|
||||
},
|
||||
)
|
||||
|
||||
id: int
|
||||
name: str
|
||||
slug: Optional[str] = None
|
||||
content: Any
|
||||
summary: Optional[str] = None
|
||||
category: Optional[str] = None
|
||||
tags: Optional[List[str]] = None
|
||||
board_id: int
|
||||
created_by: Optional[int] = None
|
||||
updated_by: Optional[int] = None
|
||||
created_at: Optional[datetime] = None
|
||||
updated_at: Optional[datetime] = None
|
||||
|
||||
|
||||
class WikiUpdateRequest(BaseModel):
|
||||
"""Schema for updating a wiki"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"name": "Updated Security Guidelines",
|
||||
"slug": "updated-security-guidelines",
|
||||
"content": [
|
||||
{"type": "paragraph", "children": [{"text": "Updated..."}]}
|
||||
],
|
||||
"summary": "Updated summary",
|
||||
"category": "Updated Category",
|
||||
"tags": ["security", "updated"],
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
name: Optional[str] = Field(None, min_length=1, max_length=200)
|
||||
slug: Optional[str] = Field(None, max_length=200)
|
||||
content: Optional[Any] = None
|
||||
summary: Optional[str] = None
|
||||
category: Optional[str] = Field(None, max_length=100)
|
||||
tags: Optional[List[str]] = None
|
||||
|
||||
@field_validator("slug")
|
||||
@classmethod
|
||||
def validate_slug(cls, v):
|
||||
"""Validate slug is URL-friendly."""
|
||||
if v and not v.islower():
|
||||
raise ValueError("Slug must be lowercase")
|
||||
if v and not all(c.isalnum() or c == "-" for c in v):
|
||||
raise ValueError(
|
||||
"Slug must contain only lowercase letters, numbers, and hyphens"
|
||||
)
|
||||
return v
|
||||
|
||||
|
||||
class WikiEntityLink(BaseModel):
|
||||
"""Schema for wiki entity link response"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"wiki_id": 1,
|
||||
"entity_type": "card",
|
||||
"entity_id": 5,
|
||||
"created_at": "2024-01-15T10:30:00",
|
||||
"linked_by": 1,
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
wiki_id: int
|
||||
entity_type: str
|
||||
entity_id: int
|
||||
created_at: Optional[datetime] = None
|
||||
linked_by: Optional[int] = None
|
||||
|
||||
|
||||
class WikiLinkRequest(BaseModel):
|
||||
"""Schema for creating a wiki entity link"""
|
||||
|
||||
model_config = ConfigDict(
|
||||
json_schema_extra={
|
||||
"example": {
|
||||
"entity_type": "card",
|
||||
"entity_id": 5,
|
||||
}
|
||||
}
|
||||
)
|
||||
|
||||
entity_type: str = Field(..., description="Entity type (card, epic, list, board)")
|
||||
entity_id: int = Field(..., description="Entity ID")
|
||||
|
||||
@field_validator("entity_type")
|
||||
@classmethod
|
||||
def validate_entity_type(cls, v):
|
||||
"""Validate entity type is supported."""
|
||||
valid_types = ["card", "epic", "list", "board"]
|
||||
if v not in valid_types:
|
||||
raise ValueError(f"entity_type must be one of: {', '.join(valid_types)}")
|
||||
return v
|
||||
|
|
@ -0,0 +1,106 @@
|
|||
"""add epic and wiki models
|
||||
|
||||
Revision ID: 6fc439155ced
|
||||
Revises: e9515e29ef8b
|
||||
Create Date: 2026-03-22 00:24:26.645867
|
||||
|
||||
"""
|
||||
from alembic import op
|
||||
import sqlalchemy as sa
|
||||
from sqlalchemy.dialects import postgresql
|
||||
|
||||
# revision identifiers, used by Alembic.
|
||||
revision = '6fc439155ced'
|
||||
down_revision = 'e9515e29ef8b'
|
||||
branch_labels = None
|
||||
depends_on = None
|
||||
|
||||
|
||||
def upgrade():
|
||||
# ### commands auto generated by Alembic - please adjust! ###
|
||||
op.create_table('epics',
|
||||
sa.Column('id', sa.Integer(), nullable=False),
|
||||
sa.Column('name', sa.String(length=200), nullable=False),
|
||||
sa.Column('description', sa.Text(), nullable=True),
|
||||
sa.Column('content', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
|
||||
sa.Column('color', sa.String(length=7), nullable=True),
|
||||
sa.Column('closed', sa.Boolean(), nullable=True),
|
||||
sa.Column('pos', sa.Float(), nullable=True),
|
||||
sa.Column('depth_limit', sa.Integer(), nullable=True),
|
||||
sa.Column('board_id', sa.Integer(), nullable=False),
|
||||
sa.Column('parent_epic_id', sa.Integer(), nullable=True),
|
||||
sa.Column('date_last_activity', sa.DateTime(), nullable=True),
|
||||
sa.Column('created_at', sa.DateTime(), nullable=True),
|
||||
sa.Column('updated_at', sa.DateTime(), nullable=True),
|
||||
sa.Column('metrics', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
|
||||
sa.ForeignKeyConstraint(['board_id'], ['boards.id'], ondelete='CASCADE'),
|
||||
sa.ForeignKeyConstraint(['parent_epic_id'], ['epics.id'], ondelete='SET NULL'),
|
||||
sa.PrimaryKeyConstraint('id')
|
||||
)
|
||||
with op.batch_alter_table('epics', schema=None) as batch_op:
|
||||
batch_op.create_index(batch_op.f('ix_epics_board_id'), ['board_id'], unique=False)
|
||||
batch_op.create_index(batch_op.f('ix_epics_closed'), ['closed'], unique=False)
|
||||
batch_op.create_index(batch_op.f('ix_epics_name'), ['name'], unique=False)
|
||||
|
||||
op.create_table('wikis',
|
||||
sa.Column('id', sa.Integer(), nullable=False),
|
||||
sa.Column('name', sa.String(length=200), nullable=False),
|
||||
sa.Column('slug', sa.String(length=255), nullable=True),
|
||||
sa.Column('content', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
|
||||
sa.Column('summary', sa.Text(), nullable=True),
|
||||
sa.Column('category', sa.String(length=100), nullable=True),
|
||||
sa.Column('board_id', sa.Integer(), nullable=False),
|
||||
sa.Column('created_by', sa.Integer(), nullable=True),
|
||||
sa.Column('updated_by', sa.Integer(), nullable=True),
|
||||
sa.Column('created_at', sa.DateTime(), nullable=True),
|
||||
sa.Column('updated_at', sa.DateTime(), nullable=True),
|
||||
sa.Column('tags', postgresql.JSONB(astext_type=sa.Text()), nullable=True),
|
||||
sa.ForeignKeyConstraint(['board_id'], ['boards.id'], ondelete='CASCADE'),
|
||||
sa.ForeignKeyConstraint(['created_by'], ['users.id'], ondelete='SET NULL'),
|
||||
sa.ForeignKeyConstraint(['updated_by'], ['users.id'], ondelete='SET NULL'),
|
||||
sa.PrimaryKeyConstraint('id')
|
||||
)
|
||||
with op.batch_alter_table('wikis', schema=None) as batch_op:
|
||||
batch_op.create_index(batch_op.f('ix_wikis_board_id'), ['board_id'], unique=False)
|
||||
batch_op.create_index(batch_op.f('ix_wikis_name'), ['name'], unique=False)
|
||||
batch_op.create_index(batch_op.f('ix_wikis_slug'), ['slug'], unique=False)
|
||||
|
||||
op.create_table('wiki_entity_links',
|
||||
sa.Column('wiki_id', sa.Integer(), nullable=False),
|
||||
sa.Column('entity_type', sa.String(length=50), nullable=False),
|
||||
sa.Column('entity_id', sa.Integer(), nullable=False),
|
||||
sa.Column('created_at', sa.DateTime(), nullable=True),
|
||||
sa.Column('linked_by', sa.Integer(), nullable=True),
|
||||
sa.ForeignKeyConstraint(['linked_by'], ['users.id'], ondelete='SET NULL'),
|
||||
sa.ForeignKeyConstraint(['wiki_id'], ['wikis.id'], ondelete='CASCADE'),
|
||||
sa.PrimaryKeyConstraint('wiki_id')
|
||||
)
|
||||
with op.batch_alter_table('cards', schema=None) as batch_op:
|
||||
batch_op.add_column(sa.Column('epic_id', sa.Integer(), nullable=True))
|
||||
batch_op.create_index(batch_op.f('ix_cards_epic_id'), ['epic_id'], unique=False)
|
||||
batch_op.create_foreign_key(None, 'epics', ['epic_id'], ['id'], ondelete='SET NULL')
|
||||
|
||||
# ### end Alembic commands ###
|
||||
|
||||
|
||||
def downgrade():
|
||||
# ### commands auto generated by Alembic - please adjust! ###
|
||||
with op.batch_alter_table('cards', schema=None) as batch_op:
|
||||
batch_op.drop_constraint(None, type_='foreignkey')
|
||||
batch_op.drop_index(batch_op.f('ix_cards_epic_id'))
|
||||
batch_op.drop_column('epic_id')
|
||||
|
||||
op.drop_table('wiki_entity_links')
|
||||
with op.batch_alter_table('wikis', schema=None) as batch_op:
|
||||
batch_op.drop_index(batch_op.f('ix_wikis_slug'))
|
||||
batch_op.drop_index(batch_op.f('ix_wikis_name'))
|
||||
batch_op.drop_index(batch_op.f('ix_wikis_board_id'))
|
||||
|
||||
op.drop_table('wikis')
|
||||
with op.batch_alter_table('epics', schema=None) as batch_op:
|
||||
batch_op.drop_index(batch_op.f('ix_epics_name'))
|
||||
batch_op.drop_index(batch_op.f('ix_epics_closed'))
|
||||
batch_op.drop_index(batch_op.f('ix_epics_board_id'))
|
||||
|
||||
op.drop_table('epics')
|
||||
# ### end Alembic commands ###
|
||||
109
frontend/package-lock.json
generated
109
frontend/package-lock.json
generated
|
|
@ -17,6 +17,9 @@
|
|||
"react-dom": "^18.2.0",
|
||||
"react-hook-form": "^7.71.2",
|
||||
"react-router-dom": "^6.20.1",
|
||||
"slate": "^0.123.0",
|
||||
"slate-history": "^0.113.1",
|
||||
"slate-react": "^0.123.0",
|
||||
"zod": "^4.3.6"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
|
@ -1055,6 +1058,11 @@
|
|||
"@jridgewell/sourcemap-codec": "^1.4.14"
|
||||
}
|
||||
},
|
||||
"node_modules/@juggle/resize-observer": {
|
||||
"version": "3.4.0",
|
||||
"resolved": "https://registry.npmjs.org/@juggle/resize-observer/-/resize-observer-3.4.0.tgz",
|
||||
"integrity": "sha512-dfLbk+PwWvFzSxwk3n5ySL0hfBog779o8h68wK/7/APo/7cgyWp5jcXockbxdk5kFRkbeXWm4Fbi9FrdN381sA=="
|
||||
},
|
||||
"node_modules/@nodelib/fs.scandir": {
|
||||
"version": "2.1.5",
|
||||
"resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
|
||||
|
|
@ -2776,6 +2784,11 @@
|
|||
"node": ">= 6"
|
||||
}
|
||||
},
|
||||
"node_modules/compute-scroll-into-view": {
|
||||
"version": "3.1.1",
|
||||
"resolved": "https://registry.npmjs.org/compute-scroll-into-view/-/compute-scroll-into-view-3.1.1.tgz",
|
||||
"integrity": "sha512-VRhuHOLoKYOy4UbilLbUzbYg93XLjv2PncJC50EuTWPA3gaja1UjBsUP/D/9/juV3vQFr6XBEzn9KCAHdUvOHw=="
|
||||
},
|
||||
"node_modules/concat-map": {
|
||||
"version": "0.0.1",
|
||||
"resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
|
||||
|
|
@ -3067,6 +3080,18 @@
|
|||
"node": "^14.15.0 || ^16.10.0 || >=18.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/direction": {
|
||||
"version": "1.0.4",
|
||||
"resolved": "https://registry.npmjs.org/direction/-/direction-1.0.4.tgz",
|
||||
"integrity": "sha512-GYqKi1aH7PJXxdhTeZBFrg8vUBeKXi+cNprXsC1kpJcbcVnV9wBsrOu1cQEdG0WeQwlfHiy3XvnKfIrJ2R0NzQ==",
|
||||
"bin": {
|
||||
"direction": "cli.js"
|
||||
},
|
||||
"funding": {
|
||||
"type": "github",
|
||||
"url": "https://github.com/sponsors/wooorm"
|
||||
}
|
||||
},
|
||||
"node_modules/dlv": {
|
||||
"version": "1.1.3",
|
||||
"resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",
|
||||
|
|
@ -4496,6 +4521,11 @@
|
|||
"node": ">=0.10.0"
|
||||
}
|
||||
},
|
||||
"node_modules/is-hotkey": {
|
||||
"version": "0.2.0",
|
||||
"resolved": "https://registry.npmjs.org/is-hotkey/-/is-hotkey-0.2.0.tgz",
|
||||
"integrity": "sha512-UknnZK4RakDmTgz4PI1wIph5yxSs/mvChWs9ifnlXsKuXgWmOkY/hAE0H/k2MIqH0RlRye0i1oC07MCRSD28Mw=="
|
||||
},
|
||||
"node_modules/is-map": {
|
||||
"version": "2.0.3",
|
||||
"resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz",
|
||||
|
|
@ -4554,6 +4584,14 @@
|
|||
"node": ">=8"
|
||||
}
|
||||
},
|
||||
"node_modules/is-plain-object": {
|
||||
"version": "5.0.0",
|
||||
"resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-5.0.0.tgz",
|
||||
"integrity": "sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==",
|
||||
"engines": {
|
||||
"node": ">=0.10.0"
|
||||
}
|
||||
},
|
||||
"node_modules/is-potential-custom-element-name": {
|
||||
"version": "1.0.1",
|
||||
"resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
|
||||
|
|
@ -4931,6 +4969,11 @@
|
|||
"url": "https://github.com/sponsors/sindresorhus"
|
||||
}
|
||||
},
|
||||
"node_modules/lodash": {
|
||||
"version": "4.17.23",
|
||||
"resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
|
||||
"integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w=="
|
||||
},
|
||||
"node_modules/lodash.merge": {
|
||||
"version": "4.6.2",
|
||||
"resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
|
||||
|
|
@ -6220,6 +6263,14 @@
|
|||
"loose-envify": "^1.1.0"
|
||||
}
|
||||
},
|
||||
"node_modules/scroll-into-view-if-needed": {
|
||||
"version": "3.1.0",
|
||||
"resolved": "https://registry.npmjs.org/scroll-into-view-if-needed/-/scroll-into-view-if-needed-3.1.0.tgz",
|
||||
"integrity": "sha512-49oNpRjWRvnU8NyGVmUaYG4jtTkNonFZI86MmGRDqBphEK2EXT9gdEUoQPZhuBM8yWHxCWbobltqYO5M4XrUvQ==",
|
||||
"dependencies": {
|
||||
"compute-scroll-into-view": "^3.0.2"
|
||||
}
|
||||
},
|
||||
"node_modules/semver": {
|
||||
"version": "6.3.1",
|
||||
"resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
|
||||
|
|
@ -6400,6 +6451,59 @@
|
|||
"node": ">= 10"
|
||||
}
|
||||
},
|
||||
"node_modules/slate": {
|
||||
"version": "0.123.0",
|
||||
"resolved": "https://registry.npmjs.org/slate/-/slate-0.123.0.tgz",
|
||||
"integrity": "sha512-Oon3HR/QzJQBjuOUJT1jGGlp8Ff7t3Bkr/rJ2lDqxNT4H+cBnXpEVQ/si6hn1ZCHhD2xY/2N91PQoH/rD7kxTg=="
|
||||
},
|
||||
"node_modules/slate-dom": {
|
||||
"version": "0.123.0",
|
||||
"resolved": "https://registry.npmjs.org/slate-dom/-/slate-dom-0.123.0.tgz",
|
||||
"integrity": "sha512-OUinp4tvSrAlt64JL9y20Xin08jgnnj1gJmIuPdGvU5MELKXRNZh17a7EKKNOS6OZPAE8Dk9NI1MAIS/Qz0YBw==",
|
||||
"peer": true,
|
||||
"dependencies": {
|
||||
"@juggle/resize-observer": "^3.4.0",
|
||||
"direction": "^1.0.4",
|
||||
"is-hotkey": "^0.2.0",
|
||||
"is-plain-object": "^5.0.0",
|
||||
"lodash": "^4.17.21",
|
||||
"scroll-into-view-if-needed": "^3.1.0",
|
||||
"tiny-invariant": "1.3.1"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"slate": ">=0.121.0"
|
||||
}
|
||||
},
|
||||
"node_modules/slate-history": {
|
||||
"version": "0.113.1",
|
||||
"resolved": "https://registry.npmjs.org/slate-history/-/slate-history-0.113.1.tgz",
|
||||
"integrity": "sha512-J9NSJ+UG2GxoW0lw5mloaKcN0JI0x2IA5M5FxyGiInpn+QEutxT1WK7S/JneZCMFJBoHs1uu7S7e6pxQjubHmQ==",
|
||||
"dependencies": {
|
||||
"is-plain-object": "^5.0.0"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"slate": ">=0.65.3"
|
||||
}
|
||||
},
|
||||
"node_modules/slate-react": {
|
||||
"version": "0.123.0",
|
||||
"resolved": "https://registry.npmjs.org/slate-react/-/slate-react-0.123.0.tgz",
|
||||
"integrity": "sha512-nQwXL1FEacrY9ZFmatRhoBnsySNUX2x6qB77V3oNHd7wWxBJWuzz4GMrBXcVoRE8Gac7Angf8xaNGzb6zcPlHg==",
|
||||
"dependencies": {
|
||||
"@juggle/resize-observer": "^3.4.0",
|
||||
"direction": "^1.0.4",
|
||||
"is-hotkey": "^0.2.0",
|
||||
"lodash": "^4.17.21",
|
||||
"scroll-into-view-if-needed": "^3.1.0",
|
||||
"tiny-invariant": "1.3.1"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"react": ">=18.2.0",
|
||||
"react-dom": ">=18.2.0",
|
||||
"slate": ">=0.121.0",
|
||||
"slate-dom": ">=0.119.1"
|
||||
}
|
||||
},
|
||||
"node_modules/source-map-js": {
|
||||
"version": "1.2.1",
|
||||
"resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
|
||||
|
|
@ -6744,6 +6848,11 @@
|
|||
"node": ">=0.8"
|
||||
}
|
||||
},
|
||||
"node_modules/tiny-invariant": {
|
||||
"version": "1.3.1",
|
||||
"resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.1.tgz",
|
||||
"integrity": "sha512-AD5ih2NlSssTCwsMznbvwMZpJ1cbhkGd2uueNxzv2jDlEeZdU04JQfRnggJQ8DrcVBGjAsCKwFBbDlVNtEMlzw=="
|
||||
},
|
||||
"node_modules/tinybench": {
|
||||
"version": "2.9.0",
|
||||
"resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
|
||||
|
|
|
|||
|
|
@ -23,6 +23,9 @@
|
|||
"react-dom": "^18.2.0",
|
||||
"react-hook-form": "^7.71.2",
|
||||
"react-router-dom": "^6.20.1",
|
||||
"slate": "^0.123.0",
|
||||
"slate-history": "^0.113.1",
|
||||
"slate-react": "^0.123.0",
|
||||
"zod": "^4.3.6"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
|
|
|||
|
|
@ -17,6 +17,11 @@ import { BoardCreate } from './pages/BoardCreate';
|
|||
import { BoardEdit } from './pages/BoardEdit';
|
||||
import { BoardDetail } from './pages/BoardDetail';
|
||||
import { BoardEpics } from './pages/BoardEpics';
|
||||
import CreateEpic from './pages/CreateEpic';
|
||||
import { EpicDetail } from './pages/EpicDetail';
|
||||
import { BoardWikis } from './pages/BoardWikis';
|
||||
import CreateWiki from './pages/CreateWiki';
|
||||
import { WikiDetail } from './pages/WikiDetail';
|
||||
import { CardDetail } from './pages/CardDetail';
|
||||
|
||||
const App = () => {
|
||||
|
|
@ -93,6 +98,46 @@ const App = () => {
|
|||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/epics/new"
|
||||
element={
|
||||
<ProtectedRoute>
|
||||
<CreateEpic />
|
||||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/epics/:epicId"
|
||||
element={
|
||||
<ProtectedRoute>
|
||||
<EpicDetail />
|
||||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/wikis"
|
||||
element={
|
||||
<ProtectedRoute>
|
||||
<BoardWikis />
|
||||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/wikis/new"
|
||||
element={
|
||||
<ProtectedRoute>
|
||||
<CreateWiki />
|
||||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/wikis/:wikiId"
|
||||
element={
|
||||
<ProtectedRoute>
|
||||
<WikiDetail />
|
||||
</ProtectedRoute>
|
||||
}
|
||||
/>
|
||||
<Route
|
||||
path="/boards/:id/cards/:cardId"
|
||||
element={
|
||||
|
|
|
|||
|
|
@ -9,8 +9,8 @@ export function BoardSidebar({ boardId }: BoardSidebarProps) {
|
|||
|
||||
const menuItems = [
|
||||
{ id: 'epics', label: 'Epics', icon: '📋', path: `/boards/${boardId}/epics` },
|
||||
{ id: 'wikis', label: 'Wikis', icon: '📚', path: `/boards/${boardId}/wikis` },
|
||||
{ id: 'history', label: 'History', icon: '📜', path: `/boards/${boardId}/history` },
|
||||
{ id: 'documents', label: 'Documents', icon: '📄', path: `/boards/${boardId}/documents` },
|
||||
];
|
||||
|
||||
return (
|
||||
|
|
|
|||
37
frontend/src/components/ELEMENT_TAGS.ts
Normal file
37
frontend/src/components/ELEMENT_TAGS.ts
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
const ELEMENT_TAGS: Record<string, (el: HTMLElement) => Partial<any>> = {
|
||||
A: (el: HTMLElement) => ({
|
||||
type: 'link',
|
||||
url: el.getAttribute('href') || '',
|
||||
children: [],
|
||||
}),
|
||||
BLOCKQUOTE: () => ({ type: 'block-quote', children: [] }),
|
||||
H1: () => ({ type: 'heading-one', children: [] }),
|
||||
H2: () => ({ type: 'heading-two', children: [] }),
|
||||
H3: () => ({ type: 'heading-three', children: [] }),
|
||||
H4: () => ({ type: 'heading-four', children: [] }),
|
||||
H5: () => ({ type: 'heading-five', children: [] }),
|
||||
H6: () => ({ type: 'heading-six', children: [] }),
|
||||
IMG: (el: HTMLElement) => ({
|
||||
type: 'image',
|
||||
url: el.getAttribute('src') || '',
|
||||
children: [],
|
||||
}),
|
||||
LI: () => ({ type: 'list-item', children: [] }),
|
||||
OL: () => ({ type: 'numbered-list', children: [] }),
|
||||
P: () => ({ type: 'paragraph', children: [] }),
|
||||
PRE: () => ({ type: 'code-block', children: [] }),
|
||||
CODE: () => ({ type: 'code-line bg-gray-900', children: [] }),
|
||||
UL: () => ({ type: 'bulleted-list', children: [] }),
|
||||
};
|
||||
|
||||
const TEXT_TAGS: Record<string, () => Record<string, boolean>> = {
|
||||
CODE: () => ({ code: true }),
|
||||
DEL: () => ({ strikethrough: true }),
|
||||
EM: () => ({ italic: true }),
|
||||
I: () => ({ italic: true }),
|
||||
S: () => ({ strikethrough: true }),
|
||||
STRONG: () => ({ bold: true }),
|
||||
U: () => ({ underline: true }),
|
||||
};
|
||||
|
||||
export { ELEMENT_TAGS, TEXT_TAGS };
|
||||
33
frontend/src/components/RichTextContent.tsx
Normal file
33
frontend/src/components/RichTextContent.tsx
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
import { useCallback, useMemo } from 'react';
|
||||
import { createEditor, Descendant } from 'slate';
|
||||
import { Slate, Editable, withReact, RenderElementProps, RenderLeafProps } from 'slate-react';
|
||||
import { Leaf, SlateRenderElement, withHtml } from './slate-editor-components';
|
||||
|
||||
export interface RichTextContentProps {
|
||||
content: Descendant[] | null;
|
||||
className?: string;
|
||||
}
|
||||
|
||||
const RichTextContent = ({ content }: any) => {
|
||||
const editor = useMemo(() => withHtml(withReact(createEditor())), []);
|
||||
|
||||
// const editor = useMemo(() => withHtml(withHistory(withReact(createEditor()))), []);
|
||||
const renderElement = useCallback(
|
||||
(props: RenderElementProps) => <SlateRenderElement {...props} />,
|
||||
[]
|
||||
);
|
||||
|
||||
const renderLeaf = useCallback((props: RenderLeafProps) => <Leaf {...props} />, []);
|
||||
return (
|
||||
<Slate editor={editor} initialValue={content}>
|
||||
<Editable
|
||||
renderElement={renderElement}
|
||||
renderLeaf={renderLeaf}
|
||||
readOnly
|
||||
placeholder="Enter some plain text..."
|
||||
/>
|
||||
</Slate>
|
||||
);
|
||||
};
|
||||
|
||||
export default RichTextContent;
|
||||
126
frontend/src/components/RichTextEditor.tsx
Normal file
126
frontend/src/components/RichTextEditor.tsx
Normal file
|
|
@ -0,0 +1,126 @@
|
|||
import React, { useMemo, useCallback } from 'react';
|
||||
import { createEditor, Descendant, Editor } from 'slate';
|
||||
import {
|
||||
Slate,
|
||||
Editable,
|
||||
withReact as withReactPlugin,
|
||||
useSlate,
|
||||
RenderElementProps,
|
||||
RenderLeafProps,
|
||||
} from 'slate-react';
|
||||
import { withHistory } from 'slate-history';
|
||||
import { CustomEditor, CustomTextKey } from './custom-types';
|
||||
import {
|
||||
BlockButton,
|
||||
Button,
|
||||
Icon,
|
||||
Leaf,
|
||||
SlateRenderElement,
|
||||
Toolbar,
|
||||
withHtml,
|
||||
} from './slate-editor-components';
|
||||
|
||||
export interface RichTextEditorProps {
|
||||
value: Descendant[];
|
||||
onChange: (value: Descendant[]) => void;
|
||||
placeholder?: string;
|
||||
readOnly?: boolean;
|
||||
className?: string;
|
||||
}
|
||||
|
||||
interface MarkButtonProps {
|
||||
format: CustomTextKey;
|
||||
icon: string;
|
||||
}
|
||||
|
||||
const isMarkActive = (editor: CustomEditor, format: CustomTextKey) => {
|
||||
const marks = Editor.marks(editor);
|
||||
return marks ? marks[format] === true : false;
|
||||
};
|
||||
|
||||
const toggleMark = (editor: CustomEditor, format: CustomTextKey) => {
|
||||
const isActive = isMarkActive(editor, format);
|
||||
|
||||
if (isActive) {
|
||||
Editor.removeMark(editor, format);
|
||||
} else {
|
||||
Editor.addMark(editor, format, true);
|
||||
}
|
||||
};
|
||||
|
||||
const MarkButton = ({ format, icon }: MarkButtonProps) => {
|
||||
const editor = useSlate();
|
||||
return (
|
||||
<Button
|
||||
active={isMarkActive(editor, format)}
|
||||
onPointerDown={(event: any) => event.preventDefault()}
|
||||
onClick={() => toggleMark(editor, format)}
|
||||
>
|
||||
<Icon>{icon}</Icon>
|
||||
</Button>
|
||||
);
|
||||
};
|
||||
|
||||
const RichTextEditor: React.FC<RichTextEditorProps> = ({
|
||||
value,
|
||||
onChange,
|
||||
placeholder = 'Type something...',
|
||||
readOnly = false,
|
||||
className = '',
|
||||
}) => {
|
||||
const editor = useMemo(() => withHtml(withHistory(withReactPlugin(createEditor()))), []);
|
||||
|
||||
const renderElement = useCallback(
|
||||
(props: RenderElementProps) => <SlateRenderElement {...props} />,
|
||||
[]
|
||||
);
|
||||
|
||||
// const renderElement = useCallback((props: any) => {
|
||||
// switch (props.element.type) {
|
||||
// case "block-quote":
|
||||
// return <blockquote {...props.attributes}>{props.children}</blockquote>;
|
||||
// case "bulleted-list":
|
||||
// return <ul {...props.attributes}>{props.children}</ul>;
|
||||
// case "list-item":
|
||||
// return <li {...props.attributes}>{props.children}</li>;
|
||||
// case "numbered-list":
|
||||
// return <ol {...props.attributes}>{props.children}</ol>;
|
||||
// default:
|
||||
// return <p {...props.attributes}>{props.children}</p>;
|
||||
// }
|
||||
// }, []);
|
||||
|
||||
const renderLeaf = useCallback((props: RenderLeafProps) => <Leaf {...props} />, []);
|
||||
|
||||
return (
|
||||
<div className={`bg-gray-800 rounded-lg border border-gray-700 ${className}`}>
|
||||
<Slate editor={editor} initialValue={value} onChange={onChange}>
|
||||
<Toolbar>
|
||||
<MarkButton format="bold" icon="format_bold" />
|
||||
<MarkButton format="italic" icon="format_italic" />
|
||||
<MarkButton format="underline" icon="format_underlined" />
|
||||
<MarkButton format="code" icon="code" />
|
||||
<BlockButton format="heading-one" icon="looks_one" />
|
||||
<BlockButton format="heading-two" icon="looks_two" />
|
||||
<BlockButton format="block-quote" icon="format_quote" />
|
||||
<BlockButton format="numbered-list" icon="format_list_numbered" />
|
||||
<BlockButton format="bulleted-list" icon="format_list_bulleted" />
|
||||
<BlockButton format="left" icon="format_align_left" />
|
||||
<BlockButton format="center" icon="format_align_center" />
|
||||
<BlockButton format="right" icon="format_align_right" />
|
||||
<BlockButton format="justify" icon="format_align_justify" />
|
||||
</Toolbar>
|
||||
<Editable
|
||||
renderElement={renderElement}
|
||||
renderLeaf={renderLeaf}
|
||||
placeholder={placeholder}
|
||||
readOnly={readOnly}
|
||||
className="min-h-[200px] p-4 text-gray-100 focus:outline-none"
|
||||
spellCheck
|
||||
/>
|
||||
</Slate>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default RichTextEditor;
|
||||
196
frontend/src/components/custom-types.d.ts
vendored
Normal file
196
frontend/src/components/custom-types.d.ts
vendored
Normal file
|
|
@ -0,0 +1,196 @@
|
|||
import { Descendant, BaseEditor, BaseRange, Range, Element } from 'slate';
|
||||
import { ReactEditor } from 'slate-react';
|
||||
import { HistoryEditor } from 'slate-history';
|
||||
|
||||
export type BlockQuoteElement = {
|
||||
type: 'block-quote';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type BulletedListElement = {
|
||||
type: 'bulleted-list';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type CheckListItemElement = {
|
||||
type: 'check-list-item';
|
||||
checked: boolean;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type EditableVoidElement = {
|
||||
type: 'editable-void';
|
||||
children: EmptyText[];
|
||||
};
|
||||
|
||||
export type HeadingElement = {
|
||||
type: 'heading-one';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type HeadingTwoElement = {
|
||||
type: 'heading-two';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type HeadingThreeElement = {
|
||||
type: 'heading-three';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type HeadingFourElement = {
|
||||
type: 'heading-four';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type HeadingFiveElement = {
|
||||
type: 'heading-five';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type HeadingSixElement = {
|
||||
type: 'heading-six';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type ImageElement = {
|
||||
type: 'image';
|
||||
url: string;
|
||||
children: EmptyText[];
|
||||
};
|
||||
|
||||
export type LinkElement = { type: 'link'; url: string; children: Descendant[] };
|
||||
|
||||
export type ButtonElement = { type: 'button'; children: Descendant[] };
|
||||
|
||||
export type BadgeElement = { type: 'badge'; children: Descendant[] };
|
||||
|
||||
export type ListItemElement = { type: 'list-item'; children: Descendant[] };
|
||||
|
||||
export type NumberedListItemElement = {
|
||||
type: 'numbered-list';
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type MentionElement = {
|
||||
type: 'mention';
|
||||
character: string;
|
||||
children: CustomText[];
|
||||
};
|
||||
|
||||
export type ParagraphElement = {
|
||||
type: 'paragraph';
|
||||
align?: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type TableElement = { type: 'table'; children: TableRow[] };
|
||||
|
||||
export type TableCellElement = { type: 'table-cell'; children: CustomText[] };
|
||||
|
||||
export type TableRowElement = { type: 'table-row'; children: TableCell[] };
|
||||
|
||||
export type TitleElement = { type: 'title'; children: Descendant[] };
|
||||
|
||||
export type VideoElement = { type: 'video'; url: string; children: EmptyText[] };
|
||||
|
||||
export type CodeBlockElement = {
|
||||
type: 'code-block';
|
||||
language: string;
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type CodeLineElement = {
|
||||
type: 'code-line';
|
||||
children: Descendant[];
|
||||
};
|
||||
|
||||
export type CustomElementWithAlign =
|
||||
| ParagraphElement
|
||||
| HeadingElement
|
||||
| HeadingTwoElement
|
||||
| HeadingThreeElement
|
||||
| HeadingFourElement
|
||||
| HeadingFiveElement
|
||||
| HeadingSixElement
|
||||
| BlockQuoteElement
|
||||
| BulletedListElement;
|
||||
|
||||
type CustomElement =
|
||||
| BlockQuoteElement
|
||||
| BulletedListElement
|
||||
| CheckListItemElement
|
||||
| EditableVoidElement
|
||||
| HeadingElement
|
||||
| HeadingTwoElement
|
||||
| HeadingThreeElement
|
||||
| HeadingFourElement
|
||||
| HeadingFiveElement
|
||||
| HeadingSixElement
|
||||
| ImageElement
|
||||
| LinkElement
|
||||
| ButtonElement
|
||||
| BadgeElement
|
||||
| ListItemElement
|
||||
| NumberedListItemElement
|
||||
| MentionElement
|
||||
| ParagraphElement
|
||||
| TableElement
|
||||
| TableRowElement
|
||||
| TableCellElement
|
||||
| TitleElement
|
||||
| VideoElement
|
||||
| CodeBlockElement
|
||||
| CodeLineElement;
|
||||
|
||||
export type CustomElementType = CustomElement['type'];
|
||||
|
||||
export type CustomText = {
|
||||
bold?: boolean;
|
||||
italic?: boolean;
|
||||
code?: boolean;
|
||||
underline?: boolean;
|
||||
strikethrough?: boolean;
|
||||
// MARKDOWN PREVIEW SPECIFIC LEAF
|
||||
underlined?: boolean;
|
||||
title?: boolean;
|
||||
list?: boolean;
|
||||
hr?: boolean;
|
||||
blockquote?: boolean;
|
||||
text: string;
|
||||
};
|
||||
|
||||
export type CustomTextKey = keyof Omit<CustomText, 'text'>;
|
||||
|
||||
export type EmptyText = {
|
||||
text: string;
|
||||
};
|
||||
|
||||
export type RenderElementPropsFor<T> = RenderElementProps & {
|
||||
element: T;
|
||||
};
|
||||
|
||||
export type CustomEditor = BaseEditor &
|
||||
ReactEditor &
|
||||
HistoryEditor & {
|
||||
nodeToDecorations?: Map<Element, Range[]>;
|
||||
};
|
||||
|
||||
declare module 'slate' {
|
||||
interface CustomTypes {
|
||||
Editor: CustomEditor;
|
||||
Element: CustomElement;
|
||||
Text: CustomText;
|
||||
Range: BaseRange & {
|
||||
[key: string]: unknown;
|
||||
};
|
||||
}
|
||||
}
|
||||
16
frontend/src/components/isImageUrl.ts
Normal file
16
frontend/src/components/isImageUrl.ts
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
const isImageUrl = (url: string): boolean => {
|
||||
if (!url) return false;
|
||||
|
||||
try {
|
||||
new URL(url); // Validate URL format
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
|
||||
const imageExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg', 'bmp', 'ico', 'tiff', 'tif'];
|
||||
const ext = url.split('.').pop()?.toLowerCase();
|
||||
|
||||
return ext ? imageExtensions.includes(ext) : false;
|
||||
};
|
||||
|
||||
export default isImageUrl;
|
||||
329
frontend/src/components/slate-editor-components/index.tsx
Normal file
329
frontend/src/components/slate-editor-components/index.tsx
Normal file
|
|
@ -0,0 +1,329 @@
|
|||
import React, { ReactNode } from 'react';
|
||||
import ReactDOM from 'react-dom';
|
||||
import { RenderElementProps, RenderLeafProps, useSlate } from 'slate-react';
|
||||
import {
|
||||
CustomEditor,
|
||||
CustomElement,
|
||||
CustomElementType,
|
||||
CustomElementWithAlign,
|
||||
} from '../custom-types';
|
||||
import { Editor, Node, Transforms, Element as SlateElement } from 'slate';
|
||||
import { ELEMENT_TAGS, TEXT_TAGS } from '../ELEMENT_TAGS';
|
||||
|
||||
export const deserialize = (node: any): any[] => {
|
||||
if (node.nodeType === 3) {
|
||||
return [{ text: node.textContent }];
|
||||
} else if (node.nodeType !== 1) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const el = node as any;
|
||||
const children = Array.from(node.childNodes).map(deserialize).flat();
|
||||
|
||||
if (el.nodeName === 'BODY') {
|
||||
return children;
|
||||
}
|
||||
|
||||
if (ELEMENT_TAGS[el.nodeName]) {
|
||||
const attrs = ELEMENT_TAGS[el.nodeName](el);
|
||||
return [{ ...attrs, children }];
|
||||
}
|
||||
|
||||
if (TEXT_TAGS[el.nodeName]) {
|
||||
const attrs = TEXT_TAGS[el.nodeName]();
|
||||
return children.map((child) => ({ ...child, ...attrs }));
|
||||
}
|
||||
|
||||
return children;
|
||||
};
|
||||
|
||||
const LIST_TYPES = ['numbered-list', 'bulleted-list'] as const;
|
||||
const TEXT_ALIGN_TYPES = ['left', 'center', 'right', 'justify'] as const;
|
||||
|
||||
type AlignType = (typeof TEXT_ALIGN_TYPES)[number];
|
||||
|
||||
// --- Interfaces ---
|
||||
|
||||
// Extend standard HTML attributes to include className, id, etc. automatically
|
||||
interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
|
||||
active: boolean;
|
||||
reversed?: boolean;
|
||||
}
|
||||
|
||||
type ListType = (typeof LIST_TYPES)[number];
|
||||
type CustomElementFormat = CustomElementType | AlignType | ListType;
|
||||
|
||||
const isAlignType = (format: CustomElementFormat): format is AlignType => {
|
||||
return TEXT_ALIGN_TYPES.includes(format as AlignType);
|
||||
};
|
||||
|
||||
const isListType = (format: CustomElementFormat): format is ListType => {
|
||||
return LIST_TYPES.includes(format as ListType);
|
||||
};
|
||||
|
||||
// --- Components ---
|
||||
|
||||
export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
|
||||
({ className, active, reversed, ...props }, ref) => {
|
||||
// Determine color based on props logic from original CSS
|
||||
let colorClass = '';
|
||||
if (reversed) {
|
||||
colorClass = active ? 'text-white' : 'text-[#aaa]';
|
||||
} else {
|
||||
colorClass = active ? 'text-black' : 'text-[#ccc]';
|
||||
}
|
||||
|
||||
return (
|
||||
<button
|
||||
{...props}
|
||||
type="button"
|
||||
ref={ref}
|
||||
className={`border-none bg-transparent p-0 cursor-pointer ${colorClass} ${className ?? ''}`}
|
||||
/>
|
||||
);
|
||||
}
|
||||
);
|
||||
Button.displayName = 'Button';
|
||||
|
||||
export const Icon = React.forwardRef<HTMLSpanElement, React.HTMLAttributes<HTMLSpanElement>>(
|
||||
({ className, ...props }, ref) => (
|
||||
<span
|
||||
{...props}
|
||||
ref={ref}
|
||||
// 'material-icons' is kept as it likely comes from a global CSS link
|
||||
className={`material-icons text-[18px] align-text-bottom ${className ?? ''}`}
|
||||
/>
|
||||
)
|
||||
);
|
||||
Icon.displayName = 'Icon';
|
||||
|
||||
export const Instruction = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
|
||||
({ className, ...props }, ref) => (
|
||||
<div
|
||||
{...props}
|
||||
ref={ref}
|
||||
className={`whitespace-pre-wrap my-0 mx-[-20px] mb-[10px] p-[10px] px-[20px] text-[14px] bg-[#f8f8e8] ${className ?? ''}`}
|
||||
/>
|
||||
)
|
||||
);
|
||||
Instruction.displayName = 'Instruction';
|
||||
|
||||
export const Menu = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
|
||||
({ className, ...props }, ref) => (
|
||||
<div
|
||||
{...props}
|
||||
data-test-id="menu"
|
||||
ref={ref}
|
||||
// Replaced inline-block + margin-left logic with flex + gap
|
||||
className={`flex flex-wrap items-center gap-[15px] ${className ?? ''}`}
|
||||
/>
|
||||
)
|
||||
);
|
||||
Menu.displayName = 'Menu';
|
||||
|
||||
export const Portal = ({ children }: { children?: ReactNode }) => {
|
||||
return typeof document === 'object' ? ReactDOM.createPortal(children, document.body) : null;
|
||||
};
|
||||
|
||||
export const Toolbar = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
|
||||
({ className, ...props }, ref) => (
|
||||
<Menu
|
||||
{...props}
|
||||
ref={ref}
|
||||
className={`relative px-[18px] py-[1px] pb-[17px] mx-[-20px] mb-5 border-b-2 border-[#eee] ${className ?? ''}`}
|
||||
/>
|
||||
)
|
||||
);
|
||||
Toolbar.displayName = 'Toolbar';
|
||||
|
||||
export const Leaf = ({ attributes, children, leaf }: RenderLeafProps) => {
|
||||
if (leaf.bold) {
|
||||
children = <strong className="font-bold">{children}</strong>;
|
||||
}
|
||||
|
||||
if (leaf.code) {
|
||||
children = (
|
||||
<code className="bg-gray-200 text-gray-800 px-1 py-0.5 rounded font-mono text-sm border border-gray-300">
|
||||
{children}
|
||||
</code>
|
||||
);
|
||||
}
|
||||
|
||||
if (leaf.italic) {
|
||||
children = <em className="italic">{children}</em>;
|
||||
}
|
||||
|
||||
if (leaf.underline) {
|
||||
children = <u className="underline">{children}</u>;
|
||||
}
|
||||
|
||||
return <span {...attributes}>{children}</span>;
|
||||
};
|
||||
|
||||
const isAlignElement = (element: CustomElement): element is CustomElementWithAlign => {
|
||||
return 'align' in element;
|
||||
};
|
||||
export const SlateRenderElement = ({ attributes, children, element }: RenderElementProps) => {
|
||||
console.log('element.type', element);
|
||||
|
||||
switch (element.type) {
|
||||
case 'block-quote':
|
||||
return (
|
||||
<blockquote
|
||||
className="border-l-4 border-gray-300 pl-4 italic my-4 text-gray-700"
|
||||
{...attributes}
|
||||
>
|
||||
{children}
|
||||
</blockquote>
|
||||
);
|
||||
case 'code-block':
|
||||
return (
|
||||
<pre
|
||||
className="bg-gray-100 text-gray-800 p-4 rounded-md overflow-x-auto my-4 font-mono text-sm border border-gray-300"
|
||||
{...attributes}
|
||||
>
|
||||
<code>{children}</code>
|
||||
</pre>
|
||||
);
|
||||
case 'bulleted-list':
|
||||
return (
|
||||
<ul className="list-disc pl-5 my-4" {...attributes}>
|
||||
{children}
|
||||
</ul>
|
||||
);
|
||||
case 'heading-one':
|
||||
return (
|
||||
<h1 className="text-4xl font-bold my-4" {...attributes}>
|
||||
{children}
|
||||
</h1>
|
||||
);
|
||||
case 'heading-two':
|
||||
return (
|
||||
<h2 className="text-3xl font-bold my-3" {...attributes}>
|
||||
{children}
|
||||
</h2>
|
||||
);
|
||||
case 'heading-three':
|
||||
return (
|
||||
<h2 className="text-1xl font-bold my-2" {...attributes}>
|
||||
{children}
|
||||
</h2>
|
||||
);
|
||||
case 'list-item':
|
||||
return (
|
||||
<li className="my-1" {...attributes}>
|
||||
{children}
|
||||
</li>
|
||||
);
|
||||
case 'numbered-list':
|
||||
return (
|
||||
<ol className="list-decimal pl-5 my-4" {...attributes}>
|
||||
{children}
|
||||
</ol>
|
||||
);
|
||||
default:
|
||||
return (
|
||||
<div className="inline my-2 mr-2 leading-relaxed prose prose-sm" {...attributes}>
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
};
|
||||
|
||||
const isBlockActive = (
|
||||
editor: CustomEditor,
|
||||
format: CustomElementFormat,
|
||||
blockType: 'type' | 'align' = 'type'
|
||||
) => {
|
||||
const { selection } = editor;
|
||||
if (!selection) return false;
|
||||
|
||||
const [match] = Array.from(
|
||||
Editor.nodes(editor, {
|
||||
at: Editor.unhangRange(editor, selection),
|
||||
match: (n) => {
|
||||
if (Node.isElement(n)) {
|
||||
if (blockType === 'align' && isAlignElement(n)) {
|
||||
return n.align === format;
|
||||
}
|
||||
return n.type === format;
|
||||
}
|
||||
return false;
|
||||
},
|
||||
})
|
||||
);
|
||||
|
||||
return !!match;
|
||||
};
|
||||
|
||||
const toggleBlock = (editor: CustomEditor, format: CustomElementFormat) => {
|
||||
const isActive = isBlockActive(editor, format, isAlignType(format) ? 'align' : 'type');
|
||||
const isList = isListType(format);
|
||||
|
||||
Transforms.unwrapNodes(editor, {
|
||||
match: (n) => Node.isElement(n) && isListType(n.type) && !isAlignType(format),
|
||||
split: true,
|
||||
});
|
||||
let newProperties: Partial<SlateElement>;
|
||||
if (isAlignType(format)) {
|
||||
newProperties = {
|
||||
align: isActive ? undefined : format,
|
||||
};
|
||||
} else {
|
||||
newProperties = {
|
||||
type: isActive ? 'paragraph' : isList ? 'list-item' : format,
|
||||
};
|
||||
}
|
||||
Transforms.setNodes<SlateElement>(editor, newProperties);
|
||||
|
||||
if (!isActive && isList) {
|
||||
const block = { type: format, children: [] } as any;
|
||||
Transforms.wrapNodes(editor, block);
|
||||
}
|
||||
};
|
||||
|
||||
interface BlockButtonProps {
|
||||
format: CustomElementFormat;
|
||||
icon: string;
|
||||
}
|
||||
|
||||
export const BlockButton = ({ format, icon }: BlockButtonProps) => {
|
||||
const editor = useSlate();
|
||||
return (
|
||||
<Button
|
||||
active={isBlockActive(editor, format, isAlignType(format) ? 'align' : 'type')}
|
||||
onPointerDown={(event: any) => event.preventDefault()}
|
||||
onClick={() => toggleBlock(editor, format)}
|
||||
data-test-id={`block-button-${format}`}
|
||||
>
|
||||
<Icon>{icon}</Icon>
|
||||
</Button>
|
||||
);
|
||||
};
|
||||
|
||||
export const withHtml = (editor: CustomEditor) => {
|
||||
const { insertData, isInline, isVoid } = editor;
|
||||
|
||||
editor.isInline = (element: any) => {
|
||||
return element.type === 'link' ? true : isInline(element);
|
||||
};
|
||||
|
||||
editor.isVoid = (element: any) => {
|
||||
return element.type === 'image' ? true : isVoid(element);
|
||||
};
|
||||
|
||||
editor.insertData = (data) => {
|
||||
const html = data.getData('text/html');
|
||||
|
||||
if (html) {
|
||||
const parsed = new DOMParser().parseFromString(html, 'text/html');
|
||||
const fragment = deserialize(parsed.body);
|
||||
Transforms.insertFragment(editor, fragment);
|
||||
return;
|
||||
}
|
||||
|
||||
insertData(data);
|
||||
};
|
||||
|
||||
return editor;
|
||||
};
|
||||
|
|
@ -299,6 +299,55 @@ export function useApi() {
|
|||
});
|
||||
return response.data;
|
||||
},
|
||||
|
||||
// Epics
|
||||
getEpics: async (boardId: number): Promise<any> => {
|
||||
const response = await api.get(`/boards/${boardId}/epics`);
|
||||
return response.data;
|
||||
},
|
||||
createEpic: async (boardId: number, epicData: any): Promise<any> => {
|
||||
const response = await api.post(`/boards/${boardId}/epics`, epicData);
|
||||
return response.data;
|
||||
},
|
||||
getEpic: async (epicId: number): Promise<any> => {
|
||||
const response = await api.get(`/epics/${epicId}`);
|
||||
return response.data;
|
||||
},
|
||||
updateEpic: async (epicId: number, epicData: any): Promise<any> => {
|
||||
const response = await api.put(`/epics/${epicId}`, epicData);
|
||||
return response.data;
|
||||
},
|
||||
deleteEpic: async (epicId: number): Promise<void> => {
|
||||
await api.delete(`/epics/${epicId}`);
|
||||
},
|
||||
addEpicToCard: async (cardId: number, epicId: number): Promise<any> => {
|
||||
const response = await api.post(`/cards/${cardId}/epics`, { epic_id: epicId });
|
||||
return response.data;
|
||||
},
|
||||
removeEpicFromCard: async (cardId: number, epicId: number): Promise<void> => {
|
||||
await api.delete(`/cards/${cardId}/epics/${epicId}`);
|
||||
},
|
||||
|
||||
// Wikis
|
||||
getWikis: async (boardId: number): Promise<any> => {
|
||||
const response = await api.get(`/boards/${boardId}/wikis`);
|
||||
return response.data;
|
||||
},
|
||||
createWiki: async (boardId: number, wikiData: any): Promise<any> => {
|
||||
const response = await api.post(`/boards/${boardId}/wikis`, wikiData);
|
||||
return response.data;
|
||||
},
|
||||
getWiki: async (wikiId: number): Promise<any> => {
|
||||
const response = await api.get(`/wikis/${wikiId}`);
|
||||
return response.data;
|
||||
},
|
||||
updateWiki: async (wikiId: number, wikiData: any): Promise<any> => {
|
||||
const response = await api.put(`/wikis/${wikiId}`, wikiData);
|
||||
return response.data;
|
||||
},
|
||||
deleteWiki: async (wikiId: number): Promise<void> => {
|
||||
await api.delete(`/wikis/${wikiId}`);
|
||||
},
|
||||
}),
|
||||
[]
|
||||
);
|
||||
|
|
|
|||
105
frontend/src/hooks/useEpicDetail.ts
Normal file
105
frontend/src/hooks/useEpicDetail.ts
Normal file
|
|
@ -0,0 +1,105 @@
|
|||
import { useState, useEffect, useCallback } from 'react';
|
||||
import { useApi } from './useApi';
|
||||
import { useLoader } from '../context/loaders/useLoader';
|
||||
import { useToast } from '../context/toasts/useToast';
|
||||
import type { Epic, UpdateEpicRequest } from '../types/epic';
|
||||
|
||||
function useEpicDetail(epicId: string) {
|
||||
const [epic, setEpic] = useState<Epic | null>(null);
|
||||
const [error, setError] = useState<Error | null>(null);
|
||||
|
||||
const { getEpic, updateEpic: apiUpdateEpic, deleteEpic: apiDeleteEpic } = useApi();
|
||||
const { withLoader } = useLoader();
|
||||
const { addNotification } = useToast();
|
||||
|
||||
const fetchEpic = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
const data = await withLoader(() => getEpic(Number(epicId)), 'Loading epic...');
|
||||
setEpic(data);
|
||||
return data;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to load epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Loading Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
return null;
|
||||
}
|
||||
}, [epicId, getEpic, withLoader, addNotification]);
|
||||
|
||||
const updateEpic = useCallback(
|
||||
async (epicData: UpdateEpicRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const updatedEpic = await withLoader(
|
||||
() => apiUpdateEpic(Number(epicId), epicData),
|
||||
'Updating epic...'
|
||||
);
|
||||
setEpic(updatedEpic);
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Epic Updated',
|
||||
message: 'Epic updated successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return updatedEpic;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to update epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Updating Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[epicId, apiUpdateEpic, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const deleteEpic = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
await withLoader(() => apiDeleteEpic(Number(epicId)), 'Deleting epic...');
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Epic Deleted',
|
||||
message: 'Epic deleted successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return true;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to delete epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Deleting Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
}, [epicId, apiDeleteEpic, withLoader, addNotification]);
|
||||
|
||||
useEffect(() => {
|
||||
if (epicId) {
|
||||
fetchEpic();
|
||||
}
|
||||
}, [epicId, fetchEpic]);
|
||||
|
||||
return {
|
||||
epic,
|
||||
error, // For debugging, not for UI display
|
||||
loading: false, // Loading is handled by global loader
|
||||
updateEpic,
|
||||
deleteEpic,
|
||||
refetch: fetchEpic,
|
||||
};
|
||||
}
|
||||
|
||||
export default useEpicDetail;
|
||||
144
frontend/src/hooks/useEpics.ts
Normal file
144
frontend/src/hooks/useEpics.ts
Normal file
|
|
@ -0,0 +1,144 @@
|
|||
import { useState, useEffect, useCallback } from 'react';
|
||||
import { useApi } from './useApi';
|
||||
import { useLoader } from '../context/loaders/useLoader';
|
||||
import { useToast } from '../context/toasts/useToast';
|
||||
import type { Epic, CreateEpicRequest, UpdateEpicRequest } from '../types/epic';
|
||||
|
||||
function useEpics(boardId: string) {
|
||||
const [epics, setEpics] = useState<Epic[]>([]);
|
||||
const [error, setError] = useState<Error | null>(null);
|
||||
|
||||
const {
|
||||
getEpics,
|
||||
createEpic: apiCreateEpic,
|
||||
updateEpic: apiUpdateEpic,
|
||||
deleteEpic: apiDeleteEpic,
|
||||
} = useApi();
|
||||
const { withLoader } = useLoader();
|
||||
const { addNotification } = useToast();
|
||||
|
||||
const fetchEpics = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
const data = await withLoader(() => getEpics(Number(boardId)), 'Loading epics...');
|
||||
setEpics(data);
|
||||
return data;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to load epics';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Loading Epics',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
return [];
|
||||
}
|
||||
}, [boardId, getEpics, withLoader, addNotification]);
|
||||
|
||||
const createEpic = useCallback(
|
||||
async (epicData: CreateEpicRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const newEpic = await withLoader(
|
||||
() => apiCreateEpic(Number(boardId), epicData),
|
||||
'Creating epic...'
|
||||
);
|
||||
setEpics((prev) => [...prev, newEpic]);
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Epic Created',
|
||||
message: `Epic "${epicData.name}" created successfully.`,
|
||||
duration: 3000,
|
||||
});
|
||||
return newEpic;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to create epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Creating Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[boardId, apiCreateEpic, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const updateEpic = useCallback(
|
||||
async (epicId: number, epicData: UpdateEpicRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const updatedEpic = await withLoader(
|
||||
() => apiUpdateEpic(epicId, epicData),
|
||||
'Updating epic...'
|
||||
);
|
||||
setEpics((prev) => prev.map((epic) => (epic.id === epicId ? updatedEpic : epic)));
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Epic Updated',
|
||||
message: 'Epic updated successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return updatedEpic;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to update epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Updating Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[apiUpdateEpic, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const deleteEpic = useCallback(
|
||||
async (epicId: number) => {
|
||||
try {
|
||||
setError(null);
|
||||
await withLoader(() => apiDeleteEpic(epicId), 'Deleting epic...');
|
||||
setEpics((prev) => prev.filter((epic) => epic.id !== epicId));
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Epic Deleted',
|
||||
message: 'Epic deleted successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to delete epic';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Deleting Epic',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[apiDeleteEpic, withLoader, addNotification]
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
fetchEpics();
|
||||
}, [fetchEpics]);
|
||||
|
||||
return {
|
||||
epics,
|
||||
error, // For debugging, not for UI display
|
||||
loading: false, // Loading is handled by global loader
|
||||
fetchEpics,
|
||||
createEpic,
|
||||
updateEpic,
|
||||
deleteEpic,
|
||||
refetch: fetchEpics,
|
||||
};
|
||||
}
|
||||
|
||||
export default useEpics;
|
||||
105
frontend/src/hooks/useWikiDetail.ts
Normal file
105
frontend/src/hooks/useWikiDetail.ts
Normal file
|
|
@ -0,0 +1,105 @@
|
|||
import { useState, useEffect, useCallback } from 'react';
|
||||
import { useApi } from './useApi';
|
||||
import { useLoader } from '../context/loaders/useLoader';
|
||||
import { useToast } from '../context/toasts/useToast';
|
||||
import type { Wiki, UpdateWikiRequest } from '../types/epic';
|
||||
|
||||
function useWikiDetail(wikiId: string) {
|
||||
const [wiki, setWiki] = useState<Wiki | null>(null);
|
||||
const [error, setError] = useState<Error | null>(null);
|
||||
|
||||
const { getWiki, updateWiki: apiUpdateWiki, deleteWiki: apiDeleteWiki } = useApi();
|
||||
const { withLoader } = useLoader();
|
||||
const { addNotification } = useToast();
|
||||
|
||||
const fetchWiki = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
const data = await withLoader(() => getWiki(Number(wikiId)), 'Loading wiki...');
|
||||
setWiki(data);
|
||||
return data;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to load wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Loading Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
return null;
|
||||
}
|
||||
}, [wikiId, getWiki, withLoader, addNotification]);
|
||||
|
||||
const updateWiki = useCallback(
|
||||
async (wikiData: UpdateWikiRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const updatedWiki = await withLoader(
|
||||
() => apiUpdateWiki(Number(wikiId), wikiData),
|
||||
'Updating wiki...'
|
||||
);
|
||||
setWiki(updatedWiki);
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Wiki Updated',
|
||||
message: 'Wiki updated successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return updatedWiki;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to update wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Updating Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[wikiId, apiUpdateWiki, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const deleteWiki = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
await withLoader(() => apiDeleteWiki(Number(wikiId)), 'Deleting wiki...');
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Wiki Deleted',
|
||||
message: 'Wiki deleted successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return true;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to delete wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Deleting Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
}, [wikiId, apiDeleteWiki, withLoader, addNotification]);
|
||||
|
||||
useEffect(() => {
|
||||
if (wikiId) {
|
||||
fetchWiki();
|
||||
}
|
||||
}, [wikiId, fetchWiki]);
|
||||
|
||||
return {
|
||||
wiki,
|
||||
error, // For debugging, not for UI display
|
||||
loading: false, // Loading is handled by global loader
|
||||
updateWiki,
|
||||
deleteWiki,
|
||||
refetch: fetchWiki,
|
||||
};
|
||||
}
|
||||
|
||||
export default useWikiDetail;
|
||||
144
frontend/src/hooks/useWikis.ts
Normal file
144
frontend/src/hooks/useWikis.ts
Normal file
|
|
@ -0,0 +1,144 @@
|
|||
import { useState, useEffect, useCallback } from 'react';
|
||||
import { useApi } from './useApi';
|
||||
import { useLoader } from '../context/loaders/useLoader';
|
||||
import { useToast } from '../context/toasts/useToast';
|
||||
import type { Wiki, CreateWikiRequest, UpdateWikiRequest } from '../types/epic';
|
||||
|
||||
function useWikis(boardId: string) {
|
||||
const [wikis, setWikis] = useState<Wiki[]>([]);
|
||||
const [error, setError] = useState<Error | null>(null);
|
||||
|
||||
const {
|
||||
getWikis,
|
||||
createWiki: apiCreateWiki,
|
||||
updateWiki: apiUpdateWiki,
|
||||
deleteWiki: apiDeleteWiki,
|
||||
} = useApi();
|
||||
const { withLoader } = useLoader();
|
||||
const { addNotification } = useToast();
|
||||
|
||||
const fetchWikis = useCallback(async () => {
|
||||
try {
|
||||
setError(null);
|
||||
const data = await withLoader(() => getWikis(Number(boardId)), 'Loading wikis...');
|
||||
setWikis(data);
|
||||
return data;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to load wikis';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Loading Wikis',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
return [];
|
||||
}
|
||||
}, [boardId, getWikis, withLoader, addNotification]);
|
||||
|
||||
const createWiki = useCallback(
|
||||
async (wikiData: CreateWikiRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const newWiki = await withLoader(
|
||||
() => apiCreateWiki(Number(boardId), wikiData),
|
||||
'Creating wiki...'
|
||||
);
|
||||
setWikis((prev) => [...prev, newWiki]);
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Wiki Created',
|
||||
message: `Wiki "${wikiData.name}" created successfully.`,
|
||||
duration: 3000,
|
||||
});
|
||||
return newWiki;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to create wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Creating Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[boardId, apiCreateWiki, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const updateWiki = useCallback(
|
||||
async (wikiId: number, wikiData: UpdateWikiRequest) => {
|
||||
try {
|
||||
setError(null);
|
||||
const updatedWiki = await withLoader(
|
||||
() => apiUpdateWiki(wikiId, wikiData),
|
||||
'Updating wiki...'
|
||||
);
|
||||
setWikis((prev) => prev.map((wiki) => (wiki.id === wikiId ? updatedWiki : wiki)));
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Wiki Updated',
|
||||
message: 'Wiki updated successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
return updatedWiki;
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to update wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Updating Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[apiUpdateWiki, withLoader, addNotification]
|
||||
);
|
||||
|
||||
const deleteWiki = useCallback(
|
||||
async (wikiId: number) => {
|
||||
try {
|
||||
setError(null);
|
||||
await withLoader(() => apiDeleteWiki(wikiId), 'Deleting wiki...');
|
||||
setWikis((prev) => prev.filter((wiki) => wiki.id !== wikiId));
|
||||
addNotification({
|
||||
type: 'success',
|
||||
title: 'Wiki Deleted',
|
||||
message: 'Wiki deleted successfully.',
|
||||
duration: 3000,
|
||||
});
|
||||
} catch (err) {
|
||||
const errorMessage = err instanceof Error ? err.message : 'Failed to delete wiki';
|
||||
setError(err instanceof Error ? err : new Error(errorMessage));
|
||||
addNotification({
|
||||
type: 'error',
|
||||
title: 'Error Deleting Wiki',
|
||||
message: errorMessage,
|
||||
duration: 5000,
|
||||
});
|
||||
throw err;
|
||||
}
|
||||
},
|
||||
[apiDeleteWiki, withLoader, addNotification]
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
fetchWikis();
|
||||
}, [fetchWikis]);
|
||||
|
||||
return {
|
||||
wikis,
|
||||
error, // For debugging, not for UI display
|
||||
loading: false, // Loading is handled by global loader
|
||||
fetchWikis,
|
||||
createWiki,
|
||||
updateWiki,
|
||||
deleteWiki,
|
||||
refetch: fetchWikis,
|
||||
};
|
||||
}
|
||||
|
||||
export default useWikis;
|
||||
|
|
@ -244,7 +244,7 @@ export function BoardDetail() {
|
|||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
<div className="px-4 sm:px-6 lg:px-8 ">
|
||||
<div className="px-4 sm:px-6 lg:px-8 max-h-[calc(100vh-280px)] overflow-auto">
|
||||
<div className="flex justify-between items-start gap-6">
|
||||
<div className="flex-1">
|
||||
<DndContext
|
||||
|
|
|
|||
|
|
@ -1,12 +1,78 @@
|
|||
import { useParams, Link } from 'react-router-dom';
|
||||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import useEpics from '../hooks/useEpics';
|
||||
import RichTextContent from '../components/RichTextContent';
|
||||
import type { Epic } from '../types/epic';
|
||||
|
||||
const PlusIcon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<line x1="12" y1="5" x2="12" y2="19"></line>
|
||||
<line x1="5" y1="12" x2="19" y2="12"></line>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Edit2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Trash2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="3 6 5 6 21 6"></polyline>
|
||||
<path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function BoardEpics() {
|
||||
const { id } = useParams<{ id: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { epics, deleteEpic } = useEpics(id || '0');
|
||||
|
||||
const handleDeleteEpic = async (epicId: number, epicName: string) => {
|
||||
if (confirm(`Are you sure you want to delete epic "${epicName}"?`)) {
|
||||
try {
|
||||
await deleteEpic(epicId);
|
||||
} catch {
|
||||
// Error is handled by the hook
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div className="flex items-center justify-between">
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${id}`}
|
||||
|
|
@ -15,21 +81,156 @@ export function BoardEpics() {
|
|||
← Back to Board
|
||||
</Link>
|
||||
<h1 className="text-3xl font-bold text-white mt-2">Epics</h1>
|
||||
<p className="text-gray-400 mt-1">Manage and view epics for this board</p>
|
||||
<p className="text-gray-400 mt-1">
|
||||
Manage and view epics for this board ({epics.length} epics)
|
||||
</p>
|
||||
</div>
|
||||
<Link
|
||||
to={`/boards/${id}/epics/new`}
|
||||
className="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<PlusIcon />
|
||||
</span>
|
||||
Create Epic
|
||||
</Link>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
<WidePageLayout>
|
||||
{epics.length === 0 ? (
|
||||
<div className="bg-gray-800 rounded-lg p-8 border border-gray-700">
|
||||
<div className="text-center py-12">
|
||||
<div className="text-6xl mb-4">📋</div>
|
||||
<h2 className="text-xl font-bold text-white mb-2">Epics Coming Soon</h2>
|
||||
<p className="text-gray-400">
|
||||
This page will allow you to create and manage epics for your board.
|
||||
<h2 className="text-xl font-bold text-white mb-2">No Epics Yet</h2>
|
||||
<p className="text-gray-400 mb-6">
|
||||
Create your first epic to start organizing your work.
|
||||
</p>
|
||||
<Link
|
||||
to={`/boards/${id}/epics/new`}
|
||||
className="bg-blue-600 hover:bg-blue-700 text-white px-6 py-2 rounded-lg inline-flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<PlusIcon />
|
||||
</span>
|
||||
Create First Epic
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
) : (
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
|
||||
{epics.map((epic) => (
|
||||
<EpicCard
|
||||
key={epic.id}
|
||||
epic={epic}
|
||||
onClick={() => navigate(`/boards/${id}/epics/${epic.id}`)}
|
||||
onDelete={() => handleDeleteEpic(epic.id, epic.name)}
|
||||
onEdit={() => navigate(`/boards/${id}/epics/${epic.id}/edit`)}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
interface EpicCardProps {
|
||||
epic: Epic;
|
||||
onClick: () => void;
|
||||
onDelete: () => void;
|
||||
onEdit: () => void;
|
||||
}
|
||||
|
||||
function EpicCard({ epic, onClick, onDelete, onEdit }: EpicCardProps) {
|
||||
const defaultColor = '#3b82f6';
|
||||
const color = epic.color || defaultColor;
|
||||
|
||||
return (
|
||||
<div
|
||||
className="bg-gray-800 rounded-lg border border-gray-700 hover:border-gray-600 transition-all cursor-pointer overflow-hidden group"
|
||||
onClick={onClick}
|
||||
>
|
||||
{/* Color header */}
|
||||
<div className="h-2" style={{ backgroundColor: color }} />
|
||||
|
||||
<div className="p-4">
|
||||
{/* Header with actions */}
|
||||
<div className="flex items-start justify-between mb-2">
|
||||
<h3 className="text-lg font-semibold text-white flex-1">{epic.name}</h3>
|
||||
<div className="flex gap-2 opacity-0 group-hover:opacity-100 transition-opacity">
|
||||
<button
|
||||
onClick={(e) => {
|
||||
e.stopPropagation();
|
||||
onEdit();
|
||||
}}
|
||||
className="text-gray-400 hover:text-white transition-colors p-1"
|
||||
title="Edit epic"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Edit2Icon />
|
||||
</span>
|
||||
</button>
|
||||
<button
|
||||
onClick={(e) => {
|
||||
e.stopPropagation();
|
||||
onDelete();
|
||||
}}
|
||||
className="text-gray-400 hover:text-red-400 transition-colors p-1"
|
||||
title="Delete epic"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Trash2Icon />
|
||||
</span>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Description */}
|
||||
{epic.description && (
|
||||
<p className="text-gray-400 text-sm mb-3 line-clamp-2">{epic.description}</p>
|
||||
)}
|
||||
|
||||
{/* Rich text content preview */}
|
||||
{epic.content && Array.isArray(epic.content) && epic.content.length > 0 && (
|
||||
<div className="mb-3">
|
||||
<RichTextContent
|
||||
content={epic.content}
|
||||
className="text-sm text-gray-400 line-clamp-3"
|
||||
/>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Footer with metrics */}
|
||||
<div className="flex items-center justify-between text-xs text-gray-500 mt-3 pt-3 border-t border-gray-700">
|
||||
<div className="flex items-center gap-4">
|
||||
<span className="flex items-center gap-1">
|
||||
<span>📊</span>
|
||||
{epic.metrics?.card_count || 0} cards
|
||||
</span>
|
||||
{epic.parent_epic_id && (
|
||||
<span className="flex items-center gap-1">
|
||||
<span>🔄</span>
|
||||
Sub-epic
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
{epic.date_last_activity && (
|
||||
<span>{new Date(epic.date_last_activity).toLocaleDateString()}</span>
|
||||
)}
|
||||
</div>
|
||||
|
||||
{/* Closed badge */}
|
||||
{epic.closed && (
|
||||
<div className="mt-3">
|
||||
<span className="inline-block px-2 py-1 bg-gray-700 text-gray-400 text-xs rounded">
|
||||
Closed
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default BoardEpics;
|
||||
|
|
|
|||
211
frontend/src/pages/BoardWikis.tsx
Normal file
211
frontend/src/pages/BoardWikis.tsx
Normal file
|
|
@ -0,0 +1,211 @@
|
|||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import RichTextContent from '../components/RichTextContent';
|
||||
import useWikis from '../hooks/useWikis';
|
||||
import type { Wiki } from '../types/epic';
|
||||
|
||||
const PlusIcon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<line x1="12" y1="5" x2="12" y2="19"></line>
|
||||
<line x1="5" y1="12" x2="19" y2="12"></line>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Edit2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Trash2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="3 6 5 6 21 6"></polyline>
|
||||
<path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function BoardWikis() {
|
||||
const { id } = useParams<{ id: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { wikis, deleteWiki } = useWikis(id || '0');
|
||||
|
||||
const handleDeleteWiki = async (wikiId: number, wikiName: string) => {
|
||||
if (confirm(`Are you sure you want to delete wiki "${wikiName}"?`)) {
|
||||
try {
|
||||
await deleteWiki(wikiId);
|
||||
} catch {
|
||||
// Error is handled by the hook
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div className="flex items-center justify-between">
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${id}`}
|
||||
className="text-gray-400 hover:text-white transition-colors text-sm"
|
||||
>
|
||||
← Back to Board
|
||||
</Link>
|
||||
<h1 className="text-3xl font-bold text-white mt-2">Wikis</h1>
|
||||
<p className="text-gray-400 mt-1">
|
||||
Manage and view wikis for this board ({wikis.length} wikis)
|
||||
</p>
|
||||
</div>
|
||||
<Link
|
||||
to={`/boards/${id}/wikis/new`}
|
||||
className="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<PlusIcon />
|
||||
</span>
|
||||
Create Wiki
|
||||
</Link>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
<WidePageLayout>
|
||||
{wikis.length === 0 ? (
|
||||
<div className="bg-gray-800 rounded-lg p-8 border border-gray-700">
|
||||
<div className="text-center py-12">
|
||||
<div className="text-6xl mb-4">📚</div>
|
||||
<h2 className="text-xl font-bold text-white mb-2">No Wikis Yet</h2>
|
||||
<p className="text-gray-400 mb-6">
|
||||
Create your first wiki to start documenting your knowledge.
|
||||
</p>
|
||||
<Link
|
||||
to={`/boards/${id}/wikis/new`}
|
||||
className="bg-blue-600 hover:bg-blue-700 text-white px-6 py-2 rounded-lg inline-flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<PlusIcon />
|
||||
</span>
|
||||
Create First Wiki
|
||||
</Link>
|
||||
</div>
|
||||
</div>
|
||||
) : (
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
|
||||
{wikis.map((wiki) => (
|
||||
<WikiCard
|
||||
key={wiki.id}
|
||||
wiki={wiki}
|
||||
onClick={() => navigate(`/boards/${id}/wikis/${wiki.id}`)}
|
||||
onDelete={() => handleDeleteWiki(wiki.id, wiki.name)}
|
||||
onEdit={() => navigate(`/boards/${id}/wikis/${wiki.id}/edit`)}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
interface WikiCardProps {
|
||||
wiki: Wiki;
|
||||
onClick: () => void;
|
||||
onDelete: () => void;
|
||||
onEdit: () => void;
|
||||
}
|
||||
|
||||
function WikiCard({ wiki, onClick, onDelete, onEdit }: WikiCardProps) {
|
||||
return (
|
||||
<div
|
||||
className="bg-gray-800 rounded-lg border border-gray-700 hover:border-gray-600 transition-all cursor-pointer overflow-hidden group"
|
||||
onClick={onClick}
|
||||
>
|
||||
<div className="p-4">
|
||||
{/* Header with actions */}
|
||||
<div className="flex items-start justify-between mb-2">
|
||||
<h3 className="text-lg font-semibold text-white flex-1">{wiki.name}</h3>
|
||||
<div className="flex gap-2 opacity-0 group-hover:opacity-100 transition-opacity">
|
||||
<button
|
||||
onClick={(e) => {
|
||||
e.stopPropagation();
|
||||
onEdit();
|
||||
}}
|
||||
className="text-gray-400 hover:text-white transition-colors p-1"
|
||||
title="Edit wiki"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Edit2Icon />
|
||||
</span>
|
||||
</button>
|
||||
<button
|
||||
onClick={(e) => {
|
||||
e.stopPropagation();
|
||||
onDelete();
|
||||
}}
|
||||
className="text-gray-400 hover:text-red-400 transition-colors p-1"
|
||||
title="Delete wiki"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Trash2Icon />
|
||||
</span>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Summary */}
|
||||
{wiki.summary && <p className="text-gray-400 text-sm mb-3 line-clamp-2">{wiki.summary}</p>}
|
||||
|
||||
{/* Rich text content preview */}
|
||||
{wiki.content && Array.isArray(wiki.content) && wiki.content.length > 0 && (
|
||||
<div className="mb-3">
|
||||
<RichTextContent
|
||||
content={wiki.content}
|
||||
className="text-sm text-gray-400 line-clamp-3"
|
||||
/>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Footer with metadata */}
|
||||
<div className="flex items-center justify-between text-xs text-gray-500 mt-3 pt-3 border-t border-gray-700">
|
||||
<div className="flex items-center gap-4">
|
||||
{wiki.category && (
|
||||
<span className="px-2 py-1 bg-gray-700 text-gray-400 rounded">{wiki.category}</span>
|
||||
)}
|
||||
{wiki.tags && wiki.tags.length > 0 && <span>{wiki.tags.length} tag(s)</span>}
|
||||
</div>
|
||||
{wiki.updated_at && <span>{new Date(wiki.updated_at).toLocaleDateString()}</span>}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default BoardWikis;
|
||||
203
frontend/src/pages/CreateEpic.tsx
Normal file
203
frontend/src/pages/CreateEpic.tsx
Normal file
|
|
@ -0,0 +1,203 @@
|
|||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { useState } from 'react';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import RichTextEditor from '../components/RichTextEditor';
|
||||
import useEpics from '../hooks/useEpics';
|
||||
import type { CreateEpicRequest } from '../types/epic';
|
||||
|
||||
const CheckSquareIcon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="20"
|
||||
height="20"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="9 11 12 13 22 2"></polyline>
|
||||
<path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const COLOR_PRESETS = [
|
||||
'#ef4444', // Red
|
||||
'#f97316', // Orange
|
||||
'#eab308', // Yellow
|
||||
'#22c55e', // Green
|
||||
'#14b8a6', // Teal
|
||||
'#3b82f6', // Blue
|
||||
'#8b5cf6', // Purple
|
||||
'#ec4899', // Pink
|
||||
'#6b7280', // Gray
|
||||
];
|
||||
|
||||
export function CreateEpic() {
|
||||
const { id: boardId } = useParams<{ id: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { createEpic } = useEpics(boardId || '0');
|
||||
|
||||
const [name, setName] = useState('');
|
||||
const [description, setDescription] = useState('');
|
||||
const [color, setColor] = useState(COLOR_PRESETS[5]); // Default to blue
|
||||
const [content, setContent] = useState<any[]>([{ children: [{ text: '' }] }]);
|
||||
const [parentEpicId, setParentEpicId] = useState<number | undefined>(undefined);
|
||||
|
||||
const handleSubmit = async (e: React.FormEvent) => {
|
||||
e.preventDefault();
|
||||
|
||||
if (!name.trim()) {
|
||||
return;
|
||||
}
|
||||
|
||||
const epicData: CreateEpicRequest = {
|
||||
name: name.trim(),
|
||||
description: description.trim() || undefined,
|
||||
content:
|
||||
content.length > 1 || (content[0] as any).children[0].text !== ''
|
||||
? (content as unknown as Record<string, unknown>)
|
||||
: undefined,
|
||||
color,
|
||||
parent_epic_id: parentEpicId,
|
||||
};
|
||||
|
||||
try {
|
||||
const newEpic = await createEpic(epicData);
|
||||
navigate(`/boards/${boardId}/epics/${newEpic.id}`);
|
||||
} catch {
|
||||
// Error is handled by hook
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${boardId}/epics`}
|
||||
className="text-gray-400 hover:text-white transition-colors text-sm"
|
||||
>
|
||||
← Back to Epics
|
||||
</Link>
|
||||
<h1 className="text-3xl font-bold text-white mt-2">Create Epic</h1>
|
||||
<p className="text-gray-400 mt-1">Create a new epic for this board</p>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
<WidePageLayout>
|
||||
<form onSubmit={handleSubmit} className="bg-gray-800 rounded-lg border border-gray-700 p-6">
|
||||
{/* Name */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="name" className="block text-white font-medium mb-2">
|
||||
Epic Name <span className="text-red-500">*</span>
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
id="name"
|
||||
value={name}
|
||||
onChange={(e) => setName(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
placeholder="Enter epic name..."
|
||||
required
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Description */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="description" className="block text-white font-medium mb-2">
|
||||
Description
|
||||
</label>
|
||||
<textarea
|
||||
id="description"
|
||||
value={description}
|
||||
onChange={(e) => setDescription(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500 resize-none"
|
||||
rows={3}
|
||||
placeholder="Brief description of this epic..."
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Color */}
|
||||
<div className="mb-6">
|
||||
<label className="block text-white font-medium mb-2">Color</label>
|
||||
<div className="flex flex-wrap gap-3">
|
||||
{COLOR_PRESETS.map((presetColor) => (
|
||||
<button
|
||||
key={presetColor}
|
||||
type="button"
|
||||
onClick={() => setColor(presetColor)}
|
||||
className={`w-10 h-10 rounded-lg border-2 transition-all ${
|
||||
color === presetColor
|
||||
? 'border-white ring-2 ring-white ring-opacity-50'
|
||||
: 'border-transparent hover:border-gray-500'
|
||||
}`}
|
||||
style={{ backgroundColor: presetColor }}
|
||||
title={presetColor}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Rich Text Content */}
|
||||
<div className="mb-6">
|
||||
<label className="block text-white font-medium mb-2">Epic Details</label>
|
||||
<RichTextEditor
|
||||
value={content}
|
||||
onChange={setContent}
|
||||
placeholder="Add detailed information about this epic..."
|
||||
className="border-0"
|
||||
/>
|
||||
<p className="text-gray-500 text-xs mt-2">
|
||||
Use the rich text editor to add formatted content, lists, and more.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Parent Epic */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="parentEpic" className="block text-white font-medium mb-2">
|
||||
Parent Epic
|
||||
</label>
|
||||
<select
|
||||
id="parentEpic"
|
||||
value={parentEpicId || ''}
|
||||
onChange={(e) =>
|
||||
setParentEpicId(e.target.value ? parseInt(e.target.value, 10) : undefined)
|
||||
}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
>
|
||||
<option value="">No parent (top-level epic)</option>
|
||||
{/* Parent epics would be loaded here */}
|
||||
</select>
|
||||
<p className="text-gray-500 text-xs mt-2">
|
||||
Select a parent epic to create a hierarchy. Leave empty for a top-level epic.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Action Buttons */}
|
||||
<div className="flex gap-3 pt-4 border-t border-gray-700">
|
||||
<Link
|
||||
to={`/boards/${boardId}/epics`}
|
||||
className="px-6 py-2 rounded-lg border border-gray-600 text-gray-300 hover:text-white hover:border-gray-500 transition-colors"
|
||||
>
|
||||
Cancel
|
||||
</Link>
|
||||
<button
|
||||
type="submit"
|
||||
disabled={!name.trim()}
|
||||
className="flex-1 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white px-6 py-2 rounded-lg flex items-center justify-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-5 h-5">
|
||||
<CheckSquareIcon />
|
||||
</span>
|
||||
Create Epic
|
||||
</button>
|
||||
</div>
|
||||
</form>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default CreateEpic;
|
||||
200
frontend/src/pages/CreateWiki.tsx
Normal file
200
frontend/src/pages/CreateWiki.tsx
Normal file
|
|
@ -0,0 +1,200 @@
|
|||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { useState } from 'react';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import RichTextEditor from '../components/RichTextEditor';
|
||||
import useWikis from '../hooks/useWikis';
|
||||
import type { CreateWikiRequest } from '../types/epic';
|
||||
|
||||
const CheckSquareIcon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="20"
|
||||
height="20"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="9 11 12 13 22 2"></polyline>
|
||||
<path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function CreateWiki() {
|
||||
const { id: boardId } = useParams<{ id: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { createWiki } = useWikis(boardId || '0');
|
||||
|
||||
const [name, setName] = useState('');
|
||||
const [slug, setSlug] = useState('');
|
||||
const [summary, setSummary] = useState('');
|
||||
const [category, setCategory] = useState('');
|
||||
const [tags, setTags] = useState('');
|
||||
const [content, setContent] = useState<any[]>([{ children: [{ text: '' }] }]);
|
||||
|
||||
const handleSubmit = async (e: React.FormEvent) => {
|
||||
e.preventDefault();
|
||||
|
||||
if (!name.trim()) {
|
||||
return;
|
||||
}
|
||||
|
||||
const wikiData: CreateWikiRequest = {
|
||||
name: name.trim(),
|
||||
slug: slug.trim() || undefined,
|
||||
summary: summary.trim() || undefined,
|
||||
content:
|
||||
content.length > 1 || (content[0] as any).children[0].text !== ''
|
||||
? (content as unknown as Record<string, unknown>)
|
||||
: { children: [{ text: '' }] },
|
||||
category: category.trim() || undefined,
|
||||
tags: tags.trim() ? tags.split(',').map((t) => t.trim()) : undefined,
|
||||
};
|
||||
|
||||
try {
|
||||
const newWiki = await createWiki(wikiData);
|
||||
navigate(`/boards/${boardId}/wikis/${newWiki.id}`);
|
||||
} catch {
|
||||
// Error is handled by hook
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${boardId}/wikis`}
|
||||
className="text-gray-400 hover:text-white transition-colors text-sm"
|
||||
>
|
||||
← Back to Wikis
|
||||
</Link>
|
||||
<h1 className="text-3xl font-bold text-white mt-2">Create Wiki</h1>
|
||||
<p className="text-gray-400 mt-1">Create a new wiki for this board</p>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
<WidePageLayout>
|
||||
<form onSubmit={handleSubmit} className="bg-gray-800 rounded-lg border border-gray-700 p-6">
|
||||
{/* Name */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="name" className="block text-white font-medium mb-2">
|
||||
Wiki Name <span className="text-red-500">*</span>
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
id="name"
|
||||
value={name}
|
||||
onChange={(e) => setName(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
placeholder="Enter wiki name..."
|
||||
required
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Slug */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="slug" className="block text-white font-medium mb-2">
|
||||
URL Slug (optional)
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
id="slug"
|
||||
value={slug}
|
||||
onChange={(e) => setSlug(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
placeholder="url-friendly-slug"
|
||||
/>
|
||||
<p className="text-gray-500 text-xs mt-2">
|
||||
Leave empty to auto-generate from name. Used in URLs.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Summary */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="summary" className="block text-white font-medium mb-2">
|
||||
Summary
|
||||
</label>
|
||||
<textarea
|
||||
id="summary"
|
||||
value={summary}
|
||||
onChange={(e) => setSummary(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500 resize-none"
|
||||
rows={3}
|
||||
placeholder="Brief summary of this wiki..."
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Category */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="category" className="block text-white font-medium mb-2">
|
||||
Category
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
id="category"
|
||||
value={category}
|
||||
onChange={(e) => setCategory(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
placeholder="e.g., Documentation, Guides, Tutorials"
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Tags */}
|
||||
<div className="mb-6">
|
||||
<label htmlFor="tags" className="block text-white font-medium mb-2">
|
||||
Tags
|
||||
</label>
|
||||
<input
|
||||
type="text"
|
||||
id="tags"
|
||||
value={tags}
|
||||
onChange={(e) => setTags(e.target.value)}
|
||||
className="w-full bg-gray-700 border border-gray-600 rounded-lg px-4 py-2 text-white focus:outline-none focus:border-blue-500"
|
||||
placeholder="tag1, tag2, tag3"
|
||||
/>
|
||||
<p className="text-gray-500 text-xs mt-2">Separate multiple tags with commas.</p>
|
||||
</div>
|
||||
|
||||
{/* Rich Text Content */}
|
||||
<div className="mb-6">
|
||||
<label className="block text-white font-medium mb-2">Wiki Content</label>
|
||||
<RichTextEditor
|
||||
value={content}
|
||||
onChange={setContent}
|
||||
placeholder="Add detailed information to your wiki..."
|
||||
className="border-0"
|
||||
/>
|
||||
<p className="text-gray-500 text-xs mt-2">
|
||||
Use the rich text editor to add formatted content, lists, and more.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Action Buttons */}
|
||||
<div className="flex gap-3 pt-4 border-t border-gray-700">
|
||||
<Link
|
||||
to={`/boards/${boardId}/wikis`}
|
||||
className="px-6 py-2 rounded-lg border border-gray-600 text-gray-300 hover:text-white hover:border-gray-500 transition-colors"
|
||||
>
|
||||
Cancel
|
||||
</Link>
|
||||
<button
|
||||
type="submit"
|
||||
disabled={!name.trim()}
|
||||
className="flex-1 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white px-6 py-2 rounded-lg flex items-center justify-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-5 h-5">
|
||||
<CheckSquareIcon />
|
||||
</span>
|
||||
Create Wiki
|
||||
</button>
|
||||
</div>
|
||||
</form>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default CreateWiki;
|
||||
262
frontend/src/pages/EpicDetail.tsx
Normal file
262
frontend/src/pages/EpicDetail.tsx
Normal file
|
|
@ -0,0 +1,262 @@
|
|||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import RichTextContent from '../components/RichTextContent';
|
||||
import useEpicDetail from '../hooks/useEpicDetail';
|
||||
|
||||
const Edit2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Trash2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="3 6 5 6 21 6"></polyline>
|
||||
<path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const TagIcon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z"></path>
|
||||
<line x1="7" y1="7" x2="7.01" y2="7"></line>
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function EpicDetail() {
|
||||
const { id: boardId, epicId } = useParams<{ id: string; epicId: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { epic, deleteEpic } = useEpicDetail(epicId || '0');
|
||||
|
||||
const handleDelete = async () => {
|
||||
if (!epic) return;
|
||||
|
||||
if (confirm(`Are you sure you want to delete epic "${epic.name}"?`)) {
|
||||
try {
|
||||
await deleteEpic();
|
||||
navigate(`/boards/${boardId}/epics`);
|
||||
} catch {
|
||||
// Error is already handled by the hook with toast
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
if (!epic) {
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div className="text-center py-12">
|
||||
<div className="text-gray-400">Loading epic...</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const defaultColor = '#3b82f6';
|
||||
const color = epic.color || defaultColor;
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
{/* Header */}
|
||||
<WidePageLayout>
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${boardId}/epics`}
|
||||
className="text-gray-400 hover:text-white transition-colors text-sm"
|
||||
>
|
||||
← Back to Epics
|
||||
</Link>
|
||||
<div className="flex items-center justify-between mt-2">
|
||||
<div className="flex items-center gap-3">
|
||||
<div className="w-1 h-12 rounded" style={{ backgroundColor: color }} />
|
||||
<div>
|
||||
<h1 className="text-3xl font-bold text-white">{epic.name}</h1>
|
||||
{epic.closed && (
|
||||
<span className="inline-block px-2 py-1 bg-gray-700 text-gray-400 text-xs rounded mt-1">
|
||||
Closed
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
<div className="flex gap-2">
|
||||
<Link
|
||||
to={`/boards/${boardId}/epics/${epic.id}/edit`}
|
||||
className="bg-gray-700 hover:bg-gray-600 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Edit2Icon />
|
||||
</span>
|
||||
Edit
|
||||
</Link>
|
||||
<button
|
||||
onClick={handleDelete}
|
||||
className="bg-red-600 hover:bg-red-700 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Trash2Icon />
|
||||
</span>
|
||||
Delete
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
{/* Content */}
|
||||
<WidePageLayout>
|
||||
<div className="bg-gray-800 rounded-lg border border-gray-700 overflow-hidden">
|
||||
{/* Color header bar */}
|
||||
<div className="h-2" style={{ backgroundColor: color }} />
|
||||
|
||||
<div className="p-6">
|
||||
{/* Description */}
|
||||
{epic.description && (
|
||||
<div className="mb-6">
|
||||
<h2 className="text-lg font-semibold text-white mb-2">Description</h2>
|
||||
<p className="text-gray-300">{epic.description}</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Rich Text Content */}
|
||||
{epic.content && Array.isArray(epic.content) && epic.content.length > 0 && (
|
||||
<div className="mb-6">
|
||||
<h2 className="text-lg font-semibold text-white mb-2">Details</h2>
|
||||
<div className="bg-gray-900 rounded-lg p-4 border border-gray-700">
|
||||
<RichTextContent content={epic.content} />
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Metrics */}
|
||||
<div className="mb-6 pt-6 border-t border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-3">Metrics</h2>
|
||||
<div className="grid grid-cols-2 md:grid-cols-4 gap-4">
|
||||
<div className="bg-gray-900 rounded-lg p-4">
|
||||
<div className="flex items-center gap-2 text-gray-400 mb-1">
|
||||
<span>📊</span>
|
||||
<span className="text-sm">Cards</span>
|
||||
</div>
|
||||
<div className="text-2xl font-bold text-white">
|
||||
{epic.metrics?.card_count || 0}
|
||||
</div>
|
||||
</div>
|
||||
<div className="bg-gray-900 rounded-lg p-4">
|
||||
<div className="flex items-center gap-2 text-gray-400 mb-1">
|
||||
<span>📈</span>
|
||||
<span className="text-sm">Progress</span>
|
||||
</div>
|
||||
<div className="text-2xl font-bold text-white">
|
||||
{epic.metrics?.progress || 0}%
|
||||
</div>
|
||||
</div>
|
||||
{epic.depth_limit !== null && epic.depth_limit !== undefined && (
|
||||
<div className="bg-gray-900 rounded-lg p-4">
|
||||
<div className="flex items-center gap-2 text-gray-400 mb-1">
|
||||
<span>🔄</span>
|
||||
<span className="text-sm">Max Depth</span>
|
||||
</div>
|
||||
<div className="text-2xl font-bold text-white">{epic.depth_limit}</div>
|
||||
</div>
|
||||
)}
|
||||
{epic.parent_epic_id && (
|
||||
<div className="bg-gray-900 rounded-lg p-4">
|
||||
<div className="flex items-center gap-2 text-gray-400 mb-1">
|
||||
<span>🔗</span>
|
||||
<span className="text-sm">Parent</span>
|
||||
</div>
|
||||
<div className="text-lg font-bold text-white">Yes</div>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Metadata */}
|
||||
<div className="pt-6 border-t border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-3">Metadata</h2>
|
||||
<div className="space-y-2 text-sm">
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Created:</span>
|
||||
<span className="text-gray-300">
|
||||
{epic.created_at ? new Date(epic.created_at).toLocaleString() : 'N/A'}
|
||||
</span>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Updated:</span>
|
||||
<span className="text-gray-300">
|
||||
{epic.updated_at ? new Date(epic.updated_at).toLocaleString() : 'N/A'}
|
||||
</span>
|
||||
</div>
|
||||
{epic.date_last_activity && (
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Last Activity:</span>
|
||||
<span className="text-gray-300">
|
||||
{new Date(epic.date_last_activity).toLocaleString()}
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Links to Cards */}
|
||||
<div className="pt-6 border-t border-gray-700 mt-6">
|
||||
<div className="flex items-center justify-between mb-3">
|
||||
<h2 className="text-lg font-semibold text-white">Linked Cards</h2>
|
||||
<Link to={`/boards/${boardId}`} className="text-blue-500 hover:underline text-sm">
|
||||
View in Board →
|
||||
</Link>
|
||||
</div>
|
||||
{epic.metrics?.card_count === 0 ? (
|
||||
<div className="text-center py-8 text-gray-400">
|
||||
<div className="text-4xl mb-2">📭</div>
|
||||
<p>No cards linked to this epic yet</p>
|
||||
</div>
|
||||
) : (
|
||||
<div className="text-center py-8 text-gray-400">
|
||||
<div className="flex items-center justify-center gap-2">
|
||||
<span className="w-4 h-4">
|
||||
<TagIcon />
|
||||
</span>
|
||||
<span>{epic.metrics?.card_count} card(s) linked to this epic</span>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default EpicDetail;
|
||||
202
frontend/src/pages/WikiDetail.tsx
Normal file
202
frontend/src/pages/WikiDetail.tsx
Normal file
|
|
@ -0,0 +1,202 @@
|
|||
import { useParams, Link, useNavigate } from 'react-router-dom';
|
||||
import { WidePageLayout } from '../components/WidePageLayout';
|
||||
import RichTextContent from '../components/RichTextContent';
|
||||
import useWikiDetail from '../hooks/useWikiDetail';
|
||||
|
||||
const Edit2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
const Trash2Icon = () => (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width="16"
|
||||
height="16"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="2"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
>
|
||||
<polyline points="3 6 5 6 21 6"></polyline>
|
||||
<path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path>
|
||||
</svg>
|
||||
);
|
||||
|
||||
export function WikiDetail() {
|
||||
const { id: boardId, wikiId } = useParams<{ id: string; wikiId: string }>();
|
||||
const navigate = useNavigate();
|
||||
const { wiki, deleteWiki } = useWikiDetail(wikiId || '0');
|
||||
|
||||
const handleDelete = async () => {
|
||||
if (!wiki) return;
|
||||
|
||||
if (confirm(`Are you sure you want to delete wiki "${wiki.name}"?`)) {
|
||||
try {
|
||||
await deleteWiki();
|
||||
navigate(`/boards/${boardId}/wikis`);
|
||||
} catch {
|
||||
// Error is already handled by hook with toast
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
if (!wiki) {
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<WidePageLayout>
|
||||
<div className="text-center py-12">
|
||||
<div className="text-gray-400">Loading wiki...</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
{/* Header */}
|
||||
<WidePageLayout>
|
||||
<div>
|
||||
<Link
|
||||
to={`/boards/${boardId}/wikis`}
|
||||
className="text-gray-400 hover:text-white transition-colors text-sm"
|
||||
>
|
||||
← Back to Wikis
|
||||
</Link>
|
||||
<div className="flex items-center justify-between mt-2">
|
||||
<div>
|
||||
<h1 className="text-3xl font-bold text-white">{wiki.name}</h1>
|
||||
{wiki.slug && <span className="text-gray-400 text-sm">/{wiki.slug}</span>}
|
||||
</div>
|
||||
<div className="flex gap-2">
|
||||
<Link
|
||||
to={`/boards/${boardId}/wikis/${wiki.id}/edit`}
|
||||
className="bg-gray-700 hover:bg-gray-600 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Edit2Icon />
|
||||
</span>
|
||||
Edit
|
||||
</Link>
|
||||
<button
|
||||
onClick={handleDelete}
|
||||
className="bg-red-600 hover:bg-red-700 text-white px-4 py-2 rounded-lg flex items-center gap-2 transition-colors"
|
||||
>
|
||||
<span className="w-4 h-4">
|
||||
<Trash2Icon />
|
||||
</span>
|
||||
Delete
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
|
||||
{/* Content */}
|
||||
<WidePageLayout>
|
||||
<div className="bg-gray-800 rounded-lg border border-gray-700 overflow-hidden">
|
||||
<div className="p-6">
|
||||
{/* Summary */}
|
||||
{wiki.summary && (
|
||||
<div className="mb-6 pb-6 border-b border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-2">Summary</h2>
|
||||
<p className="text-gray-300">{wiki.summary}</p>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Rich Text Content */}
|
||||
{wiki.content && Array.isArray(wiki.content) && wiki.content.length > 0 && (
|
||||
<div className="mb-6 pb-6 border-b border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-2">Content</h2>
|
||||
<div className="bg-gray-900 rounded-lg p-6 border border-gray-700">
|
||||
<RichTextContent content={wiki.content} />
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Tags */}
|
||||
{wiki.tags && wiki.tags.length > 0 && (
|
||||
<div className="mb-6 pb-6 border-b border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-3">Tags</h2>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{wiki.tags.map((tag, index) => (
|
||||
<span
|
||||
key={index}
|
||||
className="px-3 py-1 bg-blue-600 text-white text-sm rounded-full"
|
||||
>
|
||||
{tag}
|
||||
</span>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Metadata */}
|
||||
<div className="pt-6 border-t border-gray-700">
|
||||
<h2 className="text-lg font-semibold text-white mb-3">Metadata</h2>
|
||||
<div className="space-y-2 text-sm">
|
||||
{wiki.category && (
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Category:</span>
|
||||
<span className="px-2 py-1 bg-gray-700 text-gray-300 rounded text-sm">
|
||||
{wiki.category}
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
{wiki.created_by && (
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Created By:</span>
|
||||
<span className="text-gray-300">User #{wiki.created_by}</span>
|
||||
</div>
|
||||
)}
|
||||
{wiki.updated_by && (
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Updated By:</span>
|
||||
<span className="text-gray-300">User #{wiki.updated_by}</span>
|
||||
</div>
|
||||
)}
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Created:</span>
|
||||
<span className="text-gray-300">
|
||||
{wiki.created_at ? new Date(wiki.created_at).toLocaleString() : 'N/A'}
|
||||
</span>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-gray-400 w-24">Updated:</span>
|
||||
<span className="text-gray-300">
|
||||
{wiki.updated_at ? new Date(wiki.updated_at).toLocaleString() : 'N/A'}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Linked Entities Section */}
|
||||
<div className="pt-6 border-t border-gray-700 mt-6">
|
||||
<h2 className="text-lg font-semibold text-white mb-3">Linked Entities</h2>
|
||||
<div className="text-center py-8 text-gray-400">
|
||||
<div className="text-4xl mb-2">🔗</div>
|
||||
<p>This wiki can be linked to cards and other entities</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</WidePageLayout>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default WikiDetail;
|
||||
81
frontend/src/types/epic.ts
Normal file
81
frontend/src/types/epic.ts
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
export interface Epic {
|
||||
id: number;
|
||||
name: string;
|
||||
description: string | null;
|
||||
content: Record<string, unknown> | null;
|
||||
color: string | null;
|
||||
closed: boolean;
|
||||
pos: number | null;
|
||||
depth_limit: number | null;
|
||||
board_id: number;
|
||||
parent_epic_id: number | null;
|
||||
date_last_activity: string | null;
|
||||
created_at: string | null;
|
||||
updated_at: string | null;
|
||||
metrics: {
|
||||
card_count?: number;
|
||||
progress?: number;
|
||||
} | null;
|
||||
}
|
||||
|
||||
export interface Wiki {
|
||||
id: number;
|
||||
name: string;
|
||||
slug: string | null;
|
||||
content: Record<string, unknown>;
|
||||
summary: string | null;
|
||||
category: string | null;
|
||||
board_id: number;
|
||||
created_by: number | null;
|
||||
updated_by: number | null;
|
||||
created_at: string | null;
|
||||
updated_at: string | null;
|
||||
tags: string[] | null;
|
||||
}
|
||||
|
||||
export interface CreateEpicRequest {
|
||||
name: string;
|
||||
description?: string;
|
||||
content?: Record<string, unknown>;
|
||||
color?: string;
|
||||
pos?: number;
|
||||
depth_limit?: number;
|
||||
parent_epic_id?: number | null;
|
||||
}
|
||||
|
||||
export interface UpdateEpicRequest {
|
||||
name?: string;
|
||||
description?: string;
|
||||
content?: Record<string, unknown>;
|
||||
color?: string;
|
||||
closed?: boolean;
|
||||
pos?: number;
|
||||
depth_limit?: number;
|
||||
parent_epic_id?: number | null;
|
||||
}
|
||||
|
||||
export interface CreateWikiRequest {
|
||||
name: string;
|
||||
slug?: string;
|
||||
content: Record<string, unknown>;
|
||||
summary?: string;
|
||||
category?: string;
|
||||
tags?: string[];
|
||||
}
|
||||
|
||||
export interface UpdateWikiRequest {
|
||||
name?: string;
|
||||
slug?: string;
|
||||
content?: Record<string, unknown>;
|
||||
summary?: string;
|
||||
category?: string;
|
||||
tags?: string[];
|
||||
}
|
||||
|
||||
export interface WikiEntityLink {
|
||||
wiki_id: number;
|
||||
entity_type: string;
|
||||
entity_id: number;
|
||||
created_at: string | null;
|
||||
linked_by: number | null;
|
||||
}
|
||||
Loading…
Reference in a new issue