YouVet — Project Overview

Что за продукт

Клиника подключается к сервису и получает два инструмента:

• Telegram Mini App — для клиентов. Владельцы питомцев видят информацию о клинике (лого, баннер, телефон, адрес), читают статьи по первой помощи, смотрят врачей и расписание, записываются на груминг.
• Веб-панель (admin) — для персонала клиники. Редактор ведёт контент, администратор управляет врачами, пользователями и информацией о клинике, грумер — своими записями.

Мультитенантность: одна инсталляция сервера обслуживает несколько клиник через clinic_id во всех таблицах. Добавить клинику = новая строка в clinics, никакого рефакторинга не требуется.

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

Стек технологий

Backend Go

Admin Panel React 19 TypeScript

Telegram Mini App React 18 TypeScript

Инфраструктура

Архитектура бэкенда

Слоёная архитектура: HTTP → Middleware → Handler → Repository → PostgreSQL

API — два контекста

Публичные эндпоинты Mini App

Admin эндпоинты (JWT)

База данных — 8 миграций

Ролевая модель

Пакет @you-vet/types

Общий TypeScript пакет (packages/types/) — единый источник моделей данных для admin и app.

import type { Doctor, GroomingBreed, Article } from '@you-vet/types';

Файлы: animals.ts, articles.ts, doctors.ts, grooming.ts, users.ts, index.ts

Локальная разработка

Требования

• Node.js 22+, npm
• Go 1.25+
• Docker + docker-compose

Запуск

# 1. Клонировать и поставить зависимости
git clone https://github.com/bospur/you_vet.git
cd you_vet
npm install

# 2. Настроить окружение для сервера
cp apps/server/.env.example apps/server/.env
# Отредактировать .env: задать BOT_TOKEN, JWT_SECRET, пароли

# 3. Запустить базу данных и сервер
docker compose up -d
# Go сервер автоматически применит миграции при старте

# 4. Запустить фронтенд (в отдельном терминале)
cp apps/admin/.env.example apps/admin/.env.local  # задать VITE_API_URL=http://localhost:8080
cp apps/app/.env.example apps/app/.env.local      # задать VITE_CLINIC_SLUG
npm run dev   # turbo запустит admin и app параллельно

Переменные окружения

apps/server/.env

apps/admin/.env.local

apps/app/.env.local

Turborepo команды

# Из корня монорепо
npm run dev      # запускает admin и app параллельно (turbo dev)
npm run build    # сборка всех приложений с учётом зависимостей
npm run lint     # линтинг всех приложений

Git workflow

Bospur  ← prod, только через PR (никогда не пушить напрямую)
dev     ← интеграция, только через PR
feature/*, fix/*, chore/*  ← рабочие ветки

Стандартный цикл:

1. Создать ветку от dev: git checkout -b feature/my-feature dev
2. Написать код, закоммитить
3. PR → dev
4. После тестирования на dev — PR dev → Bospur

CI/CD

Три GitHub Actions workflow в .github/workflows/, каждый триггерится только при изменениях своего приложения:

Секреты в GitHub Repository Settings: VPS_HOST, VPS_USER, VPS_SSH_KEY, VITE_API_URL, VITE_CLINIC_SLUG

Деплой на VPS

Паттерны в коде

Backend (Go) — типичный handler

func (h *Handler) GetDoctors(w http.ResponseWriter, r *http.Request) {
    claims := middleware.ClaimsFromContext(r.Context())  // JWT из контекста
    doctors, err := h.repo.GetDoctors(r.Context(), claims.ClinicID)
    if err != nil {
        http.Error(w, "internal error", http.StatusInternalServerError)
        return
    }
    json.NewEncoder(w).Encode(doctors)
}

Admin (React) — useQuery + useMutation

const { data: doctors } = useQuery({
    queryKey: ['doctors'],
    queryFn: getDoctors,
});

const deleteMutation = useMutation({
    mutationFn: deleteDoctor,
    onSuccess: () => queryClient.invalidateQueries({ queryKey: ['doctors'] }),
});

Mini App (React) — публичный API без авторизации

// Данные из публичного API
const { data } = useQuery({
    queryKey: ['doctors'],
    queryFn: () => api.get(`/api/clinics/${CLINIC_SLUG}/doctors`),
});

// Telegram BackButton — управляется нативно через Telegram.WebApp
// показывается на всех экранах кроме "/"

Mini App — архитектура экранов

Все экраны обёрнуты в AppLayout (React Router nested route) — постоянный хедер с лого клиники, названием и кнопкой звонка. Данные клиники фетчатся один раз в AppLayout и передаются дочерним экранам через useOutletContext().

// AppLayout.tsx — лейаут верхнего уровня
<Route element={<AppLayout />}>
  <Route path="/" element={<HomeScreen />} />
  <Route path="/doctors" element={<DoctorsScreen />} />
  ...
</Route>

// HomeScreen.tsx — получает данные клиники от лейаута
const info = useOutletContext<ClinicInfo | null>();

Статус готовности к запуску

Документация в репо

YouVet · github.com/bospur/you_vet · вопросы — в Issues или напрямую