feat(19.6.1-02): per-record locked permission values

- cabana.PermissionRecordLock and the optional PermissionRecordLockProvider
- RecordMeta.PermissionLocks (meta.permissionLocks) on show and save responses, notes localized
- save rule: a record-locked code keeps its stored value, a differing present value is 403
- Roles lock code-declared grants (locked_by_code); Administrators lock every override on your own record (locked_self)
- SPA: FORM_PERMISSION_LOCKS, locked codes never sent, record-locked rows in the permission editor
- regenerated admin OpenAPI and schema.d.ts; docs and README
This commit is contained in:
Jakub Zych
2026-10-22 11:29:25 +02:00
parent e2525d4956
commit 705f94d9e5
22 changed files with 588 additions and 60 deletions

View File

@@ -25,29 +25,30 @@ type usersAdmin struct {
}
var (
_ pact.AdminController = usersAdmin{}
_ pact.AdminPermissioned = usersAdmin{}
_ pact.AdminRecordSource = usersAdmin{}
_ pact.FormRecordTitle = usersAdmin{}
_ FieldRelationProvider = usersAdmin{}
_ pact.ListExtendQuery = usersAdmin{}
_ pact.FormExtendQuery = usersAdmin{}
_ pact.FormVirtualFields = usersAdmin{}
_ pact.FormRules = usersAdmin{}
_ pact.FilterOptions = usersAdmin{}
_ pact.FormBeforeCreate = usersAdmin{}
_ pact.FormBeforeUpdate = usersAdmin{}
_ pact.FormAfterUpdate = usersAdmin{}
_ RelationLockProvider = usersAdmin{}
_ PermissionEditorProvider = usersAdmin{}
_ recordDataExtender = usersAdmin{}
_ schemaFieldHider = usersAdmin{}
_ pact.ListRowStates = usersAdmin{}
_ pact.FormBeforeDelete = usersAdmin{}
_ pact.FormAfterDelete = usersAdmin{}
_ pact.HasAdminRecordActions = usersAdmin{}
_ pact.HasAdminBulkActions = usersAdmin{}
_ pact.AdminPartialData = usersAdmin{}
_ pact.AdminController = usersAdmin{}
_ pact.AdminPermissioned = usersAdmin{}
_ pact.AdminRecordSource = usersAdmin{}
_ pact.FormRecordTitle = usersAdmin{}
_ FieldRelationProvider = usersAdmin{}
_ pact.ListExtendQuery = usersAdmin{}
_ pact.FormExtendQuery = usersAdmin{}
_ pact.FormVirtualFields = usersAdmin{}
_ pact.FormRules = usersAdmin{}
_ pact.FilterOptions = usersAdmin{}
_ pact.FormBeforeCreate = usersAdmin{}
_ pact.FormBeforeUpdate = usersAdmin{}
_ pact.FormAfterUpdate = usersAdmin{}
_ RelationLockProvider = usersAdmin{}
_ PermissionEditorProvider = usersAdmin{}
_ PermissionRecordLockProvider = usersAdmin{}
_ recordDataExtender = usersAdmin{}
_ schemaFieldHider = usersAdmin{}
_ pact.ListRowStates = usersAdmin{}
_ pact.FormBeforeDelete = usersAdmin{}
_ pact.FormAfterDelete = usersAdmin{}
_ pact.HasAdminRecordActions = usersAdmin{}
_ pact.HasAdminBulkActions = usersAdmin{}
_ pact.AdminPartialData = usersAdmin{}
)
func (usersAdmin) ID() string { return AdministratorsControllerID }
@@ -584,6 +585,32 @@ func (usersAdmin) AdminPermissionValues(_ context.Context, field string, record
return decodePermissionValues(user.Permissions, true), nil
}
// AdminPermissionRecordLocks locks every offered permission on the
// editor's own record, shown with its stored override (1, -1, or 0 for
// inherit) and the locked_self note (D-08); other records have none.
// AdminSetPermissionValues still refuses a change on the own record.
func (c usersAdmin) AdminPermissionRecordLocks(ctx context.Context, field string, record any) ([]PermissionRecordLock, error) {
user, ok := record.(*BackendUser)
if field != usersPermissionsField || !ok || user == nil {
return nil, fmt.Errorf("cabana: administrators: cannot read permission field %q", field)
}
principal, _ := bouncer.User(ctx)
if principal == nil || user.ID == 0 || principal.ID != user.ID {
return nil, nil
}
stored := decodePermissionValues(user.Permissions, true)
options := catalogOptions(ctx, c.registry())
out := make([]PermissionRecordLock, 0, len(options))
for _, option := range options {
out = append(out, PermissionRecordLock{Code: option.Code, Value: stored[option.Code], Note: permissionLockedSelfKey})
}
return out, nil
}
// permissionLockedSelfKey is the note of every permission on the editor's
// own Administrators record.
const permissionLockedSelfKey = "backend::lang.permissioneditor.locked_self"
// AdminSetPermissionValues stores the override set on the record; the save
// writes the row. On the editor's own record any change is refused (D-08).
func (usersAdmin) AdminSetPermissionValues(ctx context.Context, field string, record any, values map[string]int) error {