From 5b20ebe800611386b5e829139cdb911d834819f0 Mon Sep 17 00:00:00 2001 From: Jaakko Vanhala Date: Sun, 12 Apr 2026 20:32:52 +0300 Subject: [PATCH] =?UTF-8?q?Opas:=20terminologia=20korjattu=20=E2=80=94=20r?= =?UTF-8?q?elaatio=20on=20taulu,=20relationship=20on=20yhteys?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- network-poc/frontend/public/GUIDE.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/network-poc/frontend/public/GUIDE.md b/network-poc/frontend/public/GUIDE.md index 7eace9a..39e3092 100644 --- a/network-poc/frontend/public/GUIDE.md +++ b/network-poc/frontend/public/GUIDE.md @@ -321,7 +321,7 @@ Malli tuottaa JSON-rakenteen kuten: Tämä on yksinkertainen tehtävä jossa pienikin malli onnistuu luotettavasti: entiteettien tunnistus projektin kuvauksesta ja kenttätyyppien valinta. -Speksi sisältää myös **relaatiot** entiteettien välillä: +Speksi sisältää myös **taulujen väliset yhteydet** (relationships): ```json { @@ -338,7 +338,7 @@ Speksi sisältää myös **relaatiot** entiteettien välillä: } ``` -Templateit generoivat relaatioista automaattisesti: +Templateit generoivat yhteyksistä automaattisesti: - `ForeignKey('authors.id')` models.py:hin - `relationship("Book", back_populates="author")` molempiin suuntiin - `BookDetail`-schema jossa author-data mukana @@ -348,14 +348,14 @@ Templateit generoivat relaatioista automaattisesti: ### Architect-agentti: speksin laatu ratkaisee Arkkitehti on **kriittisin agentti** koko pipelinessa. Jos speksi on hyvä -(oikeat entiteetit, kentät, relaatiot), kaikki muu seuraa automaattisesti. +(oikeat taulut, kentät, yhteydet), kaikki muu seuraa automaattisesti. Jos speksi on huono, templateitkaan eivät pelasta. Arkkitehtia ohjataan: -1. **Chain-of-thought**: "Mieti ensin entiteetit, sitten kentät, sitten relaatiot" +1. **Chain-of-thought**: "Mieti ensin taulut, sitten kentät, sitten yhteydet" 2. **Domain-esimerkit**: Todo, verkkokauppa, blogi — malli näkee miltä hyvä speksi näyttää 3. **Anti-patternit**: "Ei turhia ID-kenttiä, ei Enumeita, ei suomenkielisiä nimiä koodissa" -4. **Relaatiosäännöt**: "Jokainen `_id`-kenttä tarvitsee vastaavan relationship-merkinnän" +4. **Yhteyssäännöt**: "Jokainen `_id`-kenttä tarvitsee vastaavan relationship-merkinnän" Isompi malli (tai API) tässä yhdessä kohdassa parantaa kaikkien projektien laatua koska speksi on ainoa paikka jossa LLM:n ymmärrys vaikuttaa. @@ -380,7 +380,7 @@ class {entity.name}(Base): ``` Tulos: importit ovat aina oikein, `connect_args` on aina mukana, -relaatiot generoituvat oikein, testit importoivat `main.py`:stä eivätkä kopioi sitä. +taulujen yhteydet generoituvat oikein, testit importoivat `main.py`:stä eivätkä kopioi sitä. ### Vertailu: mittaustulokset @@ -392,7 +392,7 @@ relaatiot generoituvat oikein, testit importoivat `main.py`:stä eivätkä kopio | Docker build | vaihteleva | **100%** | | Pytest läpi | 0% | **100%** | | API toimii | ~30% | **100%** | -| Relaatiot (FK) | ei koskaan | **100%** | +| Taulujen yhteydet (FK) | ei koskaan | **100%** | | Nested endpointit | ei koskaan | **automaattisesti** | ### Milloin kumpikin toimii