Add README.md

1 files changed, 99 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e41527e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,99 @@
+# SAME Analog Modular Ecosystem Specification
+
+[![License: CC BY-SA 4.0](https://img.shields.io/badge/Docs-CC%20BY--SA%204.0-lightgrey.svg)](LICENSE.md)
+[![License: CERN-OHL-S 2.0+](https://img.shields.io/badge/Hardware-CERN--OHL--S%202.0%2B-blue.svg)](LICENSE.md)
+[![License: GPL v3](https://img.shields.io/badge/Code-GPLv3-green.svg)](LICENSE.md)
+[![Built with Typst](https://img.shields.io/badge/Built%20with-Typst-008080.svg)](https://typst.app/)
+
+The **SAME Analog Modular Ecosystem** is an open-hardware specification and
+architecture for general-purpose analog computing. Designed for technological
+sovereignty, 50-year serviceability, and high-precision scientific computation,
+SAME bridges classical analog architectures with modern low-noise components and
+rigorous topological error compensation.
+
+## Key Features
+
+* **Multi-Tiered Precision:** Defines three distinct operational tiers sharing a
+  unified power and backplane infrastructure:
+  * **Metrologic Tier:** $0.001\%$ (10 ppm) precision, $90\text{ dB}$ SNR,
+    $<0.014\text{ ppm/h}$ drift.
+  * **Industrial Tier:** $0.01\%$ (100 ppm) precision, $80\text{ dB}$ SNR,
+    $<0.6\text{ ppm/h}$ drift.
+  * **Educational Tier:** $0.1\%$ (1000 ppm) precision, $70\text{ dB}$ SNR,
+    $<60\text{ ppm/h}$ drift.
+* **Robust Mechanical Infrastructure:** Individual $1.2\text{ mm}$ DC01 steel
+  shielding cassettes ($4\text{U}$ height, $38.0\text{ mm}$ width) housed in a
+  standard $19\text{"}$ rack enclosure with integrated convective ventilation
+  and EMI perimeter masking.
+* **Unified Power & Clocking:** DB-25 backplane distributing $\pm15.00\text{ V}$
+  analog, $\pm5.0\text{ V}$ digital, $\pm10.0000\text{ V}$ Kelvin-sensed
+  reference rails, a $90^\circ$ phase-stagger rail, and a system-wide
+  $10\text{ MHz}$ OCXO Master Oscillator for Pulse-Width Amplitude Modulation
+  (PWAM) compute cores.
+* **Executable Specification:** Built natively in Typst, featuring compile-time
+  mathematical assertions (`#assert-aeq`) embedded directly alongside typeset
+  equations to guarantee zero-copy consistency throughout the text.
+
+## Repository Structure
+
+```text
+.
+├── charts/                     # Vector charts built with CeTZ-plot
+├── diagrams/                   # Vector technical drawings & CAD layouts (CeTZ / Zap)
+├── lib/                        # Executable Typst helper functions & test harness
+│   ├── apply-prefix.typ        # SI prefix mathematical helper
+│   ├── assert-aeq.typ          # Float tolerance assertion library
+│   └── unify.typ               # Curried unit formatting wrappers
+├── listings/                   # Code examples and calibration log templates
+├── tables/                     # Modular specification data tables
+├── electrical-specifications.typ
+├── mechanical-specifications.typ
+├── module-design.typ           # Theoretical error budgeting & compensation
+├── introduction.typ
+├── preamble.typ                # Document entry point & main layout
+└── LICENSE.md                  # Comprehensive tri-license legal breakdown
+└── LICENSES                    # Actual licences text
+
+## Compiling the Specification
+
+### Prerequisites
+
+- [Typst CLI](https://github.com/typst/typst) (v0.15.1 or newer)
+- Fonts: standard system serif ans sans-serif fonts
+
+### Building the PDF
+
+To compile the entire specification from source:
+
+```bash
+typst compile preamble.typ specification.pdf
+```
+
+To enable live-recompilation during drafting:
+
+```bash
+typst watch preample.typ
+```
+
+**Note:** During compilation, Typst executes all internal assertions metrology
+checks. If any mathematical derivation or parameter in the text strays from
+defined engineering tolerances, compilation will halt with an assertion error.
+
+## Licensing
+
+This repository uses a multi-scope licensing model to ensure appropriate legal
+coverage across documentation, physical hardware, and executable code:
+
+* **Documentation & Text:** [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
+* **Hardware & Mechanical Designs:** [CERN-OHL-S-2.0+](https://www.google.com/search?q=https://ohwr.org/cernohl)
+* **Code, Libraries & Assertions:** [GPL-3.0-or-later](https://www.google.com/search?q=https://www.gnu.org/licenses/gpl-3.0.html)
+
+See [LICENSE.md](LICENSE.md) or full license texts.
+
+## Author & Contact
+
+**Denis Chevalier**
+
+Email: [perso@denischevalier.fr](mailto:perso@denischevalier.fr)
+
+Copyright © 2026 Denis Chevalier