Это руководство описывает повседневный рабочий процесс разработки для участия в проекте Bedrud.

Структура репозитория

bedrud/
├── server/          # Go backend
├── apps/
│   ├── web/         # React frontend (TanStack Start)
│   ├── android/     # Android app
│   ├── ios/         # iOS app
│   └── desktop/     # Desktop app (Rust + Slint)
├── agents/          # Python bot agents
├── packages/        # Shared TypeScript types
├── tools/cli/       # Deployment CLI
├── docs/            # Documentation (MkDocs)
├── Cargo.toml       # Rust workspace root
├── Makefile         # Build orchestration
└── Dockerfile       # Container build

Предварительные требования

Первоначальная настройка

git clone https://github.com/bedrud-ir/bedrud.git
cd bedrud
make init

Full-Stack разработка

Чтобы запустить весь стек локально:

make dev

Это запускает LiveKit, Go-сервер и React dev-сервер параллельно. Нажмите Ctrl+C, чтобы остановить все процессы.

Запуск сервисов по отдельности

make dev-web

make dev-server

make dev-livekit

Разработка сервера

Точка входа Go-сервера - server/cmd/server/main.go.

Добавление API-эндпоинта

1. Определите обработчик в server/internal/handlers/
2. Добавьте методы репозитория в server/internal/repository/, если нужны новые запросы к БД
3. Зарегистрируйте маршрут в настройке сервера (обычно в main.go или файле маршрутов)
4. Добавьте middleware, если эндпоинту нужна авторизация или проверка прав администратора

Изменения в базе данных

Добавляйте или изменяйте структуры моделей GORM в server/internal/models/. GORM выполняет авто-миграцию при запуске.

Документация Swagger

Аннотации API-документации используют формат swaggo. После изменений перегенерируйте:

cd server
swag init -g cmd/server/main.go

См. Архитектура сервера для полной структуры директорий и многоуровневой архитектуры.

Разработка веб-фронтенда

Фронтенд находится в apps/web/ и использует React 19 с TanStack Start.

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

Создайте новый файл в src/routes/, следуя соглашению файлового маршрутизации TanStack Router (например, src/routes/settings.tsx). Экспортируйте Route, созданный с помощью createFileRoute.

Добавление функции API-клиента

1. Добавьте функцию в src/lib/api.ts, используя authFetch
2. Определите типы TypeScript inline или в общем файле типов
3. Используйте функцию из вашего компонента маршрута, обычно через хук useQuery из TanStack Query

Проверка типов

cd apps/web
bun run check    # запуск Biome lint + проверка типов TypeScript

См. Архитектура веб-фронтенда для полной структуры и паттернов фронтенда.

Разработка для Android

make dev-android    # Открывает в Android Studio

Основные паттерны

• Все экраны - Composable-функции
• Зависимости поступают из InstanceManager через koinInject()
• Используйте collectAsState().value ?: return для обнуляемых значений StateFlow
• Навигация обрабатывается в MainActivity.kt

Сборка

make build-android-debug    # Debug APK
make build-android          # Release APK (требуется keystore)
make release-android        # Сборка + установка на устройство

См. Архитектура Android-приложения для детальной архитектуры мобильного приложения.

Разработка для iOS

make dev-ios    # Открывает в Xcode

Основные паттерны

• Представления - SwiftUI-структуры
• Зависимости поступают из InstanceManager через @EnvironmentObject
• Используйте optional binding для обнуляемых published-свойств
• Навигация использует нативный навигационный стек SwiftUI

Генерация проекта

Если вы изменили project.yml, перегенерируйте проект Xcode:

cd apps/ios
xcodegen generate

Сборка

make build-ios          # Release-архив
make build-ios-sim      # Сборка для симулятора
make export-ios         # Экспорт IPA

См. Архитектура iOS-приложения для детальной архитектуры мобильного приложения.

Разработка десктопного приложения

Десктопное приложение находится в apps/desktop/ и является Rust-крейтом в рабочей области.

Предварительные требования (Linux)

sudo apt-get install -y \
  libfontconfig1-dev libxkbcommon-dev libxkbcommon-x11-dev \
  libwayland-dev libgles2-mesa-dev libegl1-mesa-dev \
  libdbus-1-dev libsecret-1-dev \
  libasound2-dev

Для Windows требуются Visual Studio Build Tools с рабочей нагрузкой C++ (MSVC).

Запуск

make dev-desktop    # cargo run -p bedrud-desktop

Сборка

make build-desktop           # оптимизированный бинарник для текущей платформы

Основные паттерны

• Весь UI определён в файлах .slint в apps/desktop/ui/; компилируется в Rust при сборке через build.rs
• apps/desktop/src/ui/bridge.rs - единственное место, где обратные вызовы Slint привязываются к логике Rust - не помещайте бизнес-логику в файлы .slint
• Используйте Weak<AppWindow> при запуске фоновых задач, которым нужно обновлять UI

См. Архитектура десктопного приложения для детальной архитектуры десктопного приложения.

Разработка бот-агентов

Агенты находятся в agents/, по одной директории на каждого агента.

cd agents/music_agent
pip install -r requirements.txt
python agent.py "http://localhost:8090/m/test-room"

Все агенты требуют запущенный сервер Bedrud для аутентификации.

CI/CD

GitHub Actions запускается при каждом пуше в main и для pull request’ов:

Сборки релизов запускаются по тегам версий (v*).

Стиль кода

• Go: Стандартное форматирование gofmt
• TypeScript/React: Biome (настроено в apps/web/biome.json)
• Kotlin: Форматирование Android Studio по умолчанию
• Swift: Форматирование Xcode по умолчанию

Тестирование

cd server
go test ./...

cd apps/web
bun run check

cd apps/android
./gradlew test

make build-ios-sim   # Собирает и запускает тесты

См. также

• Справочник Makefile - все команды сборки и разработки
• Обзор архитектуры - как компоненты работают вместе