Social Graph Builder

Построитель социального графа: импорт контактов, визуализация связей, CRUD, карта сети.

По умолчанию приложение работает в режиме local-first: данные хранятся в браузере (IndexedDB), backend для обычной работы не обязателен.

Стек

Слой	Технология
Frontend	Vue 3 + Vite + Pinia
Локальное хранилище	IndexedDB (Dexie)
Backend API (опционально)	Django 4.2 + DRF
БД backend	SQLite
Граф / карта	vis-network
Dev-запуск	Docker Compose
Production	Docker Compose + прокси на хосте

Режимы данных

Переключатель: VITE_DATA_MODE (задаётся при сборке фронта).

Режим	Описание
local (по умолчанию)	IndexedDB в браузере, максимум конфиденциальности
remote	Django API + SQLite на сервере
hybrid	зарезервирован для будущей синхронизации

Пример для production: см. deploy/.env.prod.example.

Быстрый старт (разработка)

git clone <repo>
cd social-graph
docker compose up --build

• Frontend (Vite): http://localhost:5173
• Backend API: http://localhost:8000/api/ (для remote или legacy)

Страницы: /graph, /map, /contacts, /import.

Архитектура frontend

views / features / components
       ↓
Pinia store (orchestration)
       ↓
application/usecases + application/services
       ↓
infrastructure/repositories  →  local (IndexedDB) | remote (REST)
       ↓
core/pluginRegistry + plugins/* (optional extensions)
       ↓
changelog + syncAdapter (hybrid-ready)

API v1: /api/v1/ (legacy /api/ сохранён). OpenAPI: /api/v1/docs/.

Плагины: VITE_ENABLED_PLUGINS=tags (frontend), ENABLED_PLUGINS=tags (backend).

Документация для авторов плагинов: docs/PLUGIN_AUTHOR_GUIDE.md.

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

social-graph/
├── backend/                 # Django API (опционально)
│   ├── contacts/
│   ├── config/
│   ├── Dockerfile           # dev
│   └── Dockerfile.prod      # gunicorn
├── frontend/
│   ├── src/
│   │   ├── application/usecases/
│   │   ├── infrastructure/  # db, repositories, sync, config
│   │   ├── domain/
│   │   ├── views/           # Graph, NetworkMap, Contacts, Import
│   │   ├── stores/
│   │   └── components/
│   ├── Dockerfile           # dev (Vite)
│   ├── Dockerfile.prod      # build + nginx
│   └── nginx.conf
├── deploy/                  # production: Apache, env, инструкции
├── docker-compose.yml       # dev
└── docker-compose.prod.yml  # production

API endpoints (backend, режим remote)

Метод	URL	Описание
GET/POST	/api/contacts/	Список / создание контактов
GET/PATCH/DELETE	/api/contacts/{id}/	Контакт по ID
GET/POST	/api/relations/	Список / создание связей
DELETE	/api/relations/{id}/	Удалить связь
GET	/api/graph/	Граф для vis.js
GET	/api/network-map-graph/	Граф карты сети
GET	/api/relation-types/	Типы связей
GET	/api/network-map-choices/	Справочники карты
GET	/api/v1/meta/choices/	Все справочники (типы связей, сферы, круги)
GET	/api/v1/plugins/	Манифест включённых плагинов
POST	/api/import/	Импорт CSV/JSON/vCard (legacy)

В режиме local импорт и бэкап выполняются в браузере (экран Импорт).

Импорт и бэкап (local-first)

• CSV / JSON / vCard (.vcf) — экран «Импорт», парсинг на клиенте.
• Экспорт / импорт бэкапа — JSON или зашифрованный .sgpkg (WebCrypto, пароль опционален).

Production

Подробно: deploy/README.md.

git clone <repo> /opt/social-graph && cd /opt/social-graph
cp deploy/.env.prod.example deploy/.env.prod
docker compose -f docker-compose.prod.yml --env-file deploy/.env.prod up -d --build frontend
# прокси на хосте → http://127.0.0.1:8080

Схема: прокси на хосте (Apache/nginx) → контейнер frontend (nginx); backend — только при VITE_DATA_MODE=remote.

Запуск без Docker

Backend:

cd backend
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

Frontend:

cd frontend
npm install
npm run dev

В vite.config.js прокси /api указывает на http://backend:8000.
Без Docker замените на http://localhost:8000.

Для local-first backend не нужен.

Тесты

cd frontend && npm test
# или в контейнере:
docker compose exec frontend npm test -- --run

Планируемые фичи

• Авторизация (Django auth + JWT)
• Теги/группы контактов
• Синхронизация и shared-workspace
• Поиск по организации и должности
• История изменений контакта
• Уведомления / дни рождения