EdisonJwa
f1bc9a6c85
Imports the v0.9.2 documentation baseline and the bootstrap files required by docs/governance/repository-bootstrap-plan.md v0.1.0 §3, minus the justfile (added in the next commit). This commit establishes the git history for the project. All previous work lived only as filesystem state with no version control.
113 lines
6.7 KiB
Markdown
113 lines
6.7 KiB
Markdown
|
|
# Chanora External Reference Collection
|
|
|
|
**Version:** 0.9.2
|
|
**Status:** Baseline Candidate
|
|
**Language:** English
|
|
**Product:** Chanora
|
|
|
|
**Repo path:** `docs/references/external-references.md` ---
|
|
|
|
## 1. Material 3 and Flutter References
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| https://m3.material.io/ | Material 3 design system baseline |
|
|
| https://m3.material.io/foundations/design-tokens/overview | Material 3 design tokens |
|
|
| https://m3.material.io/styles/color/system/how-the-system-works | Material 3 color system |
|
|
| https://m3.material.io/styles/typography | Material 3 typography |
|
|
| https://m3.material.io/foundations/adaptive-design | Material 3 adaptive design |
|
|
| https://m3.material.io/components | Material 3 components |
|
|
| https://docs.flutter.dev/ui/design/material | Material Design in Flutter |
|
|
| https://docs.flutter.dev/ui/widgets/material | Flutter Material widget catalog |
|
|
| https://docs.flutter.dev/release/breaking-changes/material-3-default | Flutter Material 3 default behavior |
|
|
| https://docs.flutter.dev/release/breaking-changes/material-3-migration | Flutter Material 3 migration guidance |
|
|
| https://api.flutter.dev/flutter/material/ThemeData-class.html | Flutter ThemeData API |
|
|
| https://api.flutter.dev/flutter/material/ColorScheme-class.html | Flutter ColorScheme API |
|
|
| https://api.flutter.dev/flutter/material/ThemeExtension-class.html | Flutter ThemeExtension API |
|
|
|
|
## 2. Android and iOS Platform References
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| https://developer.android.com/develop/ui/compose/layouts/adaptive/use-window-size-classes | Android window size classes and adaptive layout reference |
|
|
| https://developer.android.com/guide/navigation/custom-back/predictive-back-gesture | Android predictive back behavior |
|
|
| https://developer.android.com/develop/connectivity/bluetooth/bt-permissions | Android Bluetooth permissions |
|
|
| https://developer.apple.com/design/human-interface-guidelines/ | Apple Human Interface Guidelines |
|
|
| https://developer.apple.com/documentation/avfaudio/avaudiosession/category-swift.struct | AVAudioSession category reference |
|
|
|
|
## 3. ASPICE and Requirements / Design Process References
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| `Automotive-SPICE-PAM-v40.pdf` | Automotive SPICE process model |
|
|
| https://www.ul.com/sis/resources/process-swe-1 | UL SWE.1 Software Requirements Analysis guidance |
|
|
| https://www.ul.com/sis/resources/process-swe-2 | UL SWE.2 Software Architectural Design guidance |
|
|
| https://www.ul.com/sis/resources/process-swe-3 | UL SWE.3 Software Detailed Design and Unit Construction guidance |
|
|
| https://www.ul.com/sis/resources/process-swe-4 | UL SWE.4 Software Unit Verification guidance |
|
|
| https://www.ul.com/sis/resources/process-swe-5 | UL SWE.5 Software Component Verification and Integration Verification guidance |
|
|
| https://www.ul.com/sis/resources/process-swe-6 | UL SWE.6 Software Verification guidance |
|
|
| https://www.ul.com/sis/insights/system-integration-and-integration-test-sys4-automotive-spice | UL SYS.4 System Integration and Integration Test guidance |
|
|
| https://polarion.code.blog/2021/11/10/swe-2-software-architectural-design/ | Polarion SWE.2 Software Architectural Design notes |
|
|
| https://polarion.code.blog/2022/04/21/swe-3-software-detailed-design-and-unit-construction/ | Polarion SWE.3 Software Detailed Design and Unit Construction notes |
|
|
| https://polarion.code.blog/2023/01/18/swe-4-software-unit-verification/ | Polarion SWE.4 Software Unit Verification notes |
|
|
| https://polarion.code.blog/2023/06/28/swe-5-software-integration-and-integration-test/ | Polarion SWE.5 Software Integration and Integration Test notes |
|
|
| https://polarion.code.blog/2025/06/05/swe-6-software-qualification-test/ | Polarion SWE.6 Software Qualification Test notes |
|
|
| https://polarion.code.blog/2025/08/06/sys-4-system-integration-and-integration-verification-a-spice-4-0/ | Polarion SYS.4 System Integration and Integration Verification notes |
|
|
|
|
## 4. Software Architecture and Design Document References
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| https://medium.com/codex/what-goes-in-a-software-architecture-document-e97d808d5cec | Software Architecture Document content and architecture views |
|
|
| https://www.atlassian.com/work-management/knowledge-sharing/documentation/software-design-document | Software Design Document structure, including overview, architecture, data design, interface design, component design, UI design, assumptions, dependencies, and glossary |
|
|
|
|
## 5. Use in Chanora Documentation
|
|
|
|
| Reference category | Applied to |
|
|
|---|---|
|
|
| Material 3 and Flutter | UI/UX guideline, design tokens, component catalog, adaptive layout, SysDes, SRS, SAD, SDD |
|
|
| Android and iOS platform references | Platform behavior guide, SysRS, SysDes, SRS, SAD, SDD |
|
|
| ASPICE references | SysDes, SRS, SAD, SDD, SWE.4, SWE.5, SWE.6, SYS.4, traceability matrix |
|
|
| Software architecture/design document references | SAD v0.3, SDD v0.3 |
|
|
|
|
## 6. Change History
|
|
|
|
| Version | Date | Description |
|
|
|---|---|---|
|
|
| 0.1.0 | 2026-05-14 | Initial reference collection. |
|
|
| 0.2.0 | 2026-05-14 | Added Atlassian software design document reference, UL SWE.2, UL SWE.3, Polarion SWE.2, Polarion SWE.3, and Medium SAD article reference. |
|
|
| 0.3.0 | 2026-05-14 | Added UL and Polarion references for SWE.4, SWE.5, SWE.6, and SYS.4 verification planning. |
|
|
|
|
---
|
|
|
|
## 7. Platform Release Policy Reference Addendum
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| Apple Developer - Upcoming Requirements | Apple App Store Connect SDK submission requirement; current baseline uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ on or after 2026-04-28 unless newer Apple policy applies. |
|
|
| Flutter supported platforms | Runtime platform support baseline; current decision uses iOS 13+ and Android API 24+ unless project constraints raise them. |
|
|
| Google Play target API level requirements | Android target SDK release gate; target the Google Play-required API level on upload date. |
|
|
|
|
|
|
## Baseline Candidate 0.9.1 Update
|
|
|
|
| Version | Date | Description |
|
|
|---|---|---|
|
|
| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ since 2026-04-28, platform baselines and decision traceability propagated across the document set. |
|
|
|
|
---
|
|
|
|
## 8. Apple SDK Gate Reference Correction
|
|
|
|
| Reference | Purpose |
|
|
|---|---|
|
|
| https://developer.apple.com/news/upcoming-requirements/?id=02032026a | Apple Upcoming Requirements page defining the App Store Connect upload build gate: since April 28, 2026, uploaded apps must be built with Xcode 26 or later using the applicable platform 26 SDK or later. |
|
|
|
|
|
|
## Baseline Candidate 0.9.2 Update
|
|
|
|
| Version | Date | Description |
|
|
|---|---|---|
|
|
| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
|