Przewodnik po Open MercatoPrzewodnik redakcyjny · nie jest oficjalną dokumentacją
Menu
GitHubEN

Rodzina pojęć 05 · dyscyplina zmiany

Konwencje inżynieryjne i kontrakty zgodności Open Mercato

Open Mercato traktuje nazwy, pliki, trasy, zdarzenia, identyfikatory funkcji, klucze DI, schematy, generowane rejestry i akceptację AI jako kontrakty o różnych klasach zgodności. Zmiany inżynieryjne mają więc jawny przebieg komend i weryfikacji. Konwencje zmniejszają ryzyko przypadkowego naruszenia, ale dopiero przegląd i testy pokazują, czy konkretna zmiana je zachowuje.

Udokumentowana konwencja kieruje przeglądem, ale nie jest runtime enforcement każdej własnej aplikacji.

Migawka źródeł:

ae856df1ecfc · sekcje ARCHITECTURE.md: 22, 23, 27, 30, 31, 32, 33

Odpowiedź bezpośrednia

Pozycja w systemie

Ta rodzina otacza każdą warstwę jako kontrakt zmiany: UI i język, zapisy AI, publiczne powierzchnie zgodności, generowanie, komendy deweloperskie, dowody przeglądu, decyzje architektoniczne i wspólną terminologię.

Cykl od zmiany do weryfikacji

Rozpoznaj klasę kontraktu, zmień źródło prawdy, wygeneruj artefakty pochodne, uruchom właściwe kontrole, opisz migrację i zachowaj most, gdy jest wymagany.

Cykl od zmiany do weryfikacjiRozpoznaj klasę kontraktu, zmień źródło prawdy, wygeneruj artefakty pochodne, uruchom właściwe kontrole, opisz migrację i zachowaj most, gdy jest wymagany.
01

Wspólny design system i reguły i18n definiują stabilne prymitywy, tokeny semantyczne i konwencje lokalizowanego tekstu użytkowego.

ui-shared

02

Narzędzia AI przygotowują mutację jako oczekującą akcję w zakresie wraz z podglądem; zapis uruchamia się dopiero osobną ścieżką potwierdzenia.

infrastructure-package

03

Publiczne powierzchnie są klasyfikowane jako frozen, stable, additive-only lub generated i wymagają etapowego mostu deprecacji przed usunięciem.

documented-convention

04

Generowanie, build pakietów, generowanie migracji, testy i synchronizacja ról są jawnymi krokami zależnymi od rodzaju zmiany źródłowej.

documented-convention

05

Checklista architektoniczna grupuje obowiązki dotyczące modułów, danych, API, komend, UI, rozszerzeń, bezpieczeństwa, runtime, zgodności i weryfikacji.

documented-convention

06

Kluczowe decyzje architektoniczne są zapisane w datowanych specyfikacjach i wskazane w autorytatywnym przewodniku architektury.

documented-convention

07

Glosariusz ustala znaczenie pojęć module, DataEngine, QueryEngine, command, UMES, subscriber, worker, scope, edition i terminów powiązanych.

documented-convention

Akceptacja mutacji AI jako konkretny kontrakt

Ścieżka akceptacji pokazuje, jak łączą się polityka, zakres, podgląd, idempotency i osobna trasa potwierdzenia.

  1. Narzędzia AI przygotowują mutację jako oczekującą akcję w zakresie wraz z podglądem; zapis uruchamia się dopiero osobną ścieżką potwierdzenia.

    product-factinfrastructure-package

  2. Publiczne powierzchnie są klasyfikowane jako frozen, stable, additive-only lub generated i wymagają etapowego mostu deprecacji przed usunięciem.

    documented-conventiondocumented-convention

  3. Generowanie, build pakietów, generowanie migracji, testy i synchronizacja ról są jawnymi krokami zależnymi od rodzaju zmiany źródłowej.

    documented-conventiondocumented-convention

  4. Checklista architektoniczna grupuje obowiązki dotyczące modułów, danych, API, komend, UI, rozszerzeń, bezpieczeństwa, runtime, zgodności i weryfikacji.

    documented-conventiondocumented-convention

Klasa kontraktu i obowiązek utrzymania

Klasa kontraktu i obowiązek utrzymania
MechanizmWniosek redakcyjnyOgraniczenieWłaściciel decyzji
Wspólny design system i reguły i18n definiują stabilne prymitywy, tokeny semantyczne i konwencje lokalizowanego tekstu użytkowego.Traktuj jako kontrakt w zakresie „ui-shared” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer
Narzędzia AI przygotowują mutację jako oczekującą akcję w zakresie wraz z podglądem; zapis uruchamia się dopiero osobną ścieżką potwierdzenia.Traktuj jako kontrakt w zakresie „infrastructure-package” i osobno potwierdź dopasowanie do projektu.Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.Lider inżynierii i reviewer
Publiczne powierzchnie są klasyfikowane jako frozen, stable, additive-only lub generated i wymagają etapowego mostu deprecacji przed usunięciem.Traktuj jako kontrakt w zakresie „documented-convention” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer
Generowanie, build pakietów, generowanie migracji, testy i synchronizacja ról są jawnymi krokami zależnymi od rodzaju zmiany źródłowej.Traktuj jako kontrakt w zakresie „documented-convention” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer
Checklista architektoniczna grupuje obowiązki dotyczące modułów, danych, API, komend, UI, rozszerzeń, bezpieczeństwa, runtime, zgodności i weryfikacji.Traktuj jako kontrakt w zakresie „documented-convention” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer
Kluczowe decyzje architektoniczne są zapisane w datowanych specyfikacjach i wskazane w autorytatywnym przewodniku architektury.Traktuj jako kontrakt w zakresie „documented-convention” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer
Glosariusz ustala znaczenie pojęć module, DataEngine, QueryEngine, command, UMES, subscriber, worker, scope, edition i terminów powiązanych.Traktuj jako kontrakt w zakresie „documented-convention” i osobno potwierdź dopasowanie do projektu.To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.Lider inżynierii i reviewer

Footguns i tryby awarii

Publiczne powierzchnie są klasyfikowane jako frozen, stable, additive-only lub generated i wymagają etapowego mostu deprecacji przed usunięciem.

To zatwierdzona konwencja inżynieryjna. Własna aplikacja może ją naruszyć i wymaga osobnego przeglądu.

Sprawdź przypięte źródło

Narzędzia AI przygotowują mutację jako oczekującą akcję w zakresie wraz z podglądem; zapis uruchamia się dopiero osobną ścieżką potwierdzenia.

Ten element jest opcjonalny lub wymaga osobnej konfiguracji, dlatego nie należy przedstawiać go jako zawsze włączonego.

Sprawdź przypięte źródło
Źródła i metoda · 7 rekordów dowodowych

Każdy fakt, węzeł, połączenie i krok przebiegu ma stabilny identyfikator, klasę twierdzenia, lokalizator źródła, zakres, ograniczenie oraz przypiętą wersję. Lokalny skrypt sprawdza istnienie każdego pliku i lokalizatora oraz pokrycie sekcji 1–33 dokładnie raz.

  • Wspólny design system i reguły i18n definiują stabilne prymitywy, tokeny semantyczne i konwencje lokalizowanego tekstu użytkowego.

    ID
    section-22-design-i18n
    Klasa
    documented-convention
    Zakres
    ui-shared
    Źródło
    ARCHITECTURE.md · ## 22. Design System and i18n Conventions

  • Narzędzia AI przygotowują mutację jako oczekującą akcję w zakresie wraz z podglądem; zapis uruchamia się dopiero osobną ścieżką potwierdzenia.

    ID
    section-23-ai-approval
    Klasa
    product-fact
    Zakres
    infrastructure-package
    Źródło
    packages/ai-assistant/src/modules/ai_assistant/lib/prepare-mutation.ts · export async function prepareMutation

  • Publiczne powierzchnie są klasyfikowane jako frozen, stable, additive-only lub generated i wymagają etapowego mostu deprecacji przed usunięciem.

    ID
    section-27-compatibility
    Klasa
    documented-convention
    Zakres
    documented-convention
    Źródło
    BACKWARD_COMPATIBILITY.md · ## Deprecation Protocol

  • Generowanie, build pakietów, generowanie migracji, testy i synchronizacja ról są jawnymi krokami zależnymi od rodzaju zmiany źródłowej.

    ID
    section-30-development-commands
    Klasa
    documented-convention
    Zakres
    documented-convention
    Źródło
    ARCHITECTURE.md · ## 30. Development Workflow and Commands

  • Checklista architektoniczna grupuje obowiązki dotyczące modułów, danych, API, komend, UI, rozszerzeń, bezpieczeństwa, runtime, zgodności i weryfikacji.

    ID
    section-31-review-checklist
    Klasa
    documented-convention
    Zakres
    documented-convention
    Źródło
    ARCHITECTURE.md · ## 31. Conventions and Code-Review Checklist

  • Kluczowe decyzje architektoniczne są zapisane w datowanych specyfikacjach i wskazane w autorytatywnym przewodniku architektury.

    ID
    section-32-decisions
    Klasa
    documented-convention
    Zakres
    documented-convention
    Źródło
    ARCHITECTURE.md · ## 32. Key Architectural Decisions and Specs

  • Glosariusz ustala znaczenie pojęć module, DataEngine, QueryEngine, command, UMES, subscriber, worker, scope, edition i terminów powiązanych.

    ID
    section-33-glossary
    Klasa
    documented-convention
    Zakres
    documented-convention
    Źródło
    ARCHITECTURE.md · ## 33. Glossary