ivan-igorevich/mdm-ordinis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
308c9104e9636d0b13342f3e4611005589e1e002
mdm-ordinis/ordinis-cuod-bundle/manifest.yaml
T
Zimin A.N. 8adfd39bff feat(bundle): bundle hygiene v2 — manifest spec + signing verifier + docs 
Ships marketplace-design-v2 scoped to bundle hygiene (NO consumer UI, NO
install dialog, NO marketplace). 2-3 day cap respected — Approach C narrow
slice. Anti-feature commitment: scope creep → new design doc + /office-hours.

## What ships

### New module ordinis-bundle-spec
- BundleManifest.java — canonical apiVersion: ordinis.io/v1 record
  (Metadata + DictionaryEntry, Jackson-bindable, forward-compat ignoreUnknown)
- ManifestParser.java — YAML → record + structural validate
  (apiVersion/kind enforce, semver regex, bundle-id regex, path traversal
  guard на schemaRef, unique dict names, scope enum)
- BundleSignatureVerifier.java — ed25519 sign/verify (JDK 21 native)
- Zero Spring/JPA/Kafka deps — pure Java + Jackson YAML

### CUOD reference implementation
- ordinis-cuod-bundle/manifest.yaml — 40 dicts canonical entries
- Test fixture pin: cuod-manifest-fixture.yaml parses+validates clean
  (regression guard на каждом CI run)

### Tests
- 12 cases ManifestParser (happy + reject paths)
- 7 cases BundleSignatureVerifier (sign/verify roundtrip, tamper, wrong key)
- 1 case CUOD fixture pin
- Total 20 tests, all green

### Docs
- docs/integration/bundle-format-spec.md — formal spec для Java handoff
- docs/user-guide/bundle-authoring.md — how-to для новых bundle authors

## Why now (N=1 customer)

Per office-hours v2 decision: marketplace UI build = N customers value scale,
but bundle hygiene + sign format = AT N=1 ROI:
- Java team handoff requires documented spec независимо
- Sales demo «here's how customer #2 would ship custom bundle»
- Optionality для marketplace UI когда customer #2 LOI surfaces

## Explicitly NOT shipped (Phase 2 scope if ever)

- Publisher Maven plugin (separate artifact when actual publish needed)
- Browse catalog UI / install dialog (no customer #2 with use case)
- Dep resolution / topological install
- Multi-tenant Nexus namespacing
- Bundle uninstall flow
2026-05-17 10:39:07 +03:00

182 lines
6.4 KiB
YAML
Raw Blame History

# Bundle manifest spec — apiVersion: ordinis.io/v1, kind: Bundle
# Canonical bundle authoring artifact. См. docs-internal/design/dictionary-marketplace.md
# Парсинг через cloud.nstart.terravault.ordinis.bundle.spec.ManifestParser.
apiVersion: ordinis.io/v1
kind: Bundle
metadata:
id: ru.cuod.dzz-ground-segment
name: ЦУОД ДЗЗ — наземный сегмент
version: 1.0.0
description: |
40 справочников для управления наземным сегментом ДЗЗ:
космические аппараты, типы КА, наземные станции, антенны,
частотные диапазоны, операторы, оборудование, миссии и т.д.
domain: dzz
scope: PUBLIC
author: ЦУОД team
license: proprietary
# signature заполняется ordinis-bundle-publisher CLI на publish step.
dictionaries:
- name: acquisition_mode
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/acquisition_mode.schema.json
- name: antenna
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/antenna.schema.json
- name: atmospheric_correction
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/atmospheric_correction.schema.json
- name: climatic_zone
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/climatic_zone.schema.json
- name: compression_algorithm
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/compression_algorithm.schema.json
- name: consumer
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/consumer.schema.json
- name: consumer_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/consumer_type.schema.json
- name: contract_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/contract_type.schema.json
- name: coordinate_system
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/coordinate_system.schema.json
- name: country
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/country.schema.json
- name: coverage_zone
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/coverage_zone.schema.json
- name: data_format
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/data_format.schema.json
- name: deliverable_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/deliverable_type.schema.json
- name: frequency_band
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/frequency_band.schema.json
- name: geometric_correction
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/geometric_correction.schema.json
- name: ground_station
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/ground_station.schema.json
- name: imaging_task_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/imaging_task_type.schema.json
- name: inclination_class
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/inclination_class.schema.json
- name: industry_sector
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/industry_sector.schema.json
- name: instrument
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/instrument.schema.json
- name: land_cover_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/land_cover_type.schema.json
- name: launch_site
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/launch_site.schema.json
- name: launch_vehicle
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/launch_vehicle.schema.json
- name: license_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/license_type.schema.json
- name: map_projection
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/map_projection.schema.json
- name: mission
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/mission.schema.json
- name: modulation_scheme
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/modulation_scheme.schema.json
- name: operator
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/operator.schema.json
- name: orbit_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/orbit_type.schema.json
- name: orbital_regime
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/orbital_regime.schema.json
- name: polarization
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/polarization.schema.json
- name: priority_class
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/priority_class.schema.json
- name: processing_level
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/processing_level.schema.json
- name: qa_flag
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/qa_flag.schema.json
- name: resolution_class
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/resolution_class.schema.json
- name: satellite_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/satellite_type.schema.json
- name: sensor_type
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/sensor_type.schema.json
- name: spacecraft
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/spacecraft.schema.json
- name: spacecraft_status
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/spacecraft_status.schema.json
- name: spectral_band
schemaVersion: 1.0.0
scope: PUBLIC
schemaRef: src/main/resources/bundles/cuod/spectral_band.schema.json
Reference in New Issue View Git Blame Copy Permalink