Architecture evidence register
NoteBaseline and scope
Evidence links are pinned to commit 8cfa4a786f1969a86c461908c66ceb37d821d96c. Line links support review but do not replace runtime testing. No production configuration, credentials, or data were inspected.
Claim register
| ID | Architecture claim | Status | Evidence | Remaining review |
|---|---|---|---|---|
| ARCH-001 | NADABAS runs in Excel and exposes ribbon, form, and application-event entry points. | Source-verified | Ribbon callback, application events | Functional Excel test and UI inventory. |
| ARCH-002 | Startup loads database configuration from the Windows user registry; fields can include a user name and password. | Source-verified | Startup call, registry reads, registry writes | Deployment inventory and security decision on credential storage. |
| ARCH-003 | Global state distinguishes base, exchange, current, and optional satellite database roles. | Source-verified | Global database state, startup initialization | Confirm supported roles for each deployment. |
| ARCH-004 | Source supports SQL Server/SQL Express and Access .accdb; .mdb is rejected when opening. |
Source-verified | Database type enum, open selection | Record supported product, driver, and Office bitness versions. |
| ARCH-005 | Startup registers application events, initializes session objects, starts sleeping, and reads database settings. | Source-verified | auto_open |
Verify add-in and developer-mode startup in Excel. |
| ARCH-006 | Database opening connects by type, tests or initializes structures, loads settings and workbook metadata, and sleeps after failure. | Source-verified | OpenDatabase, schema initialization |
Test new/existing Access and SQL Server databases. |
| ARCH-007 | auto_close contains no explicit cleanup behaviour. |
Source-verified | auto_close |
Observe Excel shutdown and open resource handling. |
| ARCH-008 | Load/import validates workbook definitions, reads through the current database, updates workbook areas, records metadata, and closes the database. | Source-verified | GetDataToRange, load implementation |
Test base, exchange, batch, missing-data, and failure paths. |
| ARCH-009 | Save/export validates definitions, writes through shared database routines, updates workbook state, and closes the database. | Source-verified | Save_data, DoSaveData, shared ADO interface |
Verify transactions, conflict detection, permissions, rollback, and interrupted writes. |
Evidence maintenance
- Add or update a claim ID in the architecture page.
- Link the smallest relevant source or test evidence at the reviewed commit.
- Mark configuration-sensitive behaviour as environment-dependent.
- Add the reviewer role and unresolved question to the pull request.
- Update links when source lines move; do not change the historical baseline of an already released documentation version.
Evidence not yet available
The following evidence is intentionally not claimed:
- an authoritative supported-platform matrix;
- runtime traces for Access and SQL Server deployments;
- a complete database constraint, transaction, and concurrency model;
- threat-model approval or credential-storage remediation;
- accessibility testing with assistive technologies;
- acceptance by any regional body, member state, or national authority.