Documentation / Overview

Core concepts & lifecycle

Submissions, departments, approval tiers, meetings and statuses.

A handful of ideas explain almost everything in CLIF: the submission, the departments that review it, the approval tiers those departments belong to, the two levels of users in every department, and the Board meeting the submission is heading for.

Submissions#

A submission is one item for the Board of Estimates: a contract, an agreement, a grant, an expenditure and so on. It belongs to a submitting department and is identified by its Submission Id, built from a prefix, the two-digit year and a running number (SB-25-1234). Each submission holds:

  • what is asked of the Board (category, transaction type, requested action, vendor, action period);
  • the money involved (contracts and funding sources, which also drive the 1% for Public Art calculation);
  • the background explanation, SMBA&D participation goals, employment requirements and impacted addresses;
  • supporting documents, activity notes and a full change log;
  • its approval boxes, its meeting date and, after the meeting, the Board's votes and minutes.

Departments and roles#

Departments are the City agencies, plus a few virtual departments used for Board office work (such as BOE Operations and BOE Clerk). Inside each department, people hold department roles. The standard roles are:

RoleUsed byTypical work
SubmitterSubmitting departmentsWrites the submission and marks it ready (Level 1).
Submission approverSubmitting departmentsAssigns submitters and approves the department's submission (Level 2).
Review UserReviewing departmentsReviews the submission and marks the review ready (Level 1).
Review approverReviewing departmentsAssigns reviewers and approves the review (Level 2).

Department roles decide what you do on a submission. What you can open in CLIF (menus and pages) is decided separately by your access role.

Approval tiers#

Review happens in tiers, shown as columns on the submission's Approvals tab. A tier only becomes editable when every department in the previous tier has finished. The standard setup is:

1. PresubmissionEarly legal review (Law).
2. SubmissionThe submitting department prepares and approves the item.
3. ApprovalReviewing departments such as Finance, BAPS, SMBA&D, Audits.
4. ValidationBOE Operations validates and picks the meeting date.
5. ConfirmationThe BOE Clerk confirms; the submission is finalized.

Which departments appear in the Approval tier depends on the submission's category and transaction type; see How routing works. Your organization may have configured different tiers.

Approval boxes and the two levels#

Each department in a tier gets an approval box on the submission. Every box is worked by two levels of users:

  • Level 2 (approver) assigns the box to a Level 1 user, and at the end approves or does not approve.
  • Level 1 (submitter or reviewer) does the work and moves the box through In progress, optionally Waiting, to Ready.

A box is complete when Level 1 is Ready and Level 2 has Approved.

Statuses#

The same status icons are used on the Approvals tab, in the submission's side panel and on My Tasks.

StatusSet byMeaning
Not assignedLevel 2Nobody has been assigned to review yet.
AssignedLevel 2A Level 1 user has been assigned.
In progressLevel 1The submission is being prepared or reviewed.
WaitingLevel 1On hold, waiting for third-party information.
ReadyLevel 1The work is done and ready for approval.
ApprovedLevel 2The department approves.
Not approvedLevel 2The department does not approve; the box is no longer complete.
WithdrawnLevel 2Withdrawn by the submitting department (Submission and Validation tiers).
DeferredBOEMoved to another meeting date.
RejectedBOERejected.

Meetings and cutoff dates#

The Board meets on scheduled meeting dates. Each meeting has a cutoff date, by default a week earlier, after which items are no longer added for that meeting. The header shows the cutoff countdown, and each submission's side panel shows the meeting it is scheduled for. The meeting date is chosen during Validation; see Meeting schedules & dates.

Finalized, archived and read-only#

  • Finalized: the last tier has approved. The submission becomes read-only and the banner "This submission is finalized and currently in read-only status" is shown.
  • Archived: a flag you can set in the side panel to move the submission out of the everyday lists. Archived submissions are listed with List archived.
  • Read-only tabs: even before finalization you can only edit the tabs your tier allows; see Who can edit what.
An unhandled error has occurred. Reload 🗙