Skip to content

Create ICN repository for safety-critical graphics with S1000D-compliant structure#35

Merged
AmedeoPelliccia merged 11 commits intomainfrom
copilot/create-icn-repository-structure
Jan 13, 2026
Merged

Create ICN repository for safety-critical graphics with S1000D-compliant structure#35
AmedeoPelliccia merged 11 commits intomainfrom
copilot/create-icn-repository-structure

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 13, 2026

Replaces Unicode placeholder symbols with a proper S1000D-compliant ICN (Information Control Number) repository structure for all safety-critical graphics (9 AI/ML indicators + 7 H₂ hazard symbols). Enables certification-grade traceability, version control, and multi-resolution asset management.

Repository Structure

SSOT/LC03_SAFETY_RELIABILITY/graphics/
├── source/       # Master editables (.ai, .svg)
├── review/       # Under CCB review
└── approved/     # CCB approved masters

PUB/CSDB/ICN/
├── _index.csv                # Master registry (16 symbols)
├── ICN_SPECIFICATION.md      # Naming conventions & workflow
├── AI-ML/                    # 9 SVG symbols (ATA 95-40)
├── H2-HAZARD/               # 7 SVG symbols (ATA 28-10)
└── SAFETY-GENERAL/          # Future categories

ICN Naming Convention

Pattern: ICN-AMPEL360-S1-CCCSS-SSSS-NNN-V.ext

ICN-AMPEL360-S1-00095-0040-001-A.svg  → AI Active (ATA 95-40)
ICN-AMPEL360-S1-00028-0010-001-A.svg  → Cryogenic Hazard (ATA 28-10)

Components: ATA Chapter (CCC), Section (SS), Subsection (SSSS), Sequence (NNN), Variant (A-Z)

Placeholder SVG Implementation

All 16 symbols include:

  • 100×100 viewBox for scalability
  • RDF metadata with ICN identifier, title, creator, date, rights
  • Geometric placeholders (circles, triangles, paths) representing symbol semantics
  • Color-coded per aviation display standards (#0066CC=active, #00AA00=good, #FFAA00=warning, #CC0000=danger)

Example structure:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
  <title>AI-STAT-001: AI Active</title>
  <metadata>
    <dc:identifier>ICN-AMPEL360-S1-00095-0040-001-A</dc:identifier>
  </metadata>
  <circle cx="50" cy="50" r="45" fill="#0066CC"/>
</svg>

Documentation Updates

  • KNU-00-00-003-ICD-002: Replaced emoji tables with ICN markdown links
  • KNU-00-00-003-ICD-003: New ICD specifying ICN repository architecture
  • KNU_PLAN.csv: Added new KNU entry (KNOT-00-00-003 now 70% complete)
  • TBD_REGISTER.csv: Added TBD-00-00-003-ICD-003-001 for final human factors design
  • .gitattributes: Configured Git LFS for PNG/AI/PSD/EPS assets

Workflow

source/ → review/ → approved/ → PUB/CSDB/ICN/[category]/

CCB approval required before moving to approved/. Variant letter increments (A→B→C) for modifications; previous variants retained for traceability.

Registry Schema

_index.csv tracks: ICN, Symbol_ID, Name, Category, ATA Chapter/Section, Source File, Format, SHA256, Version, Status, Approval Date/By, Notes

Note: Current SVGs are geometric placeholders. Production symbols require human factors specialist design, pilot usability testing, and certification per DO-178C and EASA CS-25 (tracked as TBD-00-00-003-ICD-003-001).

Original prompt

Create ICN (Information Control Number) Repository for Safety-Critical Graphics

🎯 Objective

Replace Unicode placeholder symbols with a proper S1000D-compliant ICN repository structure for all safety-critical graphics (AI/ML indicators, H₂ hazard symbols). This enables certification-grade traceability, version control, and multi-resolution asset management.


📐 Architecture Overview

AMPEL360-Q100/
│
├── SSOT/                                    # Source of Truth
│   ├── LC03_SAFETY_RELIABILITY/
│   │   └── graphics/
│   │       ├── source/                      # Master editables (.ai, .svg)
│   │       │   └── README.md                # Source file guidelines
│   │       ├── review/                      # Under CCB review
│   │       │   └── .gitkeep
│   │       └── approved/                    # CCB approved masters
│   │           ├── AI-STAT-001_ai-active.svg
│   │           ├── AI-STAT-002_ai-confidence-high.svg
│   │           ├── AI-STAT-003_ai-confidence-low.svg
│   │           ├── AI-STAT-004_ai-degraded.svg
│   │           ├── AI-STAT-005_ai-override.svg
│   │           ├── AI-OOD-001_ood-detected.svg
│   │           ├── AI-OOD-002_ood-severe.svg
│   │           ├── AI-LRN-001_learning-enabled.svg
│   │           ├── AI-LRN-002_learning-frozen.svg
│   │           ├── H2-CRYO-001_cryogenic.svg
│   │           ├── H2-FLAM-001_flammable.svg
│   │           ├── H2-PRES-001_high-pressure.svg
│   │           ├── H2-ASPH-001_asphyxiation.svg
│   │           ├── H2-BOIL-001_boiloff-warning.svg
│   │           ├── H2-LEAK-001_leak-detection.svg
│   │           └── H2-VENT-001_venting-active.svg
│   │
│   └── LC04_DESIGN_DEFINITION/
│       └── graphics/
│           └── h2-symbols/
│               └── README.md                # H2-specific symbol guidelines
│
└── PUB/
    └── CSDB/
        └── ICN/                             # S1000D ICN Repository
            ├── _index.csv                   # ICN Registry
            ├── ICN_SPECIFICATION.md         # Naming convention docs
            ├── AI-ML/
            │   ├── ICN-AMPEL360-S1-00095-0040-001-A.svg
            │   ├── ICN-AMPEL360-S1-00095-0040-001-A.png
            │   ├── ICN-AMPEL360-S1-00095-0040-001-A@2x.png
            │   └── ... (all 9 AI/ML symbols)
            ├── H2-HAZARD/
            │   ├── ICN-AMPEL360-S1-00028-0010-001-A.svg
            │   ├── ICN-AMPEL360-S1-00028-0010-001-A.png
            │   └── ... (all 7 H2 symbols)
            └── SAFETY-GENERAL/
                └── .gitkeep

📁 Files to Create

1. ICN Specification Document

Path: PUB/CSDB/ICN/ICN_SPECIFICATION.md

# ICN (Information Control Number) Specification

## 1. Purpose

Define the naming convention, directory structure, and management procedures for graphic assets in the AMPEL360 Q100 Common Source Database (CSDB).

## 2. ICN Naming Convention

### 2.1 Format

ICN-AMPEL360-S1-CCCSS-SSSS-NNN-V.ext


### 2.2 Components

| Component | Format | Description | Example |
|-----------|--------|-------------|---------|
| ICN | Literal | Information Control Number prefix | ICN |
| AMPEL360 | Literal | Aircraft model identifier | AMPEL360 |
| S1 | Literal | System code (S1 = aircraft) | S1 |
| CCC | \d{3} | ATA Chapter (000-099) | 095 |
| SS | \d{2} | ATA Section (00-99) | 40 |
| SSSS | \d{4} | Subsection/Subject (0000-9999) | 0040 |
| NNN | \d{3} | Sequence number (001-999) | 001 |
| V | [A-Z] | Variant (A=original, B,C...=revisions) | A |
| ext | string | File extension | svg, png |

### 2.3 Examples

| ICN | Description |
|-----|-------------|
| ICN-AMPEL360-S1-00095-0040-001-A.svg | AI Active symbol (ATA 95-40) |
| ICN-AMPEL360-S1-00095-0040-002-A.svg | AI Confidence High (ATA 95-40) |
| ICN-AMPEL360-S1-00028-0010-001-A.svg | Cryogenic Hazard (ATA 28-10) |
| ICN-AMPEL360-S1-00028-0010-002-A.svg | Flammable H₂ (ATA 28-10) |

### 2.4 Regex Validation

```regex
^ICN-AMPEL360-S1-(\d{5})-(\d{4})-(\d{3})-([A-Z])\.(svg|png)$

3. Directory Structure

PUB/CSDB/ICN/
├── _index.csv              # Master registry
├── ICN_SPECIFICATION.md    # This document
├── AI-ML/                  # ATA 95 - AI/ML Systems
│   └── [ICN files]
├── H2-HAZARD/              # ATA 28 - H₂ Fuel Systems
│   └── [ICN files]
├── SAFETY-GENERAL/         # ATA 00 - General Safety
│   └── [ICN files]
└── [future categories]/

4. File Format Requirements

4.1 SVG (Primary Format)

  • Viewport: 100×100 units (scalable)
  • Stroke width: Minimum 2 units at base size
  • Colors: Named colors or hex (#RRGGBB)
  • Text: Converted to paths (no external fonts)
  • Metadata: Include title and description elements

4.2 PNG (Raster Fallback)

Resolution Filename Suffix Dimensions
1x (standard) .png 64×64 px
2x (retina) @2x.png 128×128 px
3x (high-DPI) @3x.png 192×192 px

4.3 Color Standards

| Status | Hex Code | RGB | Usage |
|--------|----------|...

This pull request was created from Copilot chat.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI self-assigned this Jan 13, 2026
Copilot AI and others added 2 commits January 13, 2026 00:21
Co-authored-by: AmedeoPelliccia <164860269+AmedeoPelliccia@users.noreply.github.com>
Co-authored-by: AmedeoPelliccia <164860269+AmedeoPelliccia@users.noreply.github.com>
Copilot AI changed the title [WIP] Create S1000D-compliant ICN repository for graphics Create ICN repository for safety-critical graphics with S1000D-compliant structure Jan 13, 2026
Copilot AI requested a review from AmedeoPelliccia January 13, 2026 00:28
@AmedeoPelliccia AmedeoPelliccia marked this pull request as ready for review January 13, 2026 00:28
Copilot AI review requested due to automatic review settings January 13, 2026 00:28
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request establishes an S1000D-compliant ICN (Information Control Number) repository for safety-critical graphics in the AMPEL360 Q100 project, replacing Unicode placeholder symbols with a structured asset management system. The PR creates a comprehensive framework for version-controlled graphic asset management covering 16 safety symbols (9 AI/ML indicators + 7 H₂ hazard symbols) with proper traceability, naming conventions, and workflow documentation.

Changes:

  • Created ICN repository structure with specification documents, master registry, and 16 placeholder SVG symbols
  • Established S1000D-compliant naming convention and directory organization (AI-ML, H2-HAZARD, SAFETY-GENERAL categories)
  • Updated existing documentation to reference ICN links instead of emoji placeholders
  • Added workflow documentation for source-to-publication graphic asset management with CCB approval gates
  • Configured Git LFS preparation in .gitattributes for future binary asset management

Reviewed changes

Copilot reviewed 10 out of 28 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
.gitattributes Configures LFS attributes for PNG/AI/PSD/EPS files (has minor syntax issue)
PUB/CSDB/ICN/ICN_SPECIFICATION.md Defines ICN naming convention and management procedures (has documentation clarity issues)
PUB/CSDB/ICN/_index.csv Master registry tracking all 16 symbols with metadata (descriptions don't fully match implementations)
PUB/CSDB/ICN/AI-ML/*.svg 9 AI/ML indicator placeholder SVGs (text not converted to paths, metadata inconsistent)
PUB/CSDB/ICN/H2-HAZARD/*.svg 7 H₂ hazard placeholder SVGs (text not converted to paths)
SSOT/LC04_DESIGN_DEFINITION/KNU-00-00-003-ICD-003_icn-repository-specification.md ICN repository ICD document (incorrectly claims to resolve already-resolved TBD)
SSOT/LC04_DESIGN_DEFINITION/KNU-00-00-003-ICD-002_aiml-indication-symbols.md Updated to reference ICN links instead of emoji placeholders
SSOT/LC04_DESIGN_DEFINITION/graphics/h2-symbols/README.md H₂ symbol design guidelines (missing hex code for one color)
SSOT/LC03_SAFETY_RELIABILITY/graphics/source/README.md Source file workflow documentation
SSOT/LC01_PROBLEM_STATEMENT/KNU_PLAN.csv Added new KNU entries (has empty field issue)
SSOT/LC01_PROBLEM_STATEMENT/TBD_REGISTER.csv Added new TBD for final graphic design
KNOT_STATUS_REPORT.md Updated progress tracking (has calculation error)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +38 to +42
### 2.4 Regex Validation

```regex
^ICN-AMPEL360-S1-(\d{5})-(\d{4})-(\d{3})-([A-Z])\.(svg|png)$
```
Copy link

Copilot AI Jan 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The regex pattern expects a 5-digit field followed by a 4-digit field, but the naming convention table describes these as separate CCC (3-digit) and SS (2-digit) fields. The actual format appears to be CCC+SS concatenated into 5 digits (e.g., "00095" = Chapter 095 + no section padding), followed by SSSS (4-digit subsection). The regex correctly validates the actual format but is inconsistent with the component breakdown in section 2.2. Either update the regex to match separate fields or clarify that CCCSS is a single concatenated 5-digit field.

Copilot uses AI. Check for mistakes.
Comment thread .gitattributes Outdated
AmedeoPelliccia and others added 7 commits January 13, 2026 02:00
…/00-00-general/PUB/CSDB/ICN/ICN_SPECIFICATION.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/00-00-general/SSOT/LC04_DESIGN_DEFINITION/graphics/h2-symbols/README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/00-00-general/PUB/CSDB/ICN/_index.csv

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/00-00-general/SSOT/LC01_PROBLEM_STATEMENT/KNU_PLAN.csv

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/00-00-general/KNOT_STATUS_REPORT.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/00-00-general/SSOT/LC04_DESIGN_DEFINITION/KNU-00-00-003-ICD-003_icn-repository-specification.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@AmedeoPelliccia AmedeoPelliccia merged commit b197afc into main Jan 13, 2026
5 of 7 checks passed
Copilot AI review requested due to automatic review settings March 23, 2026 23:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants