237069c827
- add jz_bm_materials.revision (default 1), read-only for GORM
- bump it only on content changes (models.ReviseMaterial)
- PUT /materials/{id} locks the row and answers 409 to a stale revision
- management answers carry revision and updated_at, the student detail
carries revision
80 lines
3.0 KiB
Go
80 lines
3.0 KiB
Go
// Code generated by summer make. DO NOT EDIT.
|
|
|
|
package models
|
|
|
|
import (
|
|
"time"
|
|
|
|
"git.golem15.com/golem15/summercms/modules/lagoon/attach"
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
// MaterialTypes lists the allowed Material.Type values.
|
|
var MaterialTypes = []string{"pdf", "notatka", "link", "inne"}
|
|
|
|
// MaterialFilesField is the system_files field of a material's attachments
|
|
// (attachMany "files").
|
|
const MaterialFilesField = "files"
|
|
|
|
// Material is a study material: a note, a link or uploaded files, optionally
|
|
// tied to a course. A material without published_at is a draft and is not
|
|
// served by the API. A private material is visible only to its author and to
|
|
// the users it is shared with (MaterialShare); a public one to every student.
|
|
type Material struct {
|
|
ID uint `gorm:"column:id;primaryKey"`
|
|
CourseID *uint `gorm:"column:course_id"`
|
|
Course *Course `gorm:"foreignKey:CourseID"`
|
|
MeetingID *uint `gorm:"column:meeting_id"`
|
|
Meeting *Meeting `gorm:"foreignKey:MeetingID"`
|
|
Title string `gorm:"column:title"`
|
|
Type string `gorm:"column:type"`
|
|
Body *string `gorm:"column:body"`
|
|
Source *string `gorm:"column:source"`
|
|
URL *string `gorm:"column:url"`
|
|
PublishedAt *time.Time `gorm:"column:published_at"`
|
|
IsPrivate bool `gorm:"column:is_private"`
|
|
AuthorUserID *uint `gorm:"column:author_user_id"`
|
|
CreatedAt time.Time `gorm:"column:created_at"`
|
|
UpdatedAt time.Time `gorm:"column:updated_at"`
|
|
// Revision goes up by one on every content change (ReviseMaterial).
|
|
// It is read-only for GORM, so a full-row Save of a stale in-memory
|
|
// model never writes an old revision back; only ReviseMaterial changes
|
|
// it.
|
|
Revision uint `gorm:"column:revision;->"`
|
|
|
|
Tags []Tag `gorm:"many2many:jz_bm_material_tag;joinForeignKey:material_id;joinReferences:tag_id"`
|
|
}
|
|
|
|
// TableName is the plugin table.
|
|
func (Material) TableName() string { return "jz_bm_materials" }
|
|
|
|
// MorphName is the attachment_type of the material's system_files rows.
|
|
func (Material) MorphName() string { return `Jz\Bm\Models\Material` }
|
|
|
|
// Fillable lists the columns mass assignment may set.
|
|
func (Material) Fillable() []string {
|
|
return []string{"course_id", "meeting_id", "title", "type", "body", "source", "url", "published_at", "is_private", "author_user_id"}
|
|
}
|
|
|
|
// Rules are checked by the admin API on every save.
|
|
func (Material) Rules() map[string]string {
|
|
return map[string]string{
|
|
"title": "required|max:255",
|
|
"type": "required|in:pdf,notatka,link,inne",
|
|
"source": "nullable|max:500",
|
|
"url": "nullable|max:2048",
|
|
}
|
|
}
|
|
|
|
// AttachRelations declares the attachMany "files". The files are public:
|
|
// the student app links them by their storage URL.
|
|
func (Material) AttachRelations() []attach.Relation {
|
|
return []attach.Relation{{Name: MaterialFilesField, Many: true, Public: true}}
|
|
}
|
|
|
|
// BeforeSave stores NULL for empty optional text.
|
|
func (m *Material) BeforeSave(*gorm.DB) error {
|
|
blank(&m.Body, &m.Source, &m.URL)
|
|
return nil
|
|
}
|