server

package
v0.0.0-...-7e38208 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 13, 2026 License: MPL-2.0 Imports: 107 Imported by: 0

Documentation

Overview

API error handling utilities for the aiplan package. Provides functions for returning errors with appropriate HTTP status codes and logging.

Key features:

  • Standardized error response formatting.
  • Logging of API errors with context (method, URL, user).
  • Support for custom error types with status codes.
  • Handles common error scenarios like entity too large and generic API errors.

Обработка и проверка CAPTCHA-подписей для защиты от повторных атак. Содержит логику декодирования, проверки подписи и хранения подписей для предотвращения повторного использования.

Основные возможности:

  • Декодирование base64 CAPTCHA-подписей.
  • Проверка подлинности CAPTCHA с использованием ключа Altcha HMAC.
  • Хранение проверенных CAPTCHA-подписей для предотвращения повторного использования.
  • Подсчет неудачных попыток использования CAPTCHA.

Реестр фоновых cron-задач сервера.

Пакет server предоставляет функциональность для работы с Git репозиториями через файловую систему без использования базы данных.

Архитектурный принцип: Git репозитории должны быть полностью самодостаточными и хранить всю информацию в файловой системе. База данных НЕ должна использоваться для хранения метаданных Git репозиториев.

Пакет для генерации и отображения иерархического списка страниц справки (help) из директории с Markdown файлами. Преобразует структуру директории в JSON для использования в веб-интерфейсе.

Основные возможности:

  • Автоматическое обнаружение иерархии страниц справки на основе структуры директории.
  • Генерация URL для каждой страницы справки.
  • Извлечение заголовка страницы из Markdown файла.
  • Предоставление JSON представления иерархии для отображения в веб-браузере.

Пакет server предоставляет функциональность для управления пользователями, тарифами и шаблонами в системе планирования. Он включает в себя создание, обновление, удаление и получение информации о пользователях, тарифах и шаблонах, а также управление импортом данных. Также предоставляет функциональность для управления правами доступа и отправки уведомлений пользователям. Пакет предназначен для использования в административной панели системы планирования.

Основные возможности:

  • Управление пользователями: создание, обновление, удаление, получение информации о пользователях.
  • Управление тарифами: создание, обновление, удаление, получение информации о тарифах.
  • Управление шаблонами: сброс шаблонов почты к значениям по умолчанию.
  • Управление импортом: получение списка активных импортов данных.
  • Управление правами доступа: назначение ролей пользователям.
  • Отправка уведомлений: отправка уведомлений пользователям по электронной почте.

Пакет для аутентификации и авторизации пользователей в приложении AiPlan. Обеспечивает безопасный доступ к ресурсам, используя JWT, куки и капчу.

Основные возможности:

  • Аутентификация пользователей по email и паролю с использованием капчи.
  • Генерация и проверка токенов доступа (JWT) с поддержкой обновления.
  • Защита от повторных атак и блокировка аккаунтов при неудачных попытках входа.
  • Интеграция с Sesion Manager для управления сессиями пользователей.
  • Поддержка различных схем аутентификации (Basic, Bearer, Cookies).

Пакет предоставляет функциональность для управления бэкапами рабочих пространств в приложении AiPlan.

Основные возможности:

  • Экспорт бэкапов рабочих пространств в сжатом формате.
  • Импорт бэкапов рабочих пространств из MinIO и локальных файлов.
  • Обеспечение целостности и восстановления данных рабочих пространств.
  • Хранение метаданных бэкапов (дата создания, пользователь, идентификатор).

Ручки справочников проекта (Dictionary/DictionaryRow) — именованные наборы строк с атрибутами для полей типа "lookup". Управление — админ проекта, чтение строк — все участники (для селектов в карточке задачи).

Пакет server предоставляет функциональность для управления документами в системе, включая создание, редактирование, перемещение, добавление реакций и историю изменений. Он предназначен для организации и отслеживания работы с документами в рамках рабочих пространств, обеспечивая удобный интерфейс для пользователей. Пакет включает в себя механизмы для работы с версиями документов, добавления комментариев и управления правами доступа.

Пакет server предоставляет функциональность для управления формами и ответами в системе планирования. Он включает в себя создание, редактирование, получение и обработку форм, а также управление ответами на них. Пакет также предоставляет инструменты для работы с вложениями и валидации данных форм.

Основные возможности:

  • Управление формами: создание, редактирование, удаление, получение списка.
  • Управление ответами: создание, получение, удаление, обработка ответов на формы.
  • Работа с вложениями: загрузка, удаление, управление вложениями к ответам.
  • Валидация данных форм: проверка корректности введенных данных.
  • Авторизация и права доступа: проверка прав доступа пользователей к формам и ответам.
  • Интеграция с другими сервисами: возможность интеграции с другими сервисами, такими как уведомления и хранилище файлов.

Пакет server предоставляет функциональность для управления GIT.

Архитектурный принцип: Git репозитории НЕ хранятся в базе данных. Вся информация находится в файловой системе в файлах aiplan.json. База данных используется только для workspace, users и audit log (activity).

Пакет, предоставляющий API для интеграции с Jira. Позволяет запускать, отслеживать и отменять импорты данных из Jira в систему AiPlan.

Основные возможности:

  • Запуск импорта проекта из Jira.
  • Получение статуса импорта Jira.
  • Отслеживание списка импортов, инициированных пользователем.
  • Отмена запущенного импорта Jira.

Пакет server предоставляет функциональность для миграции задач между проектами в системе планирования. Он включает в себя копирование задач, обновление связанных данных (комментарии, реакции, ссылки), и обработку изменений статусов задач.

Основные возможности:

  • Копирование задач с сохранением связанных данных.
  • Обновление статусов задач при миграции.
  • Обработка связанных задач (комментарии, реакции, ссылки).
  • Поддержка миграции задач с учетом различных типов статусов и меток.

Пакет предоставляет функциональность для работы со связанными задачами в системе управления проектами. Он включает в себя операции добавления, удаления и получения списка связанных задач, а также поддержку загрузки и экспорта вложений для этих задач. Также реализована поддержка получения PDF-версии задачи.

Основные возможности:

  • Добавление связанных задач к задаче.
  • Удаление связанных задач из задачи.
  • Получение списка связанных задач.
  • Загрузка вложений для задачи.
  • Экспорт задачи в PDF-формат.

Пакет предоставляет функциональность для перенаправления пользователя на файл, хранящийся в MinIO, по имени файла или ID. Используется для интеграции с внешними сервисами, хранящими файлы в MinIO.

Основные возможности:

  • Перенаправление по имени файла или ID.
  • Обработка ошибок, включая отсутствие файла и внутренние ошибки сервера.
  • Использование gorm для работы с базой данных и поиска файлов.

Пакет предоставляет обработчики для доступа к функциональности pprof через HTTP. Позволяет получить информацию о heap, goroutine, блоках, threadcreate, командной строке, профилировании, символах, трассировке и mutex.

Пакет предоставляет функциональность для управления тегами задач в системе планирования. Включает создание, обновление, удаление и получение списков тегов, а также их связывание с проектами и пользователями.

Основные возможности:

  • Создание, обновление и удаление тегов задач.
  • Получение списка тегов задач для проекта.
  • Связывание тегов задач с проектами и пользователями.
  • Поддержка пагинации при получении списков тегов.
  • Валидация данных тегов при создании и обновлении.

Обработка редиректов для коротких ссылок на задачи и документы.

Основные возможности:

  • Редирект коротких ссылок на задачи по проектам.
  • Редирект коротких ссылок на документы.

Пакет server предоставляет функциональность для управления планированием, задачами и отслеживанием прогресса в проектах. Он включает в себя функции для создания, редактирования и просмотра задач, а также для управления пользователями и их правами доступа. Пакет также предоставляет возможности для интеграции с другими сервисами, такими как Telegram и email.

Основные возможности:

  • Управление задачами: создание, редактирование, удаление, назначение задач пользователям.
  • Управление проектами: создание, редактирование, удаление проектов, добавление пользователей в проекты.
  • Управление пользователями: создание, редактирование, удаление пользователей, назначение ролей и прав доступа.
  • Интеграция с Telegram: отправка уведомлений о задачах и событиях в Telegram.
  • Интеграция с email: отправка уведомлений о задачах и событиях по email.
  • Отслеживание прогресса: отслеживание прогресса выполнения задач и проектов.
  • Отчетность: формирование отчетов о выполненных задачах и проектах.

Пакет server предоставляет функциональность для управления рабочими пространствами, включая создание, редактирование, добавление участников, интеграции и историю изменений. Он включает в себя API для работы с рабочими пространствами, а также логику для управления пользователями и их правами доступа.

Пакет server предоставляет основные компоненты для управления планированием и задачами. Он включает в себя функциональность для работы с активностями, пользователями, проектами, рабочими местами и другими связанными данными. Также предоставляет API для интеграции с другими сервисами и внешними системами.

Основные возможности:

  • Управление активностями пользователей.
  • Работа с проектами и рабочими местами.
  • Интеграция с внешними сервисами (например, Telegram, email).
  • Генерация и обработка аватаров пользователей.
  • Поддержка различных типов данных и форматов.

Инициализация внешних зависимостей сервера: трассировка, memDB, LDAP.

Инициализация файлового хранилища (S3/minio или локальная директория).

Сервер метрик Prometheus.

Пакет предоставляет middleware для обработки поисковых фильтров в приложении AIPlan. Он извлекает ID фильтра из параметров запроса, ищет соответствующий фильтр в базе данных и передает его в контекст обработчика.

Основные возможности:

  • Получение поискового фильтра по ID из URL.
  • Поиск фильтра в базе данных.
  • Передача фильтра в контекст обработчика для дальнейшего использования.

Пакет server предоставляет структуры данных и функции для работы с планами и задачами в системе. Он включает в себя модели для создания и управления проектами, рабочими пространствами, а также для фильтрации и поиска задач.

Основные возможности:

  • Создание и настройка проектов.
  • Создание и настройка рабочих пространств.
  • Фильтрация задач по различным критериям (пространства, проекты, поиск).
  • Подготовка поисковых запросов для эффективного поиска задач.
  • Обработка даты и времени для представления дней.
  • Работа с идентификаторами задач.

Регистрация HTTP-роутов сервера.

Публичный запуск сервера: сборка инстанса (New) и его работа (Run).

Сборка и доступ к общим зависимостям HTTP-слоя.

Глобальный обработчик ошибок и цепочка middleware сервера.

Пакет server предоставляет функциональность для работы с SSH ключами пользователей через файловую систему без использования базы данных.

Архитектурный принцип: SSH ключи должны храниться в файловой системе для простоты управления и независимости от структуры БД. Все ключи хранятся в директории {GitRepositoriesPath}/.ssh-keys/ в виде JSON файлов с метаданными и одного общего файла authorized_keys для SSH сервера.

Пакет server предоставляет функциональность ограничения частоты SSH запросов (rate limiting) для защиты от brute-force атак на SSH сервер.

Rate limiter отслеживает количество попыток аутентификации с каждого IP адреса и блокирует дальнейшие попытки при превышении лимита.

Пакет server предоставляет функциональность SSH сервера для Git операций.

SSH сервер позволяет пользователям выполнять Git операции (clone, push, pull) через SSH протокол, используя аутентификацию по публичным ключам.

Архитектурные принципы: - SSH ключи хранятся в файловой системе (не в БД) - Аутентификация через authorized_keys файл - Права доступа основаны на workspace membership - Публичные репозитории: read для всех, write для членов - Приватные репозитории: read/write только для членов

Запуск встроенного SSH-сервера для Git.

Пакет предоставляет валидаторы для данных в форме, используемые в AIPlan. Он определяет различные типы валидации, такие как минимальное/максимальное значение, длина строки, проверка на целочисленность и регулярные выражения. Также включает в себя обработку различных типов полей формы, таких как текстовые поля, чекбоксы, выпадающие списки и т.д. Валидаторы могут быть настроены с использованием различных параметров, таких как минимальное/максимальное значение, регулярное выражение и список допустимых значений. Пакет также предоставляет механизм для определения последовательности валидаций, которые должны быть выполнены для каждого поля формы. Он использует структуру `FormValidateStruct` для определения конфигурации каждого валидатора и функцию `FormValidatoor` для создания карты валидаторов. Включает валидацию UUID, цветовых кодов и временных меток.

Пакет для валидации данных, используемых в AIPlan. Содержит валидаторы для различных полей, таких как имя проекта, имя рабочего пространства, идентификатор и т.д. Использует библиотеку go-playground/validator для выполнения проверок. Также включает в себя регулярные выражения для проверки соответствия формату данных. Содержит валидаторы для эмодзи статусов.

Основные возможности:

  • Валидация различных полей данных с использованием предопределенных валидаторов.
  • Настройка валидаторов для конкретных полей.
  • Использование регулярных выражений для проверки формата данных.
  • Валидация эмодзи статусов.

Index

Constants

View Source
const (
	SearchParentIssues = iota
	SearchSubIssues
	SearchBlocksIssues
	SearchBlockersIssues
	SearchLinkedIssues
)

Variables

View Source
var (
	ErrTargetProjectNotFound  = "target project not found"
	ErrMigrationIssueNotFound = "issue not found"
	ErrLabelNotFound          = "label not found"
	ErrConflictIssuesNames    = "issues with conflicted names"

	ErrAuthorNotAProjectMember = "source author not a target project member"
	ErrUserNotAProjectMember   = "you are not a target project member"
	ErrAssigneesNotFound       = "source assignees that not a members of target project"
	ErrWatchersNotFound        = "source watchers that not a members of target project"
	ErrAssigneeRoleInvalid     = "issue assignment is not allowed for assignee with current role of target project"
	ErrWatcherRoleInvalid      = "issue watching is not allowed for watcher with current role of target project"

	ErrStateNotFound  = "source state that does not exist in target project"
	ErrLabelsNotFound = "source labels that does not exist in target project"

	ErrOther = "Error"
)
View Source
var AltchaExpires time.Duration = time.Hour
View Source
var CaptchaService = NewCaptchaService()

Functions

func ActionOf

func ActionOf(c echo.Context) (engine.Action, bool)

ActionOf возвращает действие текущего роута. Второе значение false — роут не размечен: вызывающий обязан отказать в доступе, а не пропускать запрос.

func AddProfileServices

func AddProfileServices(g *echo.Group)

func BindData

func BindData(c echo.Context, key string, target interface{}) ([]string, error)

func BindDoc

func BindDoc(c echo.Context, doc *dao.Doc) (*dao.Doc, []string, error)

func BindDocComment

func BindDocComment(c echo.Context, comment *dao.DocComment) (*dao.DocComment, []string, error)

func BlockHandler

func BlockHandler() echo.HandlerFunc

BlockHandler will pass the call from /debug/pprof/block to pprof.

func CascadeUpdateChildDocsRole

func CascadeUpdateChildDocsRole(tx *gorm.DB, parentID uuid.UUID, roleField string, roleValue int) error

CascadeUpdateChildDocsRole каскадно обновляет роль (reader_role или editor_role) у всех дочерних документов у которых текущее значение роли меньше переданного.

Параметры:

  • tx - транзакция
  • parentID - идентификатор родительского документа
  • roleField - поле изменения ("reader_role" или "editor_role")
  • roleValue - значение роли

Возвращает:

  • error - ошибку выполнения sql или ошибку валидации входных параметров

func CheckWorkspaceSlug

func CheckWorkspaceSlug(slug string) bool

func CmdlineHandler

func CmdlineHandler() echo.HandlerFunc

CmdlineHandler will pass the call from /debug/pprof/cmdline to pprof.

func CompareAndAddFields

func CompareAndAddFields(f1, f2 interface{}, name string, fields *[]string) error

func DeleteGitRepository

func DeleteGitRepository(workspaceSlug, repoName, gitReposPath string) error

DeleteGitRepository удаляет репозиторий из файловой системы

func DeleteSSHKey

func DeleteSSHKey(userId, keyId, gitReposPath string) error

DeleteSSHKey удаляет SSH ключ пользователя по ID

func DemoMiddleware

func DemoMiddleware(next echo.HandlerFunc) echo.HandlerFunc

Запрет методов, если включен демо-режим

func EError

func EError(c echo.Context, err error) error

Возврат ошибки 400 с универсальным сообщением

func EErrorDefined

func EErrorDefined(c echo.Context, err apierrors.DefinedError) error

EErrorDefined возвращает JSON-ответ с кодом статуса и сообщением об ошибке. Если код статуса не определен, используется 400 Bad Request.

Параметры:

  • c: Context Echo, используемый для отправки JSON-ответа.
  • err: Объект DefinedError, содержащий код статуса и сообщение об ошибке.

Возвращает:

  • error: Ошибка, если произошла ошибка при формировании ответа. В противном случае nil.

func EErrorMsg

func EErrorMsg(c echo.Context, err error) error

Возврат ошибки 400 с сообщением ошибки

func EErrorMsgStatus

func EErrorMsgStatus(c echo.Context, err error, status int) error

Возврат ошибки <status> с сообщением ошибки(403 код с пустой ошибкой не логируется)

func FormValidator

func FormValidator() map[string]validateFunc

func GenInviteToken

func GenInviteToken(email string) (string, error)

func GenTokenChangeMail

func GenTokenChangeMail(email string) (string, error)

func GetActivitiesTable

func GetActivitiesTable(query *gorm.DB, from DayRequest, to DayRequest) (map[uuid.UUID]types.ActivityTable, error)

func GetAuthorizedKeysPath

func GetAuthorizedKeysPath(gitReposPath string) string

GetAuthorizedKeysPath возвращает путь к файлу authorized_keys Файл: {gitReposPath}/.ssh-keys/authorized_keys

func GetRepositoryPath

func GetRepositoryPath(workspaceSlug, repoName, gitReposPath string) string

GetRepositoryPath возвращает полный путь к репозиторию

func GetSSHKeysPath

func GetSSHKeysPath(gitReposPath string) string

GetSSHKeysPath возвращает путь к директории SSH ключей Директория: {gitReposPath}/.ssh-keys/

func GetUserSSHKeysFilePath

func GetUserSSHKeysFilePath(userId, gitReposPath string) string

GetUserSSHKeysFilePath возвращает путь к файлу SSH ключей пользователя Формат: {gitReposPath}/.ssh-keys/{userId}.json

func GitRepositoryExists

func GitRepositoryExists(workspaceSlug, repoName, gitReposPath string) bool

GitRepositoryExists проверяет существование репозитория по workspace slug и имени

func GoroutineHandler

func GoroutineHandler() echo.HandlerFunc

GoroutineHandler will pass the call from /debug/pprof/goroutine to pprof.

func HeapHandler

func HeapHandler() echo.HandlerFunc

HeapHandler will pass the call from /debug/pprof/heap to pprof.

func IndexHandler

func IndexHandler() echo.HandlerFunc

IndexHandler will pass the call from /debug/pprof to pprof.

func IsValidRole

func IsValidRole(role int) bool

func LegacyRunner deprecated

func LegacyRunner(db *gorm.DB, c *config.Config, version string)

LegacyRunner запускает сервер со стандартными параметрами и завершает процесс при ошибке.

Deprecated: используйте New + Run.

func MutexHandler

func MutexHandler() echo.HandlerFunc

MutexHandler will pass the call from /debug/pprof/mutex to pprof.

func NewHelpIndex

func NewHelpIndex(root string) func(echo.Context) error

func NewJitsiTokenLogMiddleware

func NewJitsiTokenLogMiddleware(db *gorm.DB) func(echo.HandlerFunc) echo.HandlerFunc

func NewSPACacheMiddleware

func NewSPACacheMiddleware(config middleware.StaticConfig) func(echo.HandlerFunc) echo.HandlerFunc

func ParseSSHPublicKey

func ParseSSHPublicKey(publicKey string) (keyType, fingerprint, comment string, err error)

ParseSSHPublicKey парсит и валидирует SSH публичный ключ Возвращает: keyType, fingerprint (SHA256), comment, error

func PodHeader

func PodHeader(next echo.HandlerFunc) echo.HandlerFunc

PodHeader middleware adds a X-Pod-Name header with pod name to response for balancer debug

func PrepareSearchRequest

func PrepareSearchRequest(query string) string

func ProfileHandler

func ProfileHandler() echo.HandlerFunc

ProfileHandler will pass the call from /debug/pprof/profile to pprof.

func RegenerateAuthorizedKeys

func RegenerateAuthorizedKeys(gitReposPath string) error

RegenerateAuthorizedKeys пересоздает файл authorized_keys из всех пользовательских ключей Формат файла: # User: email (uuid) # Key: name (keyId) ssh-xxx AAAA... comment

func SaveUserSSHKeys

func SaveUserSSHKeys(keys *UserSSHKeys, gitReposPath string) error

SaveUserSSHKeys сохраняет SSH ключи пользователя в файл Использует атомарную запись (temp file + rename) для безопасности

func ServerHeader

func ServerHeader(next echo.HandlerFunc) echo.HandlerFunc

ServerHeader middleware adds a `Server` header to the response.

func StructToJSONMap

func StructToJSONMap(obj interface{}) map[string]interface{}

func SymbolHandler

func SymbolHandler() echo.HandlerFunc

SymbolHandler will pass the call from /debug/pprof/symbol to pprof.

func ThreadCreateHandler

func ThreadCreateHandler() echo.HandlerFunc

ThreadCreateHandler will pass the call from /debug/pprof/threadcreate to pprof.

func TraceHandler

func TraceHandler() echo.HandlerFunc

TraceHandler will pass the call from /debug/pprof/trace to pprof.

func UpdateSSHKeyLastUsed

func UpdateSSHKeyLastUsed(userId, keyId, gitReposPath string) error

UpdateSSHKeyLastUsed обновляет время последнего использования ключа НЕ вызывает RegenerateAuthorizedKeys, так как это не требуется

func ValidateEmail

func ValidateEmail(email string) bool

Проверка email на корректность

func ValidateFieldDependency

func ValidateFieldDependency(field types2.FormFields, idx int, answers types2.FormFieldsSlice, formFields types2.FormFieldsSlice, currentVal interface{}) (bool, error)

ValidateFieldDependency рекурсивно проверяет выполнение условий depend_on(зависимостей) поля формы. Используется для проверки пользовательских ответов и допустимо ли его текущее значение относительно родительского поля

Параметры:

  • field — текущее поле формы, для которого выполняется проверка зависимостей
  • idx — индекс текущего поля в списке полей формы
  • answers — список ответов пользователя на поля формы
  • formFields — список исходных полей формы с правилами валидации
  • currentVal — текущее значение поля (используется для проверки пустого значения)

Возвращает:

  • bool — признак необходимости пропустить дальнейшую валидацию поля
  • error — ошибку, если порядок зависимостей некорректен или если условия depend_on не выполнены; иначе nil

func ValidateRepositoryName

func ValidateRepositoryName(name string) bool

ValidateRepositoryName проверяет корректность названия репозитория Допустимые символы: a-z, A-Z, 0-9, дефис (-), подчеркивание (_), точка (.)

func ValidateSSHKeyName

func ValidateSSHKeyName(name string) bool

ValidateSSHKeyName валидирует имя SSH ключа Имя должно быть от 1 до 255 символов

Types

type AddDocToFavoritesRequest

type AddDocToFavoritesRequest struct {
	DocID uuid.UUID `json:"doc" validate:"required"`
}

type AddProjectToFavoritesRequest

type AddProjectToFavoritesRequest struct {
	ProjectID string `json:"project" example:"project123" validate:"required"`
}

AddProjectToFavoritesRequest описывает структуру запроса для метода addProjectToFavorites.

type AuthConfig

type AuthConfig struct {
	Secret      []byte
	DB          *gorm.DB
	MemDB       *mem.AIPlanMemAPI
	Skipper     middleware.Skipper
	TokensCache *tokenscache.TokensCache
}

type BlobResponseDTO

type BlobResponseDTO struct {
	Path     string `json:"path"`      // Путь к файлу
	Ref      string `json:"ref"`       // Ветка/тег/коммит
	Size     int64  `json:"size"`      // Размер файла
	SHA      string `json:"sha"`       // SHA объекта
	Content  string `json:"content"`   // Содержимое файла (base64 encoded)
	Encoding string `json:"encoding"`  // "base64"
	IsBinary bool   `json:"is_binary"` // Является ли файл бинарным
}

BlobResponseDTO представляет ответ на запрос содержимого файла

type BranchDTO

type BranchDTO struct {
	Name      string `json:"name"`       // Имя ветки
	SHA       string `json:"sha"`        // SHA последнего коммита
	IsDefault bool   `json:"is_default"` // Является ли веткой по умолчанию
}

BranchDTO представляет информацию о ветке

type BranchesResponseDTO

type BranchesResponseDTO struct {
	Branches []BranchDTO `json:"branches"` // Список веток
}

BranchesResponseDTO представляет ответ на запрос списка веток

type CaptchaSignatures

type CaptchaSignatures struct {
	// contains filtered or unexported fields
}

func NewCaptchaService

func NewCaptchaService() *CaptchaSignatures

NewCaptchaService создает экземпляр сервиса для обработки CAPTCHA-подписей. Сервис хранит проверенные подписи, чтобы предотвратить повторное использование. Также включает в себя периодическую очистку хранилища подписей и подсчет неудачных попыток использования CAPTCHA для обнаружения атак.

Возвращает:

  • *CaptchaSignatures: экземпляр структуры CaptchaSignatures, который содержит логику проверки и хранения CAPTCHA-подписей.

Нет параметров.

func (*CaptchaSignatures) Validate

func (c *CaptchaSignatures) Validate(payload string) bool

Validate проверяет подлинность CAPTCHA-подписи, декодирует payload, проверяет с помощью Altcha HMAC и сохраняет подпись для предотвращения повторного использования.

Параметры:

  • payload: base64-encoded CAPTCHA-подпись для проверки.

Возвращает:

  • bool: true, если подпись валидна, false в противном случае.

type CommitDTO

type CommitDTO struct {
	SHA        string    `json:"sha"`         // SHA коммита
	Author     PersonDTO `json:"author"`      // Автор коммита
	Committer  PersonDTO `json:"committer"`   // Коммиттер
	Message    string    `json:"message"`     // Сообщение коммита
	ParentSHAs []string  `json:"parent_shas"` // SHA родительских коммитов
}

CommitDTO представляет информацию о коммите

type CommitsResponseDTO

type CommitsResponseDTO struct {
	Commits []CommitDTO `json:"commits"` // Список коммитов
	Total   int         `json:"total"`   // Общее количество коммитов
	Limit   int         `json:"limit"`   // Лимит на страницу
	Offset  int         `json:"offset"`  // Смещение
}

CommitsResponseDTO представляет ответ на запрос истории коммитов

type CreateProjectRequest

type CreateProjectRequest struct {
	Name               string      `json:"name" validate:"projectName"`
	Public             bool        `json:"public"`
	Identifier         string      `json:"identifier" validate:"identifier"`
	DefaultAssigneeIds []uuid.UUID `json:"default_assignees"`
	DefaultWatcherIds  []uuid.UUID `json:"default_watchers"`
	ProjectLeadId      uuid.UUID   `json:"project_lead"`
	Emoji              int32       `json:"emoji,string"`
	CoverImage         *string     `json:"cover_image"`
	EstimateId         *string     `json:"estimate"`
	RulesScript        *string     `json:"rules_script"`
}

func (*CreateProjectRequest) Bind

func (req *CreateProjectRequest) Bind(project *dao.Project)

type CreateWorkspaceRequest

type CreateWorkspaceRequest struct {
	Name    string  `json:"name" validate:"workspaceName"`
	Slug    string  `json:"slug" validate:"slug"`
	OwnerId string  `json:"owner_id"`
}

func (*CreateWorkspaceRequest) Bind

func (req *CreateWorkspaceRequest) Bind(workspace *dao.Workspace)

type DayRequest

type DayRequest time.Time

func (*DayRequest) UnmarshalText

func (d *DayRequest) UnmarshalText(text []byte) error

type Deps

type Deps struct {
	Config  *config.Config
	DB      *gorm.DB
	Version string

	SnapshotTracker      *tracker.SnapshotTracker
	Storage              filestorage.FileStorage
	EmailService         *email.EmailService
	MemDB                *mem.AIPlanMemAPI
	IntegrationsService  *integrations.IntegrationsService
	ImportService        *issues_import.ImportService
	JitsiTokenIssuer     *jitsi_token.JitsiTokenIssuer
	AuthProvider         *authprovider.LdapProvider
	NotificationsService *notifications.Notification
	Business             *business.Business
	TokensCache          *tokenscache.TokensCache

	// Policy — применитель правил движка. Обязателен.
	Policy *policy.Enforcer
}

Deps — внешние зависимости для сборки Services. Обязательны DB и Config, остальное может быть nil (функциональность отключается).

type DocCommentRequest

type DocCommentRequest struct {
	CommentHtml    types.RedactorHTML `json:"comment_html" swaggertype:"string" example:"<p>HTML-контент</p>"`
	ReplyToComment uuid.NullUUID      `json:"reply_to_comment_id,omitempty"`
}

type DocMoveParams

type DocMoveParams struct {
	ParentId   uuid.NullUUID `json:"parent_id,omitempty"`
	PreviousId uuid.NullUUID `json:"previous_id,omitempty"`
	NextId     uuid.NullUUID `json:"next_id,omitempty"`
}

type DocRequest

type DocRequest struct {
	Title       string             `json:"title,omitempty" example:"title text" validate:"required,max=150"`
	Content     types.RedactorHTML `json:"content,omitempty" swaggertype:"string" example:"<p>HTML-контент</p>"`
	EditorRole  int                `json:"editor_role,omitempty" example:"5"`
	ReaderRole  int                `json:"reader_role,omitempty" example:"5"`
	SeqId       int                `json:"seq_id,omitempty"`
	Draft       bool               `json:"draft,omitempty" example:"false"`
	EditorList  []uuid.UUID        `json:"editor_list,omitempty"`
	ReaderList  []uuid.UUID        `json:"reader_list,omitempty"`
	WatcherList []uuid.UUID        `json:"watcher_list,omitempty"`
}

type EmailCaptchaRequest

type EmailCaptchaRequest struct {
	Email          string `json:"email" validate:"required,email"`
	CaptchaPayload string `json:"captcha_payload" validate:"required"`
}

EmailCaptchaRequest представляет структуру данных для запроса на восстановление пароля

type EmailRequest

type EmailRequest struct {
	NewEmail string `json:"new_email" validate:"required"`
}

EmailRequest представляет структуру данных для смены почты пользователя

type EmailVerifyRequest

type EmailVerifyRequest struct {
	NewEmail string `json:"new_email" validate:"required"`
	Code     string `json:"code" validate:"required"`
}

EmailVerifyRequest представляет структуру данных для валидации почты пользователя

type ErrClause

type ErrClause struct {
	Error           string      `json:"error"`
	SrcIssueId      *uuid.UUID  `json:"src_issue_id,omitempty"`
	IssueSequenceId int         `json:"issue_sequence_id,omitempty"`
	Type            string      `json:"type,omitempty"`
	Entities        []uuid.UUID `json:"entities,omitempty"`
}

type EstimatePayload

type EstimatePayload struct {
	Estimate       dao.Estimate        `json:"estimate"`
	EstimatePoints []dao.EstimatePoint `json:"estimate_points"`
}

EstimatePayload описывает структуру данных для создания и обновления оценки.

type EstimatePayloadResponse

type EstimatePayloadResponse struct {
	Estimate       *dto.Estimate       `json:"estimate,omitempty"`
	EstimatePoints []dto.EstimatePoint `json:"estimate_points"`
}

type FilterParams

type FilterParams struct {
	WorkspaceIDs []string `json:"workspace_ids,omitempty"`
	ProjectIDs   []string `json:"project_ids,omitempty"`
	SearchQuery  string   `json:"search_query,omitempty"`
}

func ExtractFilterRequest

func ExtractFilterRequest(c echo.Context) (*dao.User, FilterParams, int, int, error)

type FormValidateStruct

type FormValidateStruct struct {
	Name             string
	CountOpt         int
	TypeOpt          types.BasicKind
	Func             validateTypeFunc
	Pattern          *string
	FieldTypeSupport []string
}

type GetRulesLogfilterRequest

type GetRulesLogfilterRequest struct {
	Select []string `json:"select" validate:"omitempty,dive,oneof=error print success fail"`
}

GetRulesLogfilterRequest описывает структуру запроса для метода GetRulesLog.

type GitRepository

type GitRepository struct {
	// Name - название репозитория
	Name string `json:"name"`

	// Workspace - slug рабочего пространства
	Workspace string `json:"workspace"`

	// Private - флаг приватности репозитория
	Private bool `json:"private"`

	// Description - описание репозитория
	Description string `json:"description"`

	// CreatedAt - время создания репозитория
	CreatedAt time.Time `json:"created_at"`

	// CreatedBy - UUID пользователя, создавшего репозиторий
	CreatedBy uuid.UUID `json:"created_by"`

	// Branch - ветка по умолчанию
	Branch string `json:"branch"`

	// Path - полный путь к репозиторию на файловой системе (не сохраняется в JSON)
	Path string `json:"-"`
}

GitRepository представляет Git репозиторий, хранящийся в файловой системе

func ListGitRepositories

func ListGitRepositories(workspaceSlug, gitReposPath string) ([]*GitRepository, error)

ListGitRepositories возвращает список всех репозиториев в workspace

func LoadGitRepository

func LoadGitRepository(path string) (*GitRepository, error)

LoadGitRepository загружает метаданные репозитория из файла aiplan.json

func (*GitRepository) Save

func (r *GitRepository) Save() error

Save сохраняет метаданные репозитория в файл aiplan.json

type HelpPage

type HelpPage struct {
	Title    string      `json:"title"`
	FullPath string      `json:"full_path"`
	SubPages []*HelpPage `json:"sub_pages"`
}

type IssueCheckResult

type IssueCheckResult struct {
	SrcIssue      dao.Issue
	TargetProject dao.Project
	TargetId      uuid.UUID

	TargetState  dao.State
	TargetLabels []dao.Label
	MapLabelIds  map[uuid.UUID]uuid.UUID

	Migrate bool
	Errors  []ErrClause
}

type IssueCreateRequest

type IssueCreateRequest struct {
	dto.Issue

	BlockersList  []uuid.UUID `json:"blockers_list"`
	AssigneesList []uuid.UUID `json:"assignees_list"`
	WatchersList  []uuid.UUID `json:"watchers_list"`
	LabelsList    []uuid.UUID `json:"labels_list"`
	BlocksList    []uuid.UUID `json:"blocks_list"`
}

type IssueLinkRequest

type IssueLinkRequest struct {
	Url   string `json:"url"`
	Title string `json:"title"`
}

type JiraInfoRequest

type JiraInfoRequest struct {
	JiraURL  string `json:"jira_url"`
	Username string `json:"username"`
	Token    string `json:"token"`

	TargetWorkspaceID string                   `json:"target_workspace_id"`
	BlockLinkID       string                   `json:"block_link_id"`
	RelatesLinkID     []string                 `json:"relates_link_id"`
	PrioritiesMapping entity.PrioritiesMapping `json:"priorities_mapping"`
}

type JoinProjectsRequest

type JoinProjectsRequest struct {
	ProjectIDs []string `json:"project_ids" example:"[\"project1\", \"project2\"]"`
}

JoinProjectsRequest описывает структуру запроса для подключения к проектам.

type LinkedIssuesIds

type LinkedIssuesIds struct {
	IssueIDs []uuid.UUID `json:"issue_ids"`
}

LinkedIssuesIds представляет собой структуру для передачи связанных задач

type LoginRequest

type LoginRequest struct {
	Email          string `json:"email"`
	Password       string `json:"password"`
	CaptchaPayload string `json:"captcha_payload"`
}

type NewIssueParam

type NewIssueParam struct {
	Priority     types.JSONField[string]      `json:"priority,omitempty" extensions:"x-nullable" swaggertype:"string" enums:"urgent,high,medium,low"`
	TargetDate   types.JSONField[string]      `json:"target_date,omitempty" extensions:"x-nullable" swaggertype:"string"`
	AssignersIds types.JSONField[[]uuid.UUID] `json:"assigner_ids,omitempty" extensions:"x-nullable" swaggertype:"array,string"`
	WatchersIds  types.JSONField[[]uuid.UUID] `json:"watcher_ids,omitempty" extensions:"x-nullable" swaggertype:"array,string"`

	StateId types.JSONField[uuid.UUID] `json:"state_id,omitempty" extensions:"x-nullable" swaggertype:"string"`
}

NewIssueParam изменяемы поля при копировании одиночной задачи

type NotificationViewRequest

type NotificationViewRequest struct {
	Ids       []string `json:"ids,omitempty"`
	ViewedAll bool     `json:"viewed_all,omitempty"`
}

type Options

type Options struct {
	Config  *config.Config
	DB      *gorm.DB
	Version string

	HTTPAddr    string // "" => :8080
	MetricsAddr string // "" => :2112

	RunMigration bool

	// Engine — движок правил. nil — используется движок ядра.
	Engine engine.Engine
}

Options — параметры сборки сервера.

type PasswordRequest

type PasswordRequest struct {
	NewPassword     string `json:"new_password" validate:"required,min=8"`
	ConfirmPassword string `json:"confirm_password" validate:"required,eqfield=NewPassword"`
}

PasswordRequest представляет структуру данных для запроса регистрации пользователя

type PersonDTO

type PersonDTO struct {
	Name  string    `json:"name"`  // Имя
	Email string    `json:"email"` // Email
	Date  time.Time `json:"date"`  // Дата
}

PersonDTO представляет информацию об авторе/коммиттере

type PostFeedbackRequest

type PostFeedbackRequest struct {
	Stars    int    `json:"stars"`
	Feedback string `json:"feedback"`
}

PostFeedbackRequest представляет структуру данных для запроса отправки отзыва

type ReactionRequest

type ReactionRequest struct {
	Reaction string `json:"reaction" validate:"required"`
}

type RepoInfoDTO

type RepoInfoDTO struct {
	Name          string     `json:"name"`                  // Имя репозитория
	Workspace     string     `json:"workspace"`             // Slug workspace
	DefaultBranch string     `json:"default_branch"`        // Ветка по умолчанию
	BranchesCount int        `json:"branches_count"`        // Количество веток
	CommitsCount  int        `json:"commits_count"`         // Количество коммитов
	Size          int64      `json:"size"`                  // Размер репозитория (байты)
	LastCommit    *CommitDTO `json:"last_commit,omitempty"` // Последний коммит
}

RepoInfoDTO представляет информацию о репозитории

type RequestValidator

type RequestValidator struct {
	// contains filtered or unexported fields
}

func NewRequestValidator

func NewRequestValidator() *RequestValidator

func (*RequestValidator) Validate

func (rv *RequestValidator) Validate(i interface{}) error

type SSHKeyMetadata

type SSHKeyMetadata struct {
	// ID - уникальный идентификатор ключа (UUID)
	ID string `json:"id"`

	// Name - название ключа, заданное пользователем (например "Work Laptop")
	Name string `json:"name"`

	// PublicKey - SSH публичный ключ в OpenSSH формате
	PublicKey string `json:"public_key"`

	// Fingerprint - SHA256 отпечаток ключа для идентификации
	Fingerprint string `json:"fingerprint"`

	// KeyType - тип ключа (ssh-ed25519, ssh-rsa, ecdsa-sha2-nistp256, и т.д.)
	KeyType string `json:"key_type"`

	// CreatedAt - время добавления ключа
	CreatedAt time.Time `json:"created_at"`

	// LastUsedAt - время последнего использования ключа (может быть nil)
	LastUsedAt *time.Time `json:"last_used_at,omitempty"`

	// Comment - комментарий из SSH ключа (обычно user@host)
	Comment string `json:"comment"`
}

SSHKeyMetadata представляет метаданные одного SSH ключа

func AddSSHKey

func AddSSHKey(userId, userEmail, name, publicKey, gitReposPath string) (*SSHKeyMetadata, error)

AddSSHKey добавляет новый SSH ключ пользователю Выполняет парсинг, валидацию, проверку на дубликаты и регенерацию authorized_keys

func FindSSHKeyByFingerprint

func FindSSHKeyByFingerprint(fingerprint, gitReposPath string) (*SSHKeyMetadata, string, error)

FindSSHKeyByFingerprint ищет SSH ключ по fingerprint среди всех пользователей Возвращает: (key, userId, error)

type SSHRateLimiter

type SSHRateLimiter struct {
	// contains filtered or unexported fields
}

SSHRateLimiter ограничивает частоту SSH попыток аутентификации по IP адресу

func NewSSHRateLimiter

func NewSSHRateLimiter(maxAttempts int, window time.Duration) *SSHRateLimiter

NewSSHRateLimiter создает новый rate limiter для SSH maxAttempts - максимальное количество попыток (например, 5) window - временное окно (например, 1 минута)

func (*SSHRateLimiter) CheckAndRecord

func (rl *SSHRateLimiter) CheckAndRecord(ip string) bool

CheckAndRecord проверяет, не превышен ли лимит попыток для указанного IP, и записывает новую попытку. Возвращает true, если попытка разрешена, false - если лимит превышен.

func (*SSHRateLimiter) Stop

func (rl *SSHRateLimiter) Stop()

Stop останавливает фоновую горутину очистки

type SSHServer

type SSHServer struct {
	// contains filtered or unexported fields
}

SSHServer представляет SSH сервер для Git операций

func NewSSHServer

func NewSSHServer(config SSHServerConfig) (*SSHServer, error)

NewSSHServer создает новый SSH сервер для Git операций

func (*SSHServer) Shutdown

func (s *SSHServer) Shutdown(ctx context.Context) error

Shutdown останавливает SSH сервер с graceful shutdown

func (*SSHServer) Start

func (s *SSHServer) Start(ctx context.Context) error

Start запускает SSH сервер Блокирует выполнение до получения сигнала остановки через context

type SSHServerConfig

type SSHServerConfig struct {
	// DB - подключение к базе данных
	DB *gorm.DB

	// GitReposPath - путь к директории Git репозиториев
	GitReposPath string

	// Host - адрес для прослушивания
	Host string

	// Port - порт для прослушивания
	Port int

	// HostKeyPath - путь к файлу SSH host key
	HostKeyPath string

	// RateLimitEnabled - включить ограничение частоты запросов
	RateLimitEnabled bool
}

SSHServerConfig конфигурация SSH сервера

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server — собранный, но ещё не запущенный сервер.

func New

func New(opts Options) (*Server, error)

New собирает сервер: хранилище, зависимости, cron, middleware и роуты. Не блокирует и ничего не слушает — для запуска вызвать Run.

func (*Server) Echo

func (srv *Server) Echo() *echo.Echo

Echo возвращает echo-инстанс (для регистрации дополнительных роутов).

func (*Server) Engine

func (srv *Server) Engine() engine.Engine

Engine возвращает подключённый движок правил.

func (*Server) Run

func (srv *Server) Run(ctx context.Context) error

Run запускает cron, фоновые подписки и HTTP-сервер. Блокирует до остановки по отмене ctx или сигналу SIGINT/SIGTERM.

func (*Server) Services

func (srv *Server) Services() *Services

Services возвращает набор зависимостей ядра.

type Services

type Services struct {
	// contains filtered or unexported fields
}

Services — общие зависимости, доступные всем обработчикам. Поля неэкспортированы: снаружи доступны только NewServices и геттеры.

func NewServices

func NewServices(d Deps) (*Services, error)

NewServices собирает набор зависимостей HTTP-слоя.

func (*Services) AddAdminServices

func (s *Services) AddAdminServices(g *echo.Group)

func (*Services) AddAuthenticationServices

func (s *Services) AddAuthenticationServices(g *echo.Group, secret []byte)

func (*Services) AddBackupServices

func (s *Services) AddBackupServices(g *echo.Group)

func (*Services) AddDocServices

func (s *Services) AddDocServices(g *echo.Group)

func (*Services) AddFormServices

func (s *Services) AddFormServices(g *echo.Group)

func (*Services) AddFormWithoutAuthServices

func (s *Services) AddFormWithoutAuthServices(g *echo.Group)

func (*Services) AddGitServices

func (s *Services) AddGitServices(g *echo.Group)

AddGitServices регистрирует все эндпоинты для работы с GIT

func (*Services) AddImportServices

func (s *Services) AddImportServices(g *echo.Group)

func (*Services) AddIssueMigrationServices

func (s *Services) AddIssueMigrationServices(g *echo.Group)

func (*Services) AddIssueServices

func (s *Services) AddIssueServices(g *echo.Group)

AddIssueServices - добавление сервисов задач

func (*Services) AddProjectServices

func (s *Services) AddProjectServices(g *echo.Group)

func (*Services) AddSprintServices

func (s *Services) AddSprintServices(g *echo.Group)

func (*Services) AddUserServices

func (s *Services) AddUserServices(g *echo.Group)

func (*Services) AddUserWithoutAuthServices

func (s *Services) AddUserWithoutAuthServices(g *echo.Group)

func (*Services) AddWorkspaceServices

func (s *Services) AddWorkspaceServices(g *echo.Group)

AddWorkspaceServices - добавление сервисов рабочих пространств

func (*Services) AnswerFormAuthMiddleware

func (s *Services) AnswerFormAuthMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) AnswerFormNoAuthMiddleware

func (s *Services) AnswerFormNoAuthMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) AuthMiddleware

func (s *Services) AuthMiddleware(secret []byte, skipper middleware.Skipper) echo.MiddlewareFunc

func (*Services) Business

func (s *Services) Business() *business.Business

Business возвращает слой бизнес-логики.

func (*Services) CheckIssueBeforeMigrate

func (s *Services) CheckIssueBeforeMigrate(srcIssue dao.Issue, targetProject dao.Project, migrateWithNewState bool) (IssueCheckResult, error)

func (*Services) Config

func (s *Services) Config() *config.Config

Config возвращает конфигурацию сервера.

func (*Services) DB

func (s *Services) DB(c echo.Context) *gorm.DB

DB возвращает *gorm.DB, привязанный к контексту HTTP-запроса. При cancel/timeout контекста pgx отправит pg_cancel_backend в Postgres, что не даёт зависшим запросам копиться в пуле.

func (*Services) DictionariesMiddleware

func (s *Services) DictionariesMiddleware(next echo.HandlerFunc) echo.HandlerFunc

DictionariesMiddleware - guard существования справочника проекта; сама загрузка лениво в ручке через apicontext.GetDictionary()

func (*Services) FindIssueByIdOrSeqMiddleware

func (s *Services) FindIssueByIdOrSeqMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) FormMiddleware

func (s *Services) FormMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) GetSprint

func (s *Services) GetSprint(c echo.Context) error

GetSprint godoc @id GetSprint @Summary Спринты: получение информации о спринте @Description Получение информации о спринте. @Tags Sprint @Accept json @Produce json @Security ApiKeyAuth @Param workspaceSlug path string true "Slug рабочего пространства" @Param sprintId path string true "Идентификатор или номер последовательности спринта" @Success 200 {object} dto.Sprint "Спринт" @Failure 400 {object} apierrors.DefinedError "Ошибка запроса" @Failure 401 {object} apierrors.DefinedError "Необходима авторизация" @Failure 403 {object} apierrors.DefinedError "Доступ запрещен" @Failure 404 {object} apierrors.DefinedError "Спринт не найден" @Failure 500 {object} apierrors.DefinedError "Ошибка сервера" @Router /api/auth/workspaces/{workspaceSlug}/sprints/{sprintId}/ [get]

func (*Services) IssuePermissionMiddleware

func (s *Services) IssuePermissionMiddleware(next echo.HandlerFunc) echo.HandlerFunc

IssuePermissionMiddleware проверяет право на действие роута задачи. Права на проект, пространство, спринт, документ и форму проверяются тем же permissionMiddleware через помощники регистрации роутов (route-actions.go).

func (*Services) LastVisitedWorkspaceMiddleware

func (s *Services) LastVisitedWorkspaceMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) Notifications

func (s *Services) Notifications() *notifications.Notification

Notifications возвращает сервис уведомлений.

func (*Services) ProjectArchivedMiddleware

func (s *Services) ProjectArchivedMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) ProjectMiddleware

func (s *Services) ProjectMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) RawDB

func (s *Services) RawDB() *gorm.DB

RawDB возвращает исходный *gorm.DB без привязки к запросу. Использовать только в фоновых задачах, кронах и не-HTTP-обработчиках.

func (*Services) ReleaseNotesMiddleware

func (s *Services) ReleaseNotesMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) SearchFiltersMiddleware

func (s *Services) SearchFiltersMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) SprintMiddleware

func (s *Services) SprintMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) StaffPermissionsMiddleware

func (s *Services) StaffPermissionsMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) Storage

func (s *Services) Storage() filestorage.FileStorage

Storage возвращает файловое хранилище.

func (*Services) Tracker

func (s *Services) Tracker() *tracker.SnapshotTracker

Tracker возвращает трекер изменений сущностей.

func (*Services) UserExistsMiddleware

func (s *Services) UserExistsMiddleware(next echo.HandlerFunc) echo.HandlerFunc

func (*Services) Version

func (s *Services) Version() string

Version возвращает версию сборки.

func (*Services) WorkspaceMiddleware

func (s *Services) WorkspaceMiddleware(next echo.HandlerFunc) echo.HandlerFunc

type SubIssuesIds

type SubIssuesIds struct {
	SubIssueIDs []uuid.UUID `json:"sub_issue_ids"`
}

SubIssuesIds представляет собой структуру для передачи идентификаторов подзадач

type TreeEntryDTO

type TreeEntryDTO struct {
	Name string `json:"name"`           // Имя файла/директории
	Type string `json:"type"`           // "file" или "dir"
	Mode string `json:"mode"`           // Режим файла (100644, 040000, etc.)
	Size int64  `json:"size,omitempty"` // Размер файла (только для файлов)
	SHA  string `json:"sha"`            // SHA объекта
}

TreeEntryDTO представляет файл или директорию в Git tree

type TreeResponseDTO

type TreeResponseDTO struct {
	Ref     string         `json:"ref"`     // Ветка/тег/коммит
	Path    string         `json:"path"`    // Путь в репозитории
	Entries []TreeEntryDTO `json:"entries"` // Список файлов и директорий
}

TreeResponseDTO представляет ответ на запрос дерева репозитория

type UpdateStateRequest

type UpdateStateRequest struct {
	Name        *string `json:"name,omitempty"`
	Description *string `json:"description,omitempty"`
	Group       *string `json:"group,omitempty"`
	Color       *string `json:"color,omitempty"`
	Default     *bool   `json:"default,omitempty"`
	SeqId       *int    `json:"group_seq_id,omitempty"`

	UpdatedAt   time.Time `json:"-"`
	UpdatedById uuid.UUID `json:"-"`
	Sequence    uint64    `json:"sequence,omitempty"`
}

func (*UpdateStateRequest) Update

func (s *UpdateStateRequest) Update(fields []string, state *dao.State)

type UserCreateRequest

type UserCreateRequest struct {
	Email       string `json:"email"`
	FirstName   string `json:"first_name"`
	LastName    string `json:"last_name"`
	Password    string `json:"password"`
	WorkspaceId string `json:"workspace_id"` // optional
	Role        int    `json:"role"`         // optional
}

type UserSSHKeys

type UserSSHKeys struct {
	// UserId - UUID пользователя
	UserId string `json:"user_id"`

	// UserEmail - email пользователя для удобства идентификации
	UserEmail string `json:"user_email"`

	// Keys - массив SSH ключей пользователя
	Keys []SSHKeyMetadata `json:"keys"`

	// CreatedAt - время создания файла ключей
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt - время последнего обновления файла
	UpdatedAt time.Time `json:"updated_at"`
}

UserSSHKeys представляет все SSH ключи пользователя

func LoadUserSSHKeys

func LoadUserSSHKeys(userId, gitReposPath string) (*UserSSHKeys, error)

LoadUserSSHKeys загружает SSH ключи пользователя из файла Если файл не существует, возвращается ошибка, которую можно проверить через os.IsNotExist

type UserUpdateRequest

type UserUpdateRequest struct {
	Username      *string    `json:"username" validate:"omitempty,username" extensions:"x-nullable"`
	TelegramId    *int64     `json:"telegram_id" extensions:"x-nullable"`
	FirstName     *string    `json:"first_name" validate:"omitempty,fullName" extensions:"x-nullable"`
	LastName      *string    `json:"last_name" validate:"omitempty,fullName" extensions:"x-nullable"`
	StatusEmoji   *string    `json:"status_emoji" validate:"omitempty,statusEmoji" extensions:"x-nullable"`
	Status        *string    `json:"status" extensions:"x-nullable"`
	StatusEndDate *time.Time `json:"status_end_date" extensions:"x-nullable"`

	UserTimezone *string             `json:"user_timezone" extensions:"x-nullable"`
	Settings     *types.UserSettings `json:"settings,omitempty" extensions:"x-nullable"`
	Theme        *types.Theme        `json:"theme" extensions:"x-nullable"`
	ViewProps    *types.ViewProps    `json:"view_props" extensions:"x-nullable"`
}

type WorkspaceBackup

type WorkspaceBackup struct {
	CreatedAt time.Time
	CreatedBy dao.User

	Users            []dao.User            `importOrder:"1"`
	Workspace        dao.Workspace         `importOrder:"2"`
	WorkspaceMembers []dao.WorkspaceMember `importOrder:"4"`
	Projects         []dao.Project         `importOrder:"3"`
	States           []dao.State           `importOrder:"4"`
	Issues           []dao.Issue           `importOrder:"4"`

	EstimatePoints []dao.EstimatePoint `importOrder:"4"`

	Labels []dao.Label `importOrder:"4"`

	ProjectFavorites []dao.ProjectFavorites `importOrder:"4"`
	ProjectMembers   []dao.ProjectMember    `importOrder:"4"`

	IssueActivities []dao.ActivityEvent `importOrder:"5"`
	IssueAssignees  []dao.IssueAssignee `importOrder:"5"`
	IssueWatchers   []dao.IssueWatcher  `importOrder:"5"`
	IssueBlockers   []dao.IssueBlocker  `importOrder:"5"`
	IssueComments   []dao.IssueComment  `importOrder:"5"`
	IssueLabels     []dao.IssueLabel    `importOrder:"5"`
	IssueLinks      []dao.IssueLink     `importOrder:"5"`
	IssueProperties []dao.IssueProperty `importOrder:"5"`

	Estimates []dao.Estimate `importOrder:"5"`
}

Content of workspace backup. Don't change order of fields(import will insert in this order)!!!

Directories

Path Synopsis
Package docs Code generated by swaggo/swag.
Package docs Code generated by swaggo/swag.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址