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
- Variables
- func ActionOf(c echo.Context) (engine.Action, bool)
- func AddProfileServices(g *echo.Group)
- func BindData(c echo.Context, key string, target interface{}) ([]string, error)
- func BindDoc(c echo.Context, doc *dao.Doc) (*dao.Doc, []string, error)
- func BindDocComment(c echo.Context, comment *dao.DocComment) (*dao.DocComment, []string, error)
- func BlockHandler() echo.HandlerFunc
- func CascadeUpdateChildDocsRole(tx *gorm.DB, parentID uuid.UUID, roleField string, roleValue int) error
- func CheckWorkspaceSlug(slug string) bool
- func CmdlineHandler() echo.HandlerFunc
- func CompareAndAddFields(f1, f2 interface{}, name string, fields *[]string) error
- func DeleteGitRepository(workspaceSlug, repoName, gitReposPath string) error
- func DeleteSSHKey(userId, keyId, gitReposPath string) error
- func DemoMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func EError(c echo.Context, err error) error
- func EErrorDefined(c echo.Context, err apierrors.DefinedError) error
- func EErrorMsg(c echo.Context, err error) error
- func EErrorMsgStatus(c echo.Context, err error, status int) error
- func FormValidator() map[string]validateFunc
- func GenInviteToken(email string) (string, error)
- func GenTokenChangeMail(email string) (string, error)
- func GetActivitiesTable(query *gorm.DB, from DayRequest, to DayRequest) (map[uuid.UUID]types.ActivityTable, error)
- func GetAuthorizedKeysPath(gitReposPath string) string
- func GetRepositoryPath(workspaceSlug, repoName, gitReposPath string) string
- func GetSSHKeysPath(gitReposPath string) string
- func GetUserSSHKeysFilePath(userId, gitReposPath string) string
- func GitRepositoryExists(workspaceSlug, repoName, gitReposPath string) bool
- func GoroutineHandler() echo.HandlerFunc
- func HeapHandler() echo.HandlerFunc
- func IndexHandler() echo.HandlerFunc
- func IsValidRole(role int) bool
- func LegacyRunner(db *gorm.DB, c *config.Config, version string)deprecated
- func MutexHandler() echo.HandlerFunc
- func NewHelpIndex(root string) func(echo.Context) error
- func NewJitsiTokenLogMiddleware(db *gorm.DB) func(echo.HandlerFunc) echo.HandlerFunc
- func NewSPACacheMiddleware(config middleware.StaticConfig) func(echo.HandlerFunc) echo.HandlerFunc
- func ParseSSHPublicKey(publicKey string) (keyType, fingerprint, comment string, err error)
- func PodHeader(next echo.HandlerFunc) echo.HandlerFunc
- func PrepareSearchRequest(query string) string
- func ProfileHandler() echo.HandlerFunc
- func RegenerateAuthorizedKeys(gitReposPath string) error
- func SaveUserSSHKeys(keys *UserSSHKeys, gitReposPath string) error
- func ServerHeader(next echo.HandlerFunc) echo.HandlerFunc
- func StructToJSONMap(obj interface{}) map[string]interface{}
- func SymbolHandler() echo.HandlerFunc
- func ThreadCreateHandler() echo.HandlerFunc
- func TraceHandler() echo.HandlerFunc
- func UpdateSSHKeyLastUsed(userId, keyId, gitReposPath string) error
- func ValidateEmail(email string) bool
- func ValidateFieldDependency(field types2.FormFields, idx int, answers types2.FormFieldsSlice, ...) (bool, error)
- func ValidateRepositoryName(name string) bool
- func ValidateSSHKeyName(name string) bool
- type AddDocToFavoritesRequest
- type AddProjectToFavoritesRequest
- type AuthConfig
- type BlobResponseDTO
- type BranchDTO
- type BranchesResponseDTO
- type CaptchaSignatures
- type CommitDTO
- type CommitsResponseDTO
- type CreateProjectRequest
- type CreateWorkspaceRequest
- type DayRequest
- type Deps
- type DocCommentRequest
- type DocMoveParams
- type DocRequest
- type EmailCaptchaRequest
- type EmailRequest
- type EmailVerifyRequest
- type ErrClause
- type EstimatePayload
- type EstimatePayloadResponse
- type FilterParams
- type FormValidateStruct
- type GetRulesLogfilterRequest
- type GitRepository
- type HelpPage
- type IssueCheckResult
- type IssueCreateRequest
- type IssueLinkRequest
- type JiraInfoRequest
- type JoinProjectsRequest
- type LinkedIssuesIds
- type LoginRequest
- type NewIssueParam
- type NotificationViewRequest
- type Options
- type PasswordRequest
- type PersonDTO
- type PostFeedbackRequest
- type ReactionRequest
- type RepoInfoDTO
- type RequestValidator
- type SSHKeyMetadata
- type SSHRateLimiter
- type SSHServer
- type SSHServerConfig
- type Server
- type Services
- func (s *Services) AddAdminServices(g *echo.Group)
- func (s *Services) AddAuthenticationServices(g *echo.Group, secret []byte)
- func (s *Services) AddBackupServices(g *echo.Group)
- func (s *Services) AddDocServices(g *echo.Group)
- func (s *Services) AddFormServices(g *echo.Group)
- func (s *Services) AddFormWithoutAuthServices(g *echo.Group)
- func (s *Services) AddGitServices(g *echo.Group)
- func (s *Services) AddImportServices(g *echo.Group)
- func (s *Services) AddIssueMigrationServices(g *echo.Group)
- func (s *Services) AddIssueServices(g *echo.Group)
- func (s *Services) AddProjectServices(g *echo.Group)
- func (s *Services) AddSprintServices(g *echo.Group)
- func (s *Services) AddUserServices(g *echo.Group)
- func (s *Services) AddUserWithoutAuthServices(g *echo.Group)
- func (s *Services) AddWorkspaceServices(g *echo.Group)
- func (s *Services) AnswerFormAuthMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) AnswerFormNoAuthMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) AuthMiddleware(secret []byte, skipper middleware.Skipper) echo.MiddlewareFunc
- func (s *Services) Business() *business.Business
- func (s *Services) CheckIssueBeforeMigrate(srcIssue dao.Issue, targetProject dao.Project, migrateWithNewState bool) (IssueCheckResult, error)
- func (s *Services) Config() *config.Config
- func (s *Services) DB(c echo.Context) *gorm.DB
- func (s *Services) DictionariesMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) FindIssueByIdOrSeqMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) FormMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) GetSprint(c echo.Context) error
- func (s *Services) IssuePermissionMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) LastVisitedWorkspaceMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) Notifications() *notifications.Notification
- func (s *Services) ProjectArchivedMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) ProjectMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) RawDB() *gorm.DB
- func (s *Services) ReleaseNotesMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) SearchFiltersMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) SprintMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) StaffPermissionsMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) Storage() filestorage.FileStorage
- func (s *Services) Tracker() *tracker.SnapshotTracker
- func (s *Services) UserExistsMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- func (s *Services) Version() string
- func (s *Services) WorkspaceMiddleware(next echo.HandlerFunc) echo.HandlerFunc
- type SubIssuesIds
- type TreeEntryDTO
- type TreeResponseDTO
- type UpdateStateRequest
- type UserCreateRequest
- type UserSSHKeys
- type UserUpdateRequest
- type WorkspaceBackup
Constants ¶
const ( SearchParentIssues = iota SearchSubIssues SearchBlocksIssues SearchBlockersIssues SearchLinkedIssues )
Variables ¶
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" )
var AltchaExpires time.Duration = time.Hour
var CaptchaService = NewCaptchaService()
Functions ¶
func ActionOf ¶
ActionOf возвращает действие текущего роута. Второе значение false — роут не размечен: вызывающий обязан отказать в доступе, а не пропускать запрос.
func AddProfileServices ¶
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 CmdlineHandler ¶
func CmdlineHandler() echo.HandlerFunc
CmdlineHandler will pass the call from /debug/pprof/cmdline to pprof.
func CompareAndAddFields ¶
func DeleteGitRepository ¶
DeleteGitRepository удаляет репозиторий из файловой системы
func DeleteSSHKey ¶
DeleteSSHKey удаляет SSH ключ пользователя по ID
func DemoMiddleware ¶
func DemoMiddleware(next echo.HandlerFunc) echo.HandlerFunc
Запрет методов, если включен демо-режим
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 EErrorMsgStatus ¶
Возврат ошибки <status> с сообщением ошибки(403 код с пустой ошибкой не логируется)
func FormValidator ¶
func FormValidator() map[string]validateFunc
func GenInviteToken ¶
func GenTokenChangeMail ¶
func GetActivitiesTable ¶
func GetActivitiesTable(query *gorm.DB, from DayRequest, to DayRequest) (map[uuid.UUID]types.ActivityTable, error)
func GetAuthorizedKeysPath ¶
GetAuthorizedKeysPath возвращает путь к файлу authorized_keys Файл: {gitReposPath}/.ssh-keys/authorized_keys
func GetRepositoryPath ¶
GetRepositoryPath возвращает полный путь к репозиторию
func GetSSHKeysPath ¶
GetSSHKeysPath возвращает путь к директории SSH ключей Директория: {gitReposPath}/.ssh-keys/
func GetUserSSHKeysFilePath ¶
GetUserSSHKeysFilePath возвращает путь к файлу SSH ключей пользователя Формат: {gitReposPath}/.ssh-keys/{userId}.json
func GitRepositoryExists ¶
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 MutexHandler ¶
func MutexHandler() echo.HandlerFunc
MutexHandler will pass the call from /debug/pprof/mutex to pprof.
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 ¶
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 ProfileHandler ¶
func ProfileHandler() echo.HandlerFunc
ProfileHandler will pass the call from /debug/pprof/profile to pprof.
func RegenerateAuthorizedKeys ¶
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 ¶
UpdateSSHKeyLastUsed обновляет время последнего использования ключа НЕ вызывает RegenerateAuthorizedKeys, так как это не требуется
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 ¶
ValidateRepositoryName проверяет корректность названия репозитория Допустимые символы: a-z, A-Z, 0-9, дефис (-), подчеркивание (_), точка (.)
func ValidateSSHKeyName ¶
ValidateSSHKeyName валидирует имя SSH ключа Имя должно быть от 1 до 255 символов
Types ¶
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"`
Logo *string `json:"logo"`
Slug string `json:"slug" validate:"slug"`
OwnerId string `json:"owner_id"`
}
func (*CreateWorkspaceRequest) Bind ¶
func (req *CreateWorkspaceRequest) Bind(workspace *dao.Workspace)
type DayRequest ¶
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 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 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 ¶
type FormValidateStruct ¶
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 IssueCheckResult ¶
type IssueCreateRequest ¶
type IssueLinkRequest ¶
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 ¶
LinkedIssuesIds представляет собой структуру для передачи связанных задач
type LoginRequest ¶
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 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 ¶
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 операций
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 ¶
New собирает сервер: хранилище, зависимости, cron, middleware и роуты. Не блокирует и ничего не слушает — для запуска вызвать Run.
type Services ¶
type Services struct {
// contains filtered or unexported fields
}
Services — общие зависимости, доступные всем обработчикам. Поля неэкспортированы: снаружи доступны только NewServices и геттеры.
func NewServices ¶
NewServices собирает набор зависимостей HTTP-слоя.
func (*Services) AddAdminServices ¶
func (*Services) AddAuthenticationServices ¶
func (*Services) AddBackupServices ¶
func (*Services) AddDocServices ¶
func (*Services) AddFormServices ¶
func (*Services) AddFormWithoutAuthServices ¶
func (*Services) AddGitServices ¶
AddGitServices регистрирует все эндпоинты для работы с GIT
func (*Services) AddImportServices ¶
func (*Services) AddIssueMigrationServices ¶
func (*Services) AddIssueServices ¶
AddIssueServices - добавление сервисов задач
func (*Services) AddProjectServices ¶
func (*Services) AddSprintServices ¶
func (*Services) AddUserServices ¶
func (*Services) AddUserWithoutAuthServices ¶
func (*Services) AddWorkspaceServices ¶
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) CheckIssueBeforeMigrate ¶
func (*Services) 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 ¶
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 ¶
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) WorkspaceMiddleware ¶
func (s *Services) WorkspaceMiddleware(next echo.HandlerFunc) echo.HandlerFunc
type SubIssuesIds ¶
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"`
}
type UserCreateRequest ¶
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)!!!
Source Files
¶
- api-logger.go
- captcha.go
- cron.go
- engine.go
- externalFront.go
- git-fs.go
- help_index.go
- http-admin.go
- http-authentication.go
- http-backup.go
- http-dictionary.go
- http-doc.go
- http-form.go
- http-git.go
- http-import.go
- http-issue-migrate.go
- http-issue.go
- http-jitsi-redirect.go
- http-minio-redirect.go
- http-profiling.go
- http-project.go
- http-short-url.go
- http-sprint.go
- http-user.go
- http-util.go
- http-workspace.go
- http.go
- init-deps.go
- init-storage.go
- issue-fields.go
- issue-permission.go
- metrics.go
- middlewares.go
- requests.go
- route-actions.go
- routes.go
- server.go
- services.go
- setup-middlewares.go
- ssh-keys-fs.go
- ssh-rate-limiter.go
- ssh-server.go
- ssh-start.go
- valid-form.go
- validator.go