Changes between Version 8 and Version 9 of Public/Docs/CinnamonArchitecture


Ignore:
Timestamp:
Dec 29, 2025, 1:14:21 PM (2 days ago)
Author:
Administrator
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Public/Docs/CinnamonArchitecture

    v8 v9  
    77== Components
    88=== Cinnamon Server
    9 The server is the core Cinnamon component. Accessing all backend data and secondary services is exclusively done through the API. Thus, clients don't have and don't need access to the database, the content or the index directly, don't store backend credentials and can't bypass server functionality like permission checking. The API is complete in the sense that all client components like CDCplus, CAE or Change Trigger are implemented using API methods and nothing else.
     9The server is the core Cinnamon component. Accessing all backend data and secondary services is exclusively done through the API. Thus, clients don't have and don't need access to the database, the content or the index directly, don't store backend credentials and can't bypass server functionality like permission checking. The API is complete in the sense that all client components like CDCplus, CAE or Change Trigger are implemented using API methods and nothing else. Likewise, the API exposes complete admin functionality for user accounts in the {{{_superusers}}} group.
    1010
    1111The Cinnamon Server API is based on {{{http(s)}}}/{{{XML}}}. Find the documentation here: https://github.com/dewarim/cinnamon4/blob/master/docs/api.md
    … …  
    1414
    1515=== Database
     16Cinnamon uses a PostgreSQL database for structured storage of information like these:
     17* System data for folders and objects.
     18* Metadata for folders and objects.
     19* Relations between objects.
     20* Configuration and taxonomies.
     21* User / group / permission / lifecycle managemnent.
    1622
     23The database is exclusively accessed by Cinnamon Servers. All client applications must use the API.
    1724
    1825=== Content
     26Content files are stored in the server (virtual) machine's file system, or on a separate volume mounted to the file system. Like the database, the content files can't be accessed directly from the clients, the API must be used, where e.g. permission checking applies.
     27The content files are not named and organized as they appear in the folder structure view in the client, rather Cinnamon Server stored them in a generated path and keeps the content path with the object in the database.
     28
     29Backing up the server is done by backing up the content and a dump from the database. The data of a Cinnamon Server, including user accounts, permissions etc. can be completely restored from these data. The same technique can be used for duplicating a Cinnamon Server or for migration to a different machine.
    1930
    2031=== Index