Portal Community
BizFirstAI Portal / Error Management / Scalability

Error Code Structure & Scalability

Support for 100,000+ codes per product with zero conflicts.

Overview: The error code system uses a hierarchical structure to support 900,000 total codes across 9 products, with 100,000 codes available per product.

Hierarchical Structure

Error codes are organized in four levels for maximum organization and scalability:

Product Base (100,000 codes) ├── Feature Area (10,000 codes each - 10 features max) │ └── Sub-Category (1,000 codes each - 10 categories max) │ └── Sequential Code (00-99 per category)

Product Allocation (Level 1)

Each product gets 100,000 error codes in dedicated 100,000-code blocks:

Product Range Total Codes
FlowStudio 100000-199999 100,000
AppStudio 200000-299999 100,000
AtlasForms 300000-399999 100,000
Octopus 400000-499999 100,000
Passport 500000-599999 100,000
WorkDesk 600000-699999 100,000
BizFirstObserve 700000-799999 100,000
EdgeStream 800000-899999 100,000
Custom/Integration 900000-999999 100,000

Total Available: 900,000 error codes

Feature Area Organization (Level 2)

The second digit allocates 10,000-code blocks for major feature areas:

FlowStudio Example (100000-199999): 0 → Execution (100000-109999) - 10,000 codes 1 → Nodes (110000-119999) - 10,000 codes 2 → Canvas (120000-129999) - 10,000 codes 3 → DataBinding (130000-139999) - 10,000 codes 4 → Security (140000-149999) - 10,000 codes 5 → Store/State (150000-159999) - 10,000 codes 6 → Integration (160000-169999) - 10,000 codes 7 → Observability (170000-179999) - 10,000 codes 8 → Configuration (180000-189999) - 10,000 codes 9 → Reserved (190000-199999) - 10,000 codes

Sub-Category Organization (Level 3)

The third digit allocates 1,000-code blocks by error type within each feature:

Range (within feature) Error Type Codes
XX0000-XX0099 Validation/Input 100
XX0100-XX0199 Execution/Runtime 100
XX0200-XX0299 Data/Binding 100
XX0300-XX0399 State/Store 100
XX0400-XX0499 Permission/Security 100
XX0500-XX0599 Configuration 100
XX0600-XX0699 Integration/API 100
XX0700-XX0799 UI/Presentation 100
XX0800-XX0899 Resource/Performance 100
XX0900-XX0999 Miscellaneous 100

Code Format

Error-FlowStudio-100090
        │         │ │││
        │         │ ││└─ Sequential (00-99)
        │         │ │└── Sub-category (0-9)
        │         │ └─── Feature area (0-9)
        │         └────── Product base (1)
        └────────────── Product name

Scaling Examples

Small Project (< 100 codes)

Error-MyProduct-101000 to 101099
Uses 100 codes out of 10,000 available in feature area

Medium Project (100-1,000 codes)

Error-FlowStudio-100000 to 100999
Uses 1,000 codes out of 10,000 available in Execution feature

Large Project (1,000-10,000 codes)

Error-FlowStudio-100000 to 109999
Uses all 10,000 codes in Execution feature

Enterprise Scale (10,000+ codes)

Multiple feature digits allocated
100000-109999 (Execution #1: 10,000)
110000-119999 (Execution #2: 10,000)
120000-129999 (Execution #3: 10,000)
Total: 30,000+ codes for single feature

Benefits

✅ Scalability

100,000 codes per product, 900,000 total

✅ Organization

Hierarchical: Product → Feature → Category

✅ Searchability

Error code reveals source and context

✅ Uniqueness

Systematic approach prevents conflicts

✅ Growth

Allocate more digits as team grows

✅ Memory

Developers can remember ranges easily

Comparison: Old vs New

Aspect Old Structure New Structure
Codes per product 1,000 100,000
Scalability Limited Excellent
Organization Single feature area Multi-level hierarchy
Growth flexibility Requires restructure Allocate new digit
Teams per product 1-2 Unlimited

Migration Notes

✓ Existing codes remain valid:

Quick Start

  1. Read: Error Code Picker (Quick Reference)
  2. Choose: Your product from the 9 available
  3. Allocate: A feature area (use second digit)
  4. Pick: Next sequential code in that area
  5. Done: 100,000 codes available!

Related Pages