109 lines
2.4 KiB
Markdown
109 lines
2.4 KiB
Markdown
---
|
|
name: dss-services
|
|
description: Manage all DSS development services (API, admin-ui, Storybook)
|
|
arguments:
|
|
- name: action
|
|
description: Action to perform (start, stop, status, restart, logs)
|
|
required: true
|
|
- name: service
|
|
description: Specific service (api, admin-ui, storybook) - optional
|
|
required: false
|
|
---
|
|
|
|
# DSS Services Command
|
|
|
|
Manage all DSS development services from a single command.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/dss-services <action> [service]
|
|
```
|
|
|
|
## Actions
|
|
|
|
| Action | Description |
|
|
|--------|-------------|
|
|
| start | Start all services (or specific service) |
|
|
| stop | Stop all services (or specific service) |
|
|
| status | Show status of all services |
|
|
| restart | Restart all services (or specific service) |
|
|
| logs | Show service logs |
|
|
|
|
## Services
|
|
|
|
| Service | Port | Description |
|
|
|---------|------|-------------|
|
|
| api | 6220 | FastAPI REST server |
|
|
| admin-ui | 6221 | Vite dev server |
|
|
| storybook | 6226 | Storybook design docs |
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Start all services
|
|
/dss-services start
|
|
|
|
# Check status
|
|
/dss-services status
|
|
|
|
# Start only the API server
|
|
/dss-services start api
|
|
|
|
# Stop Storybook
|
|
/dss-services stop storybook
|
|
|
|
# View admin-ui logs
|
|
/dss-services logs admin-ui
|
|
|
|
# Restart everything
|
|
/dss-services restart
|
|
```
|
|
|
|
## Instructions for Claude
|
|
|
|
When the user runs this command:
|
|
|
|
1. Execute: `scripts/dss-services.sh <action> [service]`
|
|
|
|
2. Present the output in a clean format
|
|
|
|
3. For `status` action, show a table with service states
|
|
|
|
4. After `start`, provide clickable URLs:
|
|
- API: http://localhost:6220
|
|
- admin-ui: http://localhost:6221
|
|
- Storybook: http://localhost:6226
|
|
|
|
## Service Details
|
|
|
|
### API Server (port 6220)
|
|
- FastAPI REST API
|
|
- Endpoints: projects, figma, health, config
|
|
- Command: `uvicorn apps.api.server:app --host 0.0.0.0 --port 6220 --reload`
|
|
- Log: `/tmp/dss-api.log`
|
|
|
|
### Admin UI (port 6221)
|
|
- Preact/Vite development server
|
|
- Design system management interface
|
|
- Command: `npm run dev`
|
|
- Log: `/tmp/dss-admin-ui.log`
|
|
|
|
### Storybook (port 6226)
|
|
- Component documentation
|
|
- Token visualization
|
|
- Command: `npm run storybook`
|
|
- Log: `/tmp/dss-storybook.log`
|
|
|
|
## Troubleshooting
|
|
|
|
If a service fails to start:
|
|
1. Check the log file: `/dss-services logs <service>`
|
|
2. Verify port is not in use: `lsof -i :<port>`
|
|
3. Check dependencies are installed
|
|
|
|
## Related Commands
|
|
|
|
- `/dss-init` - Full environment setup + initialization
|
|
- `/dss-reset` - Reset to clean state
|