second-mind-aep/💡 Идеи/💡 Проекты/ERP для малых производств/Архитектура-MVP.md

Архитектура MVP: ERP для мастеров

🏗️ Общая архитектура

graph TB
    subgraph "Frontend"
        A[Angular PWA]
        B[QR Scanner]
    end
    
    subgraph "Backend"
        C[Go Core Service (REST)]
    end
    
    subgraph "Infrastructure"
        E[PostgreSQL]
    end
    
    A <--> C
    B --> A
    C <--> E
    
    style A fill:#ff9999
    style C fill:#99ccff
    style E fill:#ffcc99

---

🛠️ Технологический стек

Backend (Go)

• Framework: Gin (легкий и быстрый)
• Database: PostgreSQL
• Authentication: JWT
• Validation: validator
• API: REST + OpenAPI (Swagger)

Frontend (Angular PWA)

• Framework: Angular 17+
• PWA: @angular/service-worker (только кэш статики)
• QR Scanner: @zxing/ngx-scanner
• UI: Angular Material + Tailwind CSS
• State Management: локальные сервисы (без NgRx на MVP)

Infrastructure

• Containerization: Docker
• Orchestration: Docker Compose
• Web server (опционально): Nginx для фронтенда
• Security: HTTPS, CORS, JWT
• Monitoring: структурированное логирование (метрики Post‑MVP)

---

📊 Структура базы данных

ER-диаграмма

erDiagram
    organizations {
        uuid id PK
        varchar name
        varchar type
        jsonb settings
        timestamp created_at
    }
    
    users {
        uuid id PK
        uuid organization_id FK
        varchar email
        varchar role
        timestamp created_at
    }
    
    storage_locations {
        uuid id PK
        uuid organization_id FK
        uuid parent_id FK
        varchar name
        varchar address
        varchar type
        jsonb coordinates
        varchar qr_code
        timestamp created_at
    }
    
    items {
        uuid id PK
        uuid organization_id FK
        varchar name
        text description
        varchar category
        timestamp created_at
    }
    
    item_placements {
        uuid id PK
        uuid organization_id FK
        uuid item_id FK
        uuid location_id FK
        integer quantity
        timestamp created_at
    }
    
    organizations ||--o{ users : "has"
    organizations ||--o{ storage_locations : "has"
    organizations ||--o{ items : "has"
    organizations ||--o{ item_placements : "has"
    
    storage_locations ||--o{ storage_locations : "parent-child"
    storage_locations ||--o{ item_placements : "contains"
    
    items ||--o{ item_placements : "placed_in"

Основные таблицы

-- Организации
CREATE TABLE organizations (
    id UUID PRIMARY KEY,
    name VARCHAR(255) NOT NULL,
    type VARCHAR(100),
    settings JSONB,
    created_at TIMESTAMP DEFAULT NOW()
);

-- Пользователи
CREATE TABLE users (
    id UUID PRIMARY KEY,
    organization_id UUID REFERENCES organizations(id),
    email VARCHAR(255) UNIQUE NOT NULL,
    role VARCHAR(50) DEFAULT 'user',
    created_at TIMESTAMP DEFAULT NOW()
);

-- Места хранения
CREATE TABLE storage_locations (
    id UUID PRIMARY KEY,
    organization_id UUID REFERENCES organizations(id),
    parent_id UUID REFERENCES storage_locations(id),
    name VARCHAR(255) NOT NULL,
    address VARCHAR(100) NOT NULL,
    type VARCHAR(50) NOT NULL,
    coordinates JSONB,
    qr_code VARCHAR(255),
    created_at TIMESTAMP DEFAULT NOW()
);

-- Товары
CREATE TABLE items (
    id UUID PRIMARY KEY,
    organization_id UUID REFERENCES organizations(id),
    name VARCHAR(255) NOT NULL,
    description TEXT,
    category VARCHAR(100),
    created_at TIMESTAMP DEFAULT NOW()
);

-- Размещение товаров
CREATE TABLE item_placements (
    id UUID PRIMARY KEY,
    organization_id UUID REFERENCES organizations(id),
    item_id UUID REFERENCES items(id),
    location_id UUID REFERENCES storage_locations(id),
    quantity INTEGER DEFAULT 1,
    created_at TIMESTAMP DEFAULT NOW()
);

---

🔌 API Endpoints

Core Service (Go) - REST API

# Аутентификация
POST   /api/auth/login
POST   /api/auth/register

# Организации
GET    /api/organizations/:id
PUT    /api/organizations/:id

# Места хранения
GET    /api/locations
POST   /api/locations
GET    /api/locations/:id
PUT    /api/locations/:id
DELETE /api/locations/:id

# Товары
GET    /api/items
POST   /api/items
GET    /api/items/:id
PUT    /api/items/:id
DELETE /api/items/:id

# Операции
POST   /api/operations/place-item
POST   /api/operations/move-item
GET    /api/operations/search

# Шаблоны
GET    /api/templates
POST   /api/templates/:id/apply

🚀 Развертывание

Docker Compose (MVP)

version: '3.8'
services:
  core-service:
    build: ./core-service
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres
      - JWT_SECRET=your-secret
    depends_on:
      - postgres

  frontend:
    build: ./frontend
    ports:
      - "3000:80"
    depends_on:
      - core-service

  postgres:
    image: postgres:15
    environment:
      - POSTGRES_DB=erp_mvp
      - POSTGRES_USER=erp_user
      - POSTGRES_PASSWORD=erp_pass
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Структура проекта

graph TD
    A[erp-mvp/] --> B[core-service/]
    A --> C[doc-service/]
    A --> D[frontend/]
    A --> E[proto/]
    A --> F[docker-compose.yml]
    
    B --> B1[cmd/]
    B --> B2[internal/]
    B --> B3[pkg/]
    B --> B4[proto/]
    B --> B5[Dockerfile]
    
    C --> C1[app/]
    C --> C2[templates/]
    C --> C3[proto/]
    C --> C4[Dockerfile]
    
    D --> D1[src/]
    D --> D2[angular.json]
    D --> D3[Dockerfile]
    
    E --> E1[core.proto]
    E --> E2[document.proto]
    E --> E3[events.proto]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0
    style E fill:#fce4ec

---

📚 Конкретные библиотеки и фреймворки

Core Service (Go)

// Основные зависимости
go.mod:
- github.com/gin-gonic/gin v1.9.1          // HTTP framework
- github.com/golang-jwt/jwt/v5 v5.0.0      // JWT authentication
- github.com/lib/pq v1.10.9                // PostgreSQL driver
- github.com/go-playground/validator/v10   // Validation
- google.golang.org/grpc v1.58.0           // gRPC client/server
- github.com/swaggo/gin-swagger v1.6.0     // API documentation
- github.com/redis/go-redis/v9 v9.2.1      // Redis client

Document Service (Python)

# requirements.txt
fastapi==0.104.1              # Web framework
uvicorn==0.24.0               # ASGI server
reportlab==4.0.4              # PDF generation
weasyprint==60.1              # HTML to PDF
python-docx==1.1.0            # Word documents
openpyxl==3.1.2               # Excel files
jinja2==3.1.2                 # Templates
redis==5.0.1                  # Redis client
grpcio==1.59.0                # gRPC
protobuf==4.24.4              # Protocol Buffers
pydantic==2.4.2               # Data validation

Frontend (Angular)

// package.json
{
  "dependencies": {
    "@angular/core": "^17.0.0",
    "@angular/material": "^17.0.0",
    "@angular/service-worker": "^17.0.0",
    "@zxing/ngx-scanner": "^3.0.0",
    "@ngrx/store": "^17.0.0",
    "@ngrx/effects": "^17.0.0",
    "tailwindcss": "^3.3.0",
    "rxjs": "^7.8.0"
  }
}

📊 Мониторинг

Логирование

• Go: logrus или zerolog для structured logging
• Python: structlog для structured logging
• Frontend: Angular logging service
• Correlation ID для отслеживания запросов через все сервисы

Метрики

• Prometheus для сбора метрик
• Grafana для визуализации
• Время отклика API по сервисам
• Количество ошибок и их типы
• Активные пользователи и операции

Алерты

• Высокое время отклика (>500ms)
• Высокий процент ошибок (>5%)
• Недоступность сервисов
• Проблемы с генерацией документов