docs: add README, boost skill, and documentation site

docs/content/2.essentials/7.database-schema.md

@@ -0,0 +1,107 @@
+---
+title: Database Schema
+description: Tables, relationships, and indexes used by the Comments package.
+navigation:
+  icon: i-lucide-database
+seo:
+  description: Database schema reference for the Comments package.
+---
+
+## Tables
+
+Five tables are created by the package migrations.
+
+### comments
+
+The main comments table with polymorphic relationships and threading support.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | bigint | Primary key |
+| `commentable_type` | string | Polymorphic model type |
+| `commentable_id` | bigint | Polymorphic model ID |
+| `user_type` | string | Commenter model type |
+| `user_id` | bigint | Commenter model ID |
+| `parent_id` | bigint (nullable) | Parent comment for replies |
+| `body` | text | HTML comment content |
+| `edited_at` | timestamp (nullable) | When the comment was last edited |
+| `deleted_at` | timestamp (nullable) | Soft delete timestamp |
+| `created_at` | timestamp | |
+| `updated_at` | timestamp | |
+
+**Indexes:** `(commentable_type, commentable_id, parent_id)`
+
+### comment_reactions
+
+Tracks emoji reactions per user per comment.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | bigint | Primary key |
+| `comment_id` | bigint | Foreign key to comments |
+| `user_type` | string | Reactor model type |
+| `user_id` | bigint | Reactor model ID |
+| `reaction` | string | Reaction key (e.g., `thumbs_up`) |
+| `created_at` | timestamp | |
+
+**Unique constraint:** `(comment_id, user_id, user_type, reaction)`
+
+### comment_mentions
+
+Tracks @mentioned users per comment.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | bigint | Primary key |
+| `comment_id` | bigint | Foreign key to comments |
+| `user_type` | string | Mentioned user model type |
+| `user_id` | bigint | Mentioned user model ID |
+| `created_at` | timestamp | |
+
+**Unique constraint:** `(comment_id, user_id, user_type)`
+
+### comment_subscriptions
+
+Tracks which users are subscribed to comment threads on specific models.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | bigint | Primary key |
+| `commentable_type` | string | Subscribed model type |
+| `commentable_id` | bigint | Subscribed model ID |
+| `user_type` | string | Subscriber model type |
+| `user_id` | bigint | Subscriber model ID |
+| `created_at` | timestamp | |
+
+**Unique constraint:** `(commentable_type, commentable_id, user_type, user_id)`
+
+### comment_attachments
+
+Stores file attachment metadata for comments.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | bigint | Primary key |
+| `comment_id` | bigint | Foreign key to comments |
+| `file_path` | string | Path on the storage disk |
+| `original_name` | string | Original uploaded filename |
+| `mime_type` | string | File MIME type |
+| `size` | bigint | File size in bytes |
+| `disk` | string | Laravel filesystem disk |
+| `created_at` | timestamp | |
+| `updated_at` | timestamp | |
+
+## Relationships
+
+```
+Commentable Model (e.g., Project)
+  └── comments (morphMany)
+        ├── user (morphTo → User)
+        ├── parent (belongsTo → Comment)
+        ├── replies (hasMany → Comment)
+        ├── reactions (hasMany → CommentReaction)
+        ├── attachments (hasMany → CommentAttachment)
+        └── mentions (morphToMany → User)
+```
+
+All relationships are polymorphic, allowing the same comment system to work across any number of models in your application.