Projects and Rules

At the heart of Assemblic is the Project. A project is a wrapper around a complete “Rules as Code” system, powered by OpenFisca and Git.

Projects List

Project Privacy

All projects are protected by an API Key by default. Projects that are protected by an API Key are marked with a small Shield Icon to the left of the project name. Protected Project Shield

You can toggle the Protected status, rename your project, or change its description by clicking the Manage button to open the project settings pane. Projects can also be deleted or archived from the manage pane.

Manage Project Pane

IMPORTANT

Deleting or Archiving project. Archived projects have their hosting application deleted, however, the git repository will move to archive status and can be recovered by restoring the project. Archive projects to do not count towards your project quota for your Team account. Deleted projects are permanently and completely deleted and cannot be recovered. Assemblic respects the user’s right to be forgotten.

Creating a Project

Go to the Projects section in your dashboard.
Select your desired Team from the dropdown menu.
Click Create New Project.
Enter a name and description, then confirm.

Assemblic will provision a new OpenFisca instance and a private Git repository for you. The repository is ready to clone locally or edit using the Rules Management interface immediately. Once the project is finalised, you can deploy it to production. The project will be in a Project ready state once the OpenFisca instance is ready to use.

NOTE

Detailed status updates will appear in the project list. Wait for the status to show Project ready before attempting to deploy or query your project.

The Rules Editor

Assemblic includes a full-featured web IDE for writing rules without leaving the browser. To access it, select the project you wish to edit from the context dropdown menu at the top of the screen, then click Rules Management in the sidebar.

Features

File Explorer: Navigate your project structure.
Code Editor: Syntax-highlighted editor for Python.
Git Integration: Commit and push changes directly from the UI.

Working with Git

Every Assemblic project is a standard Git repository.

Coding Locally

Prefer your own tools? You’ll need the authenticated Git URL and your credentials.

1. Get the Git URL

Quick Copy: Click the Copy icon next to the Git URL in the project list or in the Manage pane. This copies the full URL with your authentication token included.

TIP

This is the easiest way to clone without typing credentials manually.

2. Credentials (if needed) If you need manual credentials (username/password), you can find them in your Profile > Settings.

3. Clone the repository

git clone <your-authenticated-git-url>

4. Push to deploy Push changes to the main branch to trigger an automatic deployment.

Branching Strategy

Assemblic uses a standard 3-branch strategy for deployment:

main: Deploys to the Production environment.
stage: Deploys to the Staging environment.
develop: Deploys to the Development environment.

Project Status

You can monitor the operational status of your production projects at any time by visiting the Project Status page.

This page displays the real-time uptime of your projects.
Alerts: If a production project goes down, an outage notification will be sent to the Team Owner’s email address.

User documentation