Initial commit: Clean DSS implementation

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
This commit is contained in:
Digital Production Factory
2025-12-09 18:45:48 -03:00
commit 276ed71f31
884 changed files with 373737 additions and 0 deletions

75
docs/GLOSSARY.md Normal file
View File

@@ -0,0 +1,75 @@
# DSS Corporate Terminology Glossary
> **Quick Reference**: Enterprise terminology for the Design System Swarm
---
## Atomic Design Hierarchy (5 Levels)
| Level | Term | Description | Examples |
|-------|------|-------------|----------|
| 1 | **Tokens** | Design variables - raw values | `--color-primary`, `--spacing-md`, `--font-size-base` |
| 2 | **Primitives** | Base UI elements - indivisible | Button, Input, Icon, Badge, Label |
| 3 | **Components** | Composite UI - combining primitives | FormField (label+input+error), Card (image+title+actions) |
| 4 | **Layouts** | Page structure patterns | PageShell, DashboardGrid, SidebarLayout |
| 5 | **Views** | Complete screens with content | TokenExplorer, FigmaSync, ComponentAudit |
---
## Architecture Layers (7 Layers)
| Layer | Name | Code Modules | Responsibility |
|-------|------|--------------|----------------|
| 1 | **Core** | `storage/`, `settings.py` | Configuration, schemas, database, event bus |
| 2 | **Ingestion** | `ingest/` | File parsing, token extraction (CSS, Figma, JSON, Tailwind) |
| 3 | **Validation** | `validators/` | Schema checking, linting, error detection |
| 4 | **State** | `models/` | Token models, stores, data flow |
| 5 | **Processing** | `tools/`, `analyze/` | Transformations, analysis, style-dictionary |
| 6 | **Presentation** | `storybook/`, `admin-ui/` | UI components, documentation, Storybook |
| 7 | **Integration** | `api/`, MCP server | APIs, MCP tools, webhooks, CLI |
---
## Term Translations
### From Legacy Biological to Corporate
| Deprecated Term | Corporate Term | Context |
|-----------------|----------------|---------|
| organism | module | Complex UI section |
| molecule | component | Composite UI element |
| atom | primitive / token | Base element or variable |
| heart | core / database | Persistent storage layer |
| brain | analyzer / validation | Pattern detection and quality |
| nervous system | integration layer | APIs, MCP, webhooks |
| digestive system | ingestion pipeline | Token extraction from sources |
| circulatory system | token distribution / state | Data flow through system |
| metabolic system | transformation engine / processing | Format conversion |
| endocrine system | theme controller | Theming and adaptation |
| immune system | validation guard | Quality assurance |
| sensory organs | asset manager | Icons, images, visual assets |
| skin | presentation layer | UI, Storybook, docs |
| skeleton | schema framework | Naming conventions, structure |
---
## Quick Phrases
### Instead of... Say...
| Don't Say | Say Instead |
|-----------|-------------|
| "Feed the organism" | "Ingest tokens" |
| "Check the immune system" | "Run validation" |
| "The heart is healthy" | "Database is operational" |
| "Nervous system response" | "API response" |
| "The brain detected a pattern" | "Analyzer detected a pattern" |
| "Organism health check" | "System status check" |
---
## See Also
- [First Principles](./principles/FIRST_PRINCIPLES.md) - 7 foundational truths
- [Architecture Overview](./architecture/OVERVIEW.md) - 7-layer system design
- [Atomic Hierarchy](./principles/ATOMIC_HIERARCHY.md) - Composition rules