---
id: SCR-ACC-BKS-007
title: Accounting projects configuration
route: '/console/{tenantId}/configuration/accounting/accountingProjects'
surface: console
product_area: accounting
module: books
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: >-
  Maintain project classifications and their descriptive end dates for a set of
  books.
supports:
  - CAP-ACC-BKS-008
permission: accounting.accounting-projects.read
entry_from:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
  - Navigation between Accounting setup screens
exits_to:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
displays:
  - field: Projects in the working unit ordered by code and display label
    source: listAccountingProjects
  - field: >-
      Project unit, fixed code, optional name, description, end date and
      availability
    source: getAccountingProject
actions:
  - label: Add Accounting Project
    operation_id: createAccountingProject
    permission: accounting.accounting-projects.create
    confirm: false
  - label: Save
    operation_id: updateAccountingProject
    permission: accounting.accounting-projects.update
    confirm: false
  - label: Deactivate or Activate
    operation_id: updateAccountingProject
    permission: accounting.accounting-projects.update
    confirm: false
  - label: Delete
    operation_id: deleteAccountingProject
    permission: accounting.accounting-projects.delete
    confirm: true
states:
  - empty
  - loading
  - error
  - read-only
  - inactive
validation:
  - BR-CAP-ACC-BKS-008-01
  - BR-CAP-ACC-BKS-008-02
  - BR-CAP-ACC-BKS-008-04
  - BR-CAP-ACC-BKS-008-05
  - BR-CAP-ACC-BKS-008-08
patterns:
  - >-
    Shared configuration list with search, sorting, availability filtering and
    an empty state
  - 'Permission-gated bulk activation, deactivation and deletion'
  - Deletion confirmation; availability changes are immediate
  - Editor unsaved-changes protection
  - Accounting read loading and error panels
  - Side-panel editor with the unit selector first
  - Working-unit filter and a single-row toolbar
component: components/configuration/resources/accounting-setup.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/configuration/resources/accounting-setup.tsx
  - >-
    react-console:components/configuration/config-list-screen.tsx:changeStatus;
    components/configuration/standard.tsx:standardCapabilities (shared-list
    behavior where applicable)
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-TEN-004, TC-DAT-004, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-005]
---

# Accounting projects configuration

## What the Screen Is For

Maintain project classifications and their descriptive end dates for a set of books.

## What It Shows and Lets People Do

The list and side panel offer project creation, replacement, availability changes and deletion. A project can be identified by its code without a name. The end date describes the project; it does not automatically change availability.

## States and Errors

The unit and uppercase code remain fixed after creation, and codes are limited to twenty characters. The console accepts an optional name and end date. Read-only users can inspect records; mutation failures and stale saves use shared error treatment.

## Patterns It Must Respect

Shared configuration list with search, sorting, availability filtering and an empty state. Permission-gated bulk activation, deactivation and deletion. Deletion confirmation; availability changes are immediate. Editor unsaved-changes protection. Accounting read loading and error panels. Side-panel editor with the unit selector first. Working-unit filter and a single-row toolbar.