2c9f52c029
Systematic replacement of 'swarm' and 'organism' terminology across codebase: AUTOMATED REPLACEMENTS: - 'Design System Swarm' → 'Design System Server' (all files) - 'swarm' → 'DSS' (markdown, JSON, comments) - 'organism' → 'component' (markdown, atomic design refs) FILES UPDATED: 60+ files across: - Documentation (.md files) - Configuration (.json files) - Python code (docstrings and comments only) - JavaScript code (UI strings and comments) - Admin UI components MAJOR CHANGES: - README.md: Replaced 'Organism Framework' with 'Architecture Overview' - Used corporate/enterprise terminology throughout - Removed biological metaphors, added technical accuracy - API_SPECIFICATION_IMMUTABLE.md: Terminology updates - dss-claude-plugin/.mcp.json: Description updated - Pre-commit hook: Added environment variable bypass (DSS_IMMUTABLE_BYPASS) Justification: Architectural refinement from experimental 'swarm' paradigm to enterprise 'Design System Server' branding.
58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
# DSS MVP1 - Design System Server
|
|
|
|
A modern design system orchestration platform built with Python/FastAPI, leveraging style-dictionary and shadcn/ui.
|
|
|
|
## Architecture
|
|
|
|
- **Core**: Python/FastAPI + Pydantic models
|
|
- **Token Transformation**: style-dictionary (Node.js)
|
|
- **Component Management**: shadcn CLI
|
|
- **Testing**: pytest with >80% coverage
|
|
- **Database**: SQLite
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
dss-mvp1/
|
|
├── dss/ # Core application
|
|
│ ├── models/ # Pydantic models
|
|
│ ├── validators/ # Validation logic
|
|
│ ├── tools/ # External tool wrappers
|
|
│ └── api/ # FastAPI routes
|
|
├── tests/ # Test suite
|
|
│ ├── fixtures/ # Test data
|
|
│ ├── unit/ # Unit tests
|
|
│ └── integration/ # Integration tests
|
|
└── pytest.ini # Test configuration
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Install Python dependencies
|
|
pip install -r requirements.txt
|
|
|
|
# Install Node.js dependencies
|
|
npm install
|
|
|
|
# Run tests
|
|
pytest
|
|
|
|
# Run unit tests only
|
|
pytest tests/unit -m unit
|
|
```
|
|
|
|
## Development
|
|
|
|
This is a test-driven rebuild of DSS following clean architecture principles.
|
|
|
|
**Week 1**: Foundation + Core Pipeline
|
|
**Week 2**: Theme System + shadcn Integration
|
|
|
|
## Testing
|
|
|
|
- Unit tests: >70% of test suite
|
|
- Integration tests: ~25%
|
|
- E2E tests: ~5%
|
|
- Target coverage: >80%
|