Narazil jsem ale na věc, která mi udělala neskutečnou radost: Sponzorovaný přístup k normám.

Ve zkratce: Agentura ČAS (Česká agentura pro standardizaci) umožňuje bezplatné prohlížení vybraných norem, které jsou pro veřejnost “sponzorovány” státem (ministerstvy). Typicky jde o normy, které jsou závazné v rámci nějakých předpisů.

Stačí se zaregistrovat a člověk má okamžitě přístup k fulltextům přímo v prohlížeči. Žádné složité papírování, žádné faktury za každé nahlédnutí.

Pro mě jako pro někoho, kdo se v tom občas potřebuje vrtat a nechce u toho porušovat autorská práva, je to naprostý game changer. Pokud se pohybujete kolem techniky, doporučuji vyzkoušet – ten seznam dostupných norem je překvapivě široký.

Myšlenka je jednoduchá. Děti, když přijdou ze školy nebo školky, vidí přímo na destičce, nástěnce, kapsáři nebo čemkoliv takovém, co je čeká a co mají hotové. Až budou mít hotové všechny povinnosti, tak si mohou jít hrát. (Podobně se to dá využít cestou do školy. Tedy aby si vzaly klíče, svačinu a podobně.)

A jelikož naše děti mají rády různá světélka a tlačítka, tak jsme se rozhodli jim to udělat trochu v jejich stylu. Řekli jsme si, že úkolů bude maximálně 8. Máme tři děti, kdy každé má svou sadu úkolů. Proto by naše deska měla obsahovat tlačítka a světélka ve třech řádcích po osmi sloupcích. Na konci každého řádku by pak měla být nějaká konečná informace o tom, zda děti už mají volno, anebo musí ještě něco splnit.

Výsledný produkt by tedy mohl vypadat nějak takto:

Možná si teď říkáte, proč prostě nepoužít tablet. Důvod je jednoduchý. Nechce se nám a ani nechceme děti vázat na tablet. Zároveň věcí na baterie máme až až, a tak by to chtělo napájení ze sítě, ale nějaké bezpečné.

USB nabíječek na mobilní telefony a podobně máme doma dostatek, tak by nebylo špatné, kdyby se zařízení napájelo z USB. Pokud pomineme PD přes USB, tak tedy počítejme s 5 V a maximálním proudem kolem 1 A.

Původně jsem chtěl objednat všechny potřebné součástky na , zejména kvůli přehlednému vyhledávání a datasheetu u každé položky. Bohužel to vycházelo o hodně dráž, než jsem byl ochoten obětovat na takový malý projekt. A tak jsem objednal součástky na .

Základem objednávky byla vývojová deska ESP32, step-up měnič, pár multiplexorů, 3× zelené signální světlo, 3× červené signální světlo, 30 žlutých LED diod, tranzistorové pole a pár rezistorů různých hodnot (zejména kvůli nedostatečnému popisu LED).

Měnič je potřeba zejména kvůli signálním světlům, která vyžadují 12 V.

Dále je nutné v nějakém hobby marketu koupit překližku, ze které se vytvoří krabice, ve které tato elektronika bude žít, ale to si nechám na příští příspěvek.

Nejsem samý úsměv, ani nechci být,
nejsem vášnivý, neumím moc snít.
Život mnohdy nedává mi smysl,
ale bez tebe bych ho neunesl.

Nechci se hádat, nechci se přít,
chci jen pokojně vedle tebe být.
Nechci ti sloužit, nechci tě vést,
toužím jen břímě života s tebou nést.

Často šetřím slovy a dotyky též,
však že tě miluji, to není lež.
Často jsem zamlklý, nemluvím moc,
to proto, že slova mají obrovskou moc.

Často tě raním jen pouhým slovem,
neříkám přitom nic s nějakým hněvem.
Často tě raním a nevím jak,
ty cítíš se, jak přejel by tě vlak.

Já vždy jen chtěl, aby ses smála,
já vždy jen chtěl, aby ses nebála,
já vždy jen chtěl tu s tebou být,
já vždy jen chtěl pro tebe tu být.

Možná jsem unaven, necítíš něhu,
je chladno jak v kupě ležícího sněhu,
však moje srdce pro tebe bije,
mysl však lásku tráví jako zmije.

Tak už se netrap, neplač po nocích,
i když smutek ti nevidím na očích.
Tak už se netrap, neplač zas znovu,
miluji tě — to řeknu klidně znovu.

V dnešním rychlém světě vývoje softwaru je kvalita klíčová. Jedním z nejlepších způsobů, jak ji zajistit, je Test-Driven Development (TDD) a psaní čistých, udržitelných testů.

Výchozí bod: Implementace nové funkcionality (a první testy)

Představme si, že naším úkolem je implementovat API endpoint pro vytváření nového „Eligible Collateral“ pro danou protistranu.

Produkční kód (EligibleCollateralSpringFacade.java)

public class EligibleCollateralSpringFacade {
    public EligibleCollateralDetail create(final Counterparty counterparty, final EligibleCollateralCreate create) {
        validateCounterpartyId(counterparty);
        final var eligibleCollateral = create.toDomain(counterparty);
        final var stored = this.service.save(eligibleCollateral);
        return EligibleCollateralDetail.from(stored);
    }

    private void validateCounterpartyId(final Counterparty id) {
        // Validace existence protistrany
    }
}

První testy (EligibleCollateralsAcceptanceTest.java)

public class EligibleCollateralsAcceptanceTest {
    @Autowired MockMvc mockMvc;
    @Autowired AuthenticatedTestApi authenticationApi;

    @Test
    public void created_eligible_collaterals_contains_filled_in_information() throws Exception {
        authenticationApi.logInAsRisk();
        Long counterpartyId = 4L;
        String requestJson = "{"name": "Eligible Name", "isin": "isin123"}";

        mockMvc.perform(post("/api/non-clients/{id}/eligible-collaterals", counterpartyId)
                .content(requestJson)
                .contentType(MediaType.APPLICATION_JSON)
                .session(authenticationApi.getSession()))
            .andExpect(status().isOk())
            .andExpect(jsonPath("name").value("Eligible Name"))
            .andExpect(jsonPath("isin").value("isin123"));
    }
}

Krok 1: Refaktoring – Vytvoření Test API

EligibleCollateralsTestApi.java

@Component
public class EligibleCollateralsTestApi {
    @Autowired MockMvc mockMvc;
    @Autowired AuthenticatedTestApi authenticationApi;

    public ResultActions create(Long counterpartyId, String eligibleCollateralJson) {
        return mockMvc.perform(post("/api/non-clients/{id}/eligible-collaterals", counterpartyId)
            .content(eligibleCollateralJson)
            .contentType(MediaType.APPLICATION_JSON)
            .session(authenticationApi.getSession()));
    }

    public AuthenticatedTestApi authentication() { return authenticationApi; }
    public Long existingNonClient() { return 4L; }
}

Upravený test

@Test
public void created_eligible_collaterals_contains_filled_in_information() throws Exception {
    api.authentication().logInAsRisk();
    Long counterpartyId = api.existingNonClient();
    String requestJson = "{"name": "Eligible Name", "isin": "isin123"}";

    api.create(counterpartyId, requestJson)
        .andExpect(status().isOk())
        .andExpect(jsonPath("name").value("Eligible Name"))
        .andExpect(jsonPath("isin").value("isin123"));
}

Krok 2: Refaktoring – Zavedení Response Objectu

EligibleCollateralsDetailReponse.java

public class EligibleCollateralsDetailReponse {
    private final ResultActions resultActions;

    public EligibleCollateralsDetailReponse(ResultActions resultActions) {
        this.resultActions = resultActions;
    }

    public EligibleCollateralsDetailReponse expectStatusOk() {
        expect(status().isOk());
        return this;
    }

    public EligibleCollateralsDetailReponse expectName(String expected) {
        expect(jsonPath("name").value(expected));
        return this;
    }

    public void expectIsin(String expected) {
        expect(jsonPath("isin").value(expected));
    }

    private void expect(ResultMatcher matcher) {
        this.resultActions.andExpect(matcher);
    }
}

Upravený test

@Test
public void created_eligible_collaterals_contains_filled_in_information() {
    api.authentication().logInAsRisk();
    Long counterpartyId = api.existingNonClient();
    String requestJson = "{"name": "Eligible Name", "isin": "isin123"}";

    api.create(counterpartyId, requestJson)
        .expectStatusOk()
        .expectName("Eligible Name")
        .expectIsin("isin123");
}

Krok 3: Refaktoring – Test Data Builder (EligibleDraft.java)

EligibleDraft.java

@Data
@AllArgsConstructor
@Accessors(fluent = true)
public class EligibleDraft {
    @Nullable @JsonProperty("name")
    private String name;

    @Nullable @JsonProperty("isin")
    private String isin;

    public String toJson() {
        final var om = new ObjectMapper();
        return om.writeValueAsString(this);
    }
}

Rozšíření Test API

public EligibleDraft prefilledEligibleDraft() {
    return new EligibleDraft("Default Eligible Name", "DefaultISIN123");
}

public EligibleCollateralsDetailReponse create(Long counterparty, EligibleDraft draft) {
    return create(counterparty, draft.toJson());
}

Test s builderem

@Test
public void created_eligible_collaterals_contains_filled_in_information() {
    api.authentication().logInAsRisk();
    final var counterparty = api.existingNonClient();
    final var draft = api.prefilledEligibleDraft()
                         .name("Eligible Name")
                         .isin("isin123");

    api.create(counterparty, draft)
        .expectStatusOk()
        .expectName("Eligible Name")
        .expectIsin("isin123");
}

TDD v praxi: Přidání kontroly oprávnění

Test na nedostatečná oprávnění

@Test
public void create_eligible_with_insufficient_permissions_collaterals_returns_error() {
    api.authentication().logInAsBranchWorker();
    final var counterparty = api.existingNonClient();
    final var draft = api.prefilledEligibleDraft();

    api.create(counterparty, draft)
        .expectStatusForbidden();
}

Implementace zabezpečení

@Secured(DafosPermissions.EDIT_COUNTERPARTY_LIMITS)
public EligibleCollateralDetail create(final Counterparty counterparty, final EligibleCollateralCreate create) {
    validateCounterpartyId(counterparty);
    final var eligibleCollateral = create.toDomain(counterparty);
    final var stored = this.service.save(eligibleCollateral);
    return EligibleCollateralDetail.from(stored);
}

Závěr: Investice, která se vyplatí

Dobře navržená testovací infrastruktura přináší:

• Větší důvěru při refaktoringu.
• Rychlejší odhalování chyb.
• Lepší dokumentaci systému.
• Snazší onboarding nových vývojářů.
• Nižší náklady na údržbu a rozvoj aplikace.

Nástroj se jmenuje TLDR a najdete jej na:

https://web.archive.org/web/20250308214949/https://tldr.sh/

Hlavní kámen úrazu pro takové větší výlety je ten, že naše dcera je na invalidním vozíku. Ještě je tedy malá, takže se dá použít kočárek, který je do terénu přeci jen o něco vhodnější, ale z něj velmi rychle vyroste. Už teď je na něj veliká.

Shodou náhod jsme však objevili, že existuje takové obrácené zahradní kolečko. Má to více variant, ale to, které nás zaujalo opravdu vypadá skoro jako zahradní kolečko. Hlavní rozdíl je ten, že jej táhnete za sebou místo toho, aby bylo před Vámi. Umístíte do něj dítě, připnete si jej k bedernímu pásu a můžete vyrazit na cestu. Přepravovaná osoba může mít až 60 kg, což by nám mělo na nějakou dobu vystačit.

Není to tedy zrovna levná záležitost. Cenovka atakuje hranici 100k, ale myslíme, že by se jí to mohlo líbit.

Jedná se o takový vozíček, který za sebe zapřáhnete, dítě do něj položíte a hurá, můžete cestovat.

Abych to příště nemusel opět zdlouhavě hledat, řekl jsem si, že si to pro jistotu odložím sem.

Základ komunikace s AVR programátorem, který používám a nastavením clangu je pěkně shrnut v čĺánku Programming an Arduino the Hard Way. Raději jsem přiložil verzi z archive.org.

Co se týče mé LSP konfigurace v neovimu, tak používám Mason a lspconfig a clang tedy vypadá jen jako

require 'lspconfig'.clangd.setup{}