276ed71f31
Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
185 lines
3.8 KiB
Markdown
185 lines
3.8 KiB
Markdown
# 🎯 DSS Admin UI Test Automation - START HERE
|
||
|
||
**Welcome!** This document gets you running tests in 30 seconds.
|
||
|
||
---
|
||
|
||
## What This Is
|
||
|
||
Complete automated testing for the DSS Admin UI:
|
||
- ✅ **51 components** load successfully
|
||
- ✅ **5 categories** interact correctly
|
||
- ✅ **79+ API endpoints** are functional
|
||
- ✅ **373+ test cases** verify everything works
|
||
|
||
---
|
||
|
||
## Fastest Start (30 Seconds)
|
||
|
||
```bash
|
||
cd /home/overbits/dss
|
||
.dss/run_all_tests.sh
|
||
```
|
||
|
||
Done! Results appear in `~/.dss/test-logs/`
|
||
|
||
---
|
||
|
||
## What Happens
|
||
|
||
The script will:
|
||
1. ✅ Check you have Python & pytest
|
||
2. ✅ Start the dev server (if needed)
|
||
3. ✅ Run Phase 1: Load all 51 components
|
||
4. ✅ Run Phase 2: Test component interactions
|
||
5. ✅ Run Phase 3: Test 79+ API endpoints
|
||
6. ✅ Generate HTML reports
|
||
7. ✅ Show summary
|
||
|
||
**Duration:** 10-20 minutes
|
||
**Pass Rate:** 95%+ expected
|
||
|
||
---
|
||
|
||
## View Results
|
||
|
||
After tests finish:
|
||
|
||
```bash
|
||
open .dss/test-logs/phase1-report.html
|
||
open .dss/test-logs/phase2-report.html
|
||
open .dss/test-logs/phase3-report.html
|
||
```
|
||
|
||
Or view raw logs:
|
||
```bash
|
||
tail .dss/test-logs/phase1-smoke-test.log
|
||
```
|
||
|
||
---
|
||
|
||
## Setup (One-Time, 2 Minutes)
|
||
|
||
If tests fail because of missing tools:
|
||
|
||
```bash
|
||
# Install Python tools
|
||
pip3 install pytest pytest-playwright pytest-asyncio httpx
|
||
|
||
# Install browsers
|
||
python3 -m playwright install
|
||
```
|
||
|
||
That's it!
|
||
|
||
---
|
||
|
||
## Common Commands
|
||
|
||
```bash
|
||
# Run everything
|
||
.dss/run_all_tests.sh
|
||
|
||
# Run just Phase 1 (component loading)
|
||
pytest .dss/test_smoke_phase1.py -v
|
||
|
||
# Run just Phase 2 (component interactions)
|
||
pytest .dss/test_category_phase2.py -v
|
||
|
||
# Run just Phase 3 (API endpoints)
|
||
pytest .dss/test_api_phase3.py -v
|
||
|
||
# Test one component
|
||
pytest .dss/test_smoke_phase1.py -k ds-shell -v
|
||
|
||
# Test one category
|
||
pytest .dss/test_category_phase2.py::TestAdminCategory -v
|
||
|
||
# Run 3x faster (parallel)
|
||
pytest .dss/test_*.py -n auto -v
|
||
|
||
# Debug mode (stop on error)
|
||
pytest .dss/test_*.py -x -v
|
||
```
|
||
|
||
---
|
||
|
||
## Need Help?
|
||
|
||
| Question | File |
|
||
|----------|------|
|
||
| "How do I run tests?" | 👉 `QUICK_START.md` |
|
||
| "What tests what?" | 👉 `TEST_AUTOMATION_README.md` |
|
||
| "How does this work?" | 👉 `TEST_AUTOMATION_IMPLEMENTATION_COMPLETE.md` |
|
||
| "File index?" | 👉 `INDEX.md` |
|
||
| "What was fixed?" | 👉 `FINAL_IMPLEMENTATION_REPORT.md` |
|
||
|
||
---
|
||
|
||
## What Gets Tested
|
||
|
||
| Phase | What | How Many | Time |
|
||
|-------|------|----------|------|
|
||
| 1️⃣ | Components load | 51 | 5-10 min |
|
||
| 2️⃣ | Interactions work | 5 categories | 3-5 min |
|
||
| 3️⃣ | API endpoints | 79+ | 2-3 min |
|
||
|
||
---
|
||
|
||
## Expected Results
|
||
|
||
✅ All tests pass (95%+ pass rate)
|
||
✅ Components load without errors
|
||
✅ API endpoints respond correctly
|
||
✅ HTML reports show everything green
|
||
|
||
If something fails, check `TEST_AUTOMATION_README.md` Troubleshooting section.
|
||
|
||
---
|
||
|
||
## Files Here
|
||
|
||
```
|
||
.dss/
|
||
├── 00_START_HERE.md 👈 You are here
|
||
├── QUICK_START.md Quick reference
|
||
├── TEST_AUTOMATION_README.md Complete guide
|
||
├── INDEX.md File index
|
||
├── run_all_tests.sh Run this!
|
||
├── test_smoke_phase1.py Component tests
|
||
├── test_category_phase2.py Interaction tests
|
||
├── test_api_phase3.py API tests
|
||
└── test-logs/ Results go here
|
||
```
|
||
|
||
---
|
||
|
||
## Summary
|
||
|
||
**Goal:** Verify all 51 components and 79+ APIs work
|
||
**Solution:** 3-phase automated test suite
|
||
**Framework:** Pytest-Playwright (Python)
|
||
**Run:** `.dss/run_all_tests.sh`
|
||
**Results:** HTML reports in `.dss/test-logs/`
|
||
|
||
---
|
||
|
||
## Go!
|
||
|
||
```bash
|
||
cd /home/overbits/dss
|
||
.dss/run_all_tests.sh
|
||
```
|
||
|
||
Tests run. Coffee break. Check results when done.
|
||
|
||
---
|
||
|
||
**Questions?** → See `QUICK_START.md`
|
||
**Details?** → See `TEST_AUTOMATION_README.md`
|
||
**Status?** → See `TEST_AUTOMATION_IMPLEMENTATION_COMPLETE.md`
|
||
|
||
---
|
||
|
||
**Status: ✅ READY TO RUN**
|