docs: add missing package index pages for dynamic nav
- Add index.md for commerce, content, developer, tenant packages - Update packages/index.md to include all 9 packages in grid - Fix dead link patterns in config for package root URLs The sidebar and nav dropdown now auto-discover all packages. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
c1920e541e
commit
421d4ae0cd
6 changed files with 185 additions and 0 deletions
|
|
@ -37,6 +37,9 @@ export default defineConfig({
|
||||||
/\/packages\/api\/(openapi|analytics|alerts|logging)/,
|
/\/packages\/api\/(openapi|analytics|alerts|logging)/,
|
||||||
/\/packages\/mcp\/commerce/,
|
/\/packages\/mcp\/commerce/,
|
||||||
/\/packages\/php\/(services|seeders|security|email-shield|action-gate|i18n)/,
|
/\/packages\/php\/(services|seeders|security|email-shield|action-gate|i18n)/,
|
||||||
|
// Package root links (without trailing slash) - VitePress resolves these
|
||||||
|
/^\/packages\/(admin|api|mcp|php|go)$/,
|
||||||
|
/^\/packages\/(admin|api|mcp|php|go)#/,
|
||||||
// Other pages not yet created
|
// Other pages not yet created
|
||||||
/\/testing\//,
|
/\/testing\//,
|
||||||
/\/contributing/,
|
/\/contributing/,
|
||||||
|
|
|
||||||
34
docs/packages/commerce/index.md
Normal file
34
docs/packages/commerce/index.md
Normal file
|
|
@ -0,0 +1,34 @@
|
||||||
|
---
|
||||||
|
title: Commerce Package
|
||||||
|
navTitle: Commerce
|
||||||
|
navOrder: 30
|
||||||
|
---
|
||||||
|
|
||||||
|
# Commerce Package
|
||||||
|
|
||||||
|
Billing, subscriptions, and payment processing for the Host UK platform.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The commerce module implements a multi-gateway payment system supporting cryptocurrency (BTCPay) and traditional card payments (Stripe). It handles the complete commerce lifecycle from checkout to recurring billing, dunning, and refunds.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Multi-gateway payments** - BTCPay (primary) and Stripe (secondary)
|
||||||
|
- **Subscriptions** - Recurring billing with plan management
|
||||||
|
- **Invoicing** - Automatic invoice generation and delivery
|
||||||
|
- **Dunning** - Failed payment recovery workflows
|
||||||
|
- **Coupons** - Discount codes and promotional pricing
|
||||||
|
- **Tax handling** - VAT/GST calculation and compliance
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
composer require host-uk/core-commerce
|
||||||
|
```
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- [Architecture](./architecture) - Technical architecture and design
|
||||||
|
- [Security](./security) - Payment security and PCI compliance
|
||||||
|
- [Webhooks](./webhooks) - Payment gateway webhook handling
|
||||||
39
docs/packages/content/index.md
Normal file
39
docs/packages/content/index.md
Normal file
|
|
@ -0,0 +1,39 @@
|
||||||
|
---
|
||||||
|
title: Content Package
|
||||||
|
navTitle: Content
|
||||||
|
navOrder: 40
|
||||||
|
---
|
||||||
|
|
||||||
|
# Content Package
|
||||||
|
|
||||||
|
Headless CMS functionality for the Host UK platform.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The `core-content` package provides content management, AI-powered generation, revision history, webhooks for external CMS integration, and search capabilities.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Content items** - Flexible content types with custom fields
|
||||||
|
- **AI generation** - Content creation via AI services
|
||||||
|
- **Revision history** - Full version control for content
|
||||||
|
- **Webhooks** - External CMS integration
|
||||||
|
- **Search** - Full-text search across content
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
composer require host-uk/core-content
|
||||||
|
```
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
- `core-php` - Foundation framework
|
||||||
|
- `core-tenant` - Workspaces and users
|
||||||
|
- Optional: `core-agentic` - AI content generation
|
||||||
|
- Optional: `core-mcp` - MCP tool handlers
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- [Architecture](./architecture) - Technical architecture
|
||||||
|
- [Security](./security) - Content security model
|
||||||
37
docs/packages/developer/index.md
Normal file
37
docs/packages/developer/index.md
Normal file
|
|
@ -0,0 +1,37 @@
|
||||||
|
---
|
||||||
|
title: Developer Package
|
||||||
|
navTitle: Developer
|
||||||
|
navOrder: 80
|
||||||
|
---
|
||||||
|
|
||||||
|
# Developer Package
|
||||||
|
|
||||||
|
Administrative developer tools for the Host UK platform.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The `core-developer` package provides debugging, monitoring, and server management capabilities. It is designed exclusively for "Hades" tier users (god-mode access).
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Server management** - SSH connections and remote commands
|
||||||
|
- **Route testing** - Automated route health checks
|
||||||
|
- **Debug tools** - Development debugging utilities
|
||||||
|
- **Horizon integration** - Queue monitoring
|
||||||
|
- **Telescope integration** - Request debugging
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
composer require host-uk/core-developer
|
||||||
|
```
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- Hades tier access (god-mode)
|
||||||
|
- `core-php` and `core-admin` packages
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- [Architecture](./architecture) - Technical architecture
|
||||||
|
- [Security](./security) - Access control and authorisation
|
||||||
|
|
@ -22,6 +22,12 @@ const packages = [
|
||||||
icon: '🔷',
|
icon: '🔷',
|
||||||
featured: true
|
featured: true
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
name: 'Tenant',
|
||||||
|
slug: 'tenant',
|
||||||
|
description: 'Multi-tenancy, workspaces, user management, and entitlement systems',
|
||||||
|
icon: '🏢'
|
||||||
|
},
|
||||||
{
|
{
|
||||||
name: 'Admin',
|
name: 'Admin',
|
||||||
slug: 'admin',
|
slug: 'admin',
|
||||||
|
|
@ -39,6 +45,24 @@ const packages = [
|
||||||
slug: 'mcp',
|
slug: 'mcp',
|
||||||
description: 'Model Context Protocol server for AI agent integration',
|
description: 'Model Context Protocol server for AI agent integration',
|
||||||
icon: '🤖'
|
icon: '🤖'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'Commerce',
|
||||||
|
slug: 'commerce',
|
||||||
|
description: 'Billing, subscriptions, and payment processing with BTCPay and Stripe',
|
||||||
|
icon: '💳'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'Content',
|
||||||
|
slug: 'content',
|
||||||
|
description: 'Headless CMS with AI generation, revision history, and webhooks',
|
||||||
|
icon: '📝'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'Developer',
|
||||||
|
slug: 'developer',
|
||||||
|
description: 'Admin developer tools for debugging, monitoring, and server management',
|
||||||
|
icon: '🛠️'
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|
||||||
|
|
|
||||||
48
docs/packages/tenant/index.md
Normal file
48
docs/packages/tenant/index.md
Normal file
|
|
@ -0,0 +1,48 @@
|
||||||
|
---
|
||||||
|
title: Tenant Package
|
||||||
|
navTitle: Tenant
|
||||||
|
navOrder: 10
|
||||||
|
---
|
||||||
|
|
||||||
|
# Tenant Package
|
||||||
|
|
||||||
|
Multi-tenancy, user management, and entitlement systems for the Host UK platform.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The `core-tenant` package is the foundational tenancy layer that provides workspace isolation, user authentication, and feature access control.
|
||||||
|
|
||||||
|
## Core Concepts
|
||||||
|
|
||||||
|
### Tenant Hierarchy
|
||||||
|
|
||||||
|
```
|
||||||
|
User
|
||||||
|
├── owns Workspaces (can own multiple)
|
||||||
|
│ ├── has WorkspacePackages (entitlements)
|
||||||
|
│ ├── has Boosts (temporary limit increases)
|
||||||
|
│ ├── has Members (users with roles/permissions)
|
||||||
|
│ ├── has Teams (permission groups)
|
||||||
|
│ └── owns Namespaces (product boundaries)
|
||||||
|
└── owns Namespaces (personal, not workspace-linked)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Workspaces** - Primary tenant boundary (organisations, teams)
|
||||||
|
- **Namespaces** - Product-level isolation within or across workspaces
|
||||||
|
- **Entitlements** - Feature access control and usage limits
|
||||||
|
- **User management** - Authentication, 2FA, and membership
|
||||||
|
- **Teams** - Permission groups within workspaces
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
composer require host-uk/core-tenant
|
||||||
|
```
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
- [Architecture](./architecture) - Technical architecture
|
||||||
|
- [Entitlements](./entitlements) - Feature access and limits
|
||||||
|
- [Security](./security) - Tenant isolation and security
|
||||||
Loading…
Add table
Reference in a new issue