Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.
Go email-relayemail-routinghttp-to-smtpmail-deliverymailchimp-alternativemailgun-alternativemailsendermailservermailtemplatemailtestpostmark-alternativesend-emailsendgrid-alternativesendmailtransactional-emailtransactional-outbox
// Copyright (c) 2026 Jonas Kaninda.
//
// This file is part of Posta.
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: AGPL-3.0-or-later
package models
import "time"
type WorkspaceRole string
const (
WorkspaceRoleOwner WorkspaceRole = "owner"
WorkspaceRoleAdmin WorkspaceRole = "admin"
WorkspaceRoleEditor WorkspaceRole = "editor"
WorkspaceRoleViewer WorkspaceRole = "viewer"
)
type InvitationStatus string
const (
InvitationStatusPending InvitationStatus = "pending"
InvitationStatusAccepted InvitationStatus = "accepted"
InvitationStatusDeclined InvitationStatus = "declined"
)
type Workspace struct {
ID uint `json:"id" gorm:"primaryKey"`
Name string `json:"name" gorm:"uniqueIndex;not null"`
DisplayName string `json:"display_name" gorm:"not null;default:''"`
Description string `json:"description"`
OwnerID uint `json:"owner_id" gorm:"index;not null"`
PlanID *uint `json:"plan_id" gorm:"index"`
DefaultLanguage string `json:"default_language" gorm:"size:10;default:'en'"`
// System marks the single built-in platform workspace. It owns
// platform-managed resources, is created on first boot, cannot be renamed or
// deleted, and admits only platform admins.
System bool `json:"system" gorm:"not null;default:false"`
// HostedFormsDisabled lets a platform admin take the workspace's hosted
// form pages (/f/{key}) offline, for example when they are used for
// phishing. Forms embedded on the workspace's own sites keep working.
HostedFormsDisabled bool `json:"hosted_forms_disabled" gorm:"not null;default:false"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
Owner User `json:"-" gorm:"foreignKey:OwnerID"`
Plan Plan `json:"-" gorm:"foreignKey:PlanID"`
Members []WorkspaceMember `json:"-" gorm:"foreignKey:WorkspaceID"`
}
type WorkspaceMember struct {
ID uint `json:"id" gorm:"primaryKey"`
WorkspaceID uint `json:"workspace_id" gorm:"uniqueIndex:idx_workspace_user;not null"`
UserID uint `json:"user_id" gorm:"uniqueIndex:idx_workspace_user;not null"`
Role WorkspaceRole `json:"role" gorm:"not null;default:viewer"`
CreatedAt time.Time `json:"created_at"`
Workspace Workspace `json:"-" gorm:"foreignKey:WorkspaceID"`
User User `json:"-" gorm:"foreignKey:UserID"`
}
type WorkspaceInvitation struct {
ID uint `json:"id" gorm:"primaryKey"`
WorkspaceID uint `json:"workspace_id" gorm:"index;not null"`
Email string `json:"email" gorm:"not null"`
Role WorkspaceRole `json:"role" gorm:"not null;default:viewer"`
Token string `json:"-" gorm:"uniqueIndex;not null"`
Status InvitationStatus `json:"status" gorm:"not null;default:pending"`
InvitedBy uint `json:"invited_by" gorm:"not null"`
ExpiresAt time.Time `json:"expires_at" gorm:"not null"`
CreatedAt time.Time `json:"created_at"`
Workspace Workspace `json:"-" gorm:"foreignKey:WorkspaceID"`
Inviter User `json:"-" gorm:"foreignKey:InvitedBy"`
}
// IsSystem reports whether this is the built-in platform workspace.
func (w *Workspace) IsSystem() bool { return w.System }
// CanManageMembers returns true if the role can invite/remove members.
func (r WorkspaceRole) CanManageMembers() bool {
return r == WorkspaceRoleOwner || r == WorkspaceRoleAdmin
}
// CanEdit returns true if the role can create/modify resources.
func (r WorkspaceRole) CanEdit() bool {
return r == WorkspaceRoleOwner || r == WorkspaceRoleAdmin || r == WorkspaceRoleEditor
}
// CanView returns true if the role has any access.
func (r WorkspaceRole) CanView() bool {
return r == WorkspaceRoleOwner || r == WorkspaceRoleAdmin || r == WorkspaceRoleEditor || r == WorkspaceRoleViewer
}
// IsOwner returns true if the role is owner.
func (r WorkspaceRole) IsOwner() bool {
return r == WorkspaceRoleOwner
}