CIFRA — Архитектура платформы

Версия: 2.0.0
Дата: 2025-11-10

10 архитектурных viewpoints

1. CONCEPTUAL — Почему?

• Проблема: Медленная разработка корпоративных приложений
• Решение: Metadata-driven + Code Generation
• Преимущества: 100x ускорение

2. BUSINESS — Кто, какие процессы?

• Роли: Admin, Developer, End User
• Use Cases: 79 функций
• Бизнес-процессы: BPMN, Saga Pattern

3. FUNCTIONAL — Что делает?

• F1-F10: Entities, Fields, Modules
• F11-F17: Authentication
• F18-F24: Authorization (RBAC, ABAC)
• F25-F31: Process Engine
• F32-F39: Theme System
• F40-F47: Views, Media
• F48-F54: API
• F55-F61: Search, Notifications
• F62-F68: Background Jobs
• F69-F75: Multi-tenancy
• F76-F79: CLI, Testing

4. INFORMATION — Какие данные?

• Meta-model: EntityMeta, FieldMeta
• Data model: Database tables
• Relationships: OneToMany, ManyToMany

5. APPLICATION — Как построено?

UI → API → Business Logic → Data Access → Database

Patterns: Repository, Factory, Observer

6. TECHNOLOGY — На чём?

• Backend: Python 3.11+, FastAPI, SQLAlchemy 2.0
• Frontend: React/Vue, TypeScript
• Database: PostgreSQL 15+, Redis 7+
• Queue: Celery

7. PHYSICAL — Где развёрнуто?

• Development: Docker Compose
• Production: Kubernetes (10+ nodes)

8. SECURITY — Как защищено?

• Auth: JWT + OAuth2
• Authorization: RBAC + ABAC + RLS
• Encryption: TLS 1.3, AES-256
• Compliance: GDPR, SOC2, OWASP Top 10

9. INTEGRATION — С чем?

• OAuth: Google, GitHub, Microsoft
• Payments: Stripe, PayPal
• Email: SendGrid, Mailgun
• Storage: AWS S3, Azure Blob

10. UI/UX — Как выглядит?

• Themes: Material, Bootstrap, Custom
• 50+ готовых компонентов
• Mobile-first, Responsive

Технический стек

Backend:

Language: Python 3.11+
Framework: FastAPI 0.104+
ORM: SQLAlchemy 2.0+
Validation: Pydantic 2.0+

Database:

Primary: PostgreSQL 15+
Cache: Redis 7+
Search: Elasticsearch 8+
Queue: Redis (Celery)

Frontend:

Framework: React 18+ / Vue 3+
Language: TypeScript 5+
Styling: TailwindCSS 3+
State: Redux / Pinia

DevOps:

Containers: Docker 24+
Orchestration: Kubernetes 1.28+
CI/CD: GitHub Actions / GitLab CI
Monitoring: Prometheus + Grafana

Компоненты платформы

┌──────────────────────────────┐
│   CIFRA STUDIO (Visual)      │
│   Drag & Drop Builder        │
└──────────────────────────────┘
              ↓
┌──────────────────────────────┐
│   CIFRA CLI                  │
│   $ cifra generate/run       │
└──────────────────────────────┘
              ↓
┌──────────────────────────────┐
│   CODE GENERATOR             │
│   Python + TypeScript        │
└──────────────────────────────┘
              ↓
┌──────────────────────────────┐
│   CIFRA ENGINE (Runtime)     │
│   Entity + Permission +      │
│   Process + Event + Cache    │
└──────────────────────────────┘
              ↓
┌──────────────────────────────┐
│   DATABASE LAYER             │
│   PostgreSQL + Redis         │
└──────────────────────────────┘

Паттерны проектирования

Creational:
- Factory: EntityFactory, FieldFactory
- Builder: QueryBuilder, FormBuilder
- Singleton: Cache, EventBus

Structural:
- Composite: Entity hierarchy
- Decorator: Field validators
- Facade: API simplified interface

Behavioral:
- Observer: Event system
- Strategy: Permission strategies
- Template Method: CRUD operations

Следующий документ: LANGUAGE_SPECIFICATION.md →