Käyttöohjeet – Ylläpitov.1.05

Dokumenttien hallinta

Dokumentit

Ladataan…

Demokäyttäjä

Yksi demotunnus esittelyjä varten. Tunnuksia ei lähetetä mihinkään — kerrot ne itse. Salasana on tallennettu luettavassa muodossa, jotta näet sen tästä (silmäkuvake); käytä demotunnukselle salasanaa, jota et käytä missään muualla. Demokäyttäjä ei näy Käyttäjät-listassa.
Ladataan…

Käyttäjät

Kokonaismäärä, ei päiväkohtainen — laskuri ei nollaudu. 0 = ei rajaa. Yksittäiselle käyttäjälle voi asettaa oman enimmäismäärän rivin ✎-kuvakkeesta.
Ladataan…

Lisää uusi käyttäjä

Ladataan…

Lisää uusi dokumentti

Enintään 20 dokumenttia, kukin PDF enintään 50 Mt — kovakoodattu raja suojaamassa Cloudflaren ilmaistason käyttöä.

Miten muodostan chunks.json-tiedoston?

Ennen kuin voit lisätä uuden käsikirjan yllä olevalla lomakkeella, sen PDF pitää ensin käsitellä omalla koneellasi — tämä vaihe ei tapahdu automaattisesti selaimessa (katso syy alta).

  1. Hae käsikirjan PDF-tiedosto (esim. Ladatut-kansiosta)
  2. Avaa Resurssienhallinnassa kansio C:\Users\marko\.claude\code-projects\seal-oravanpyora\source\
  3. Raahaa PDF-tiedosto kansiossa olevan make_chunks.bat-tiedoston päälle
  4. Musta komentoikkuna avautuu hetkeksi ja käsittelee tiedoston — odota kunnes se sanoo "Valmis" ja paina sitten mitä tahansa näppäintä
  5. Samaan kansioon ilmestyy uusi tiedosto <PDF:n nimi>-chunks.json
  6. Jos komentoikkuna näyttää WARNING-rivin, se kertoo mitkä sivut jäivät lähes tyhjiksi tekstinpoiminnassa (usein kansi-/takakansisivuja, ei yleensä syytä huoleen) — tarkista silti tarvittaessa
  7. Lataa molemmat tiedostot (alkuperäinen PDF + juuri syntynyt chunks.json) yllä olevalla "Lisää uusi dokumentti" -lomakkeella
Miksi tätä ei voi tehdä kokonaan automaattisesti täällä sivustolla?

Tekstinpoiminta PDF:stä voitaisiin periaatteessa tehdä myös suoraan selaimessa lataushetkellä, mutta se tehtäisiin silloin eri tekniikalla (JavaScript) kuin nykyinen, laatutestattu paikallinen menetelmä (Python/pypdf). Eri poimintatavat voivat tuottaa hienovaraisesti erilaista tekstiä — rivitykset, välilyönnit, sivunumeroiden tunnistus — ja tämän projektin aiemmat laatuongelmat (esim. sisällysluettelosivujen suodatus, oikeat sivuviittaukset) on viritetty juuri nykyistä menetelmää vasten. Tämä paikallinen vaihe on tietoinen valinta luotettavuuden säilyttämiseksi, ei tekninen rajoite — make_chunks.bat tekee työn kertakäyttöisesti käynnistettynä, ei vaadi komentojen kirjoittamista käsin.

Palaute – käyttäjien viestit

Ladataan…

Palaute – vastausten arviot (👍/👎)

Ladataan…

Aukkoraportti

Kysymykset, joihin tekoäly vastasi "En löytänyt…", joiden vastaus katkesi pituusrajaan, tai jotka käyttäjä arvioi 👎. Näistä näkee mitä käsikirjasta tai promptista puuttuu. Tallennetaan vain kysymysteksti (ei vastausta) ja vain näissä tapauksissa. "Testaa" siirtää kysymyksen Testauspaneeliin.

Hätäkortit

Käyttäjien 🚨 Hätätilanne -välilehden kortit. Luo luonnokset käsikirjasta, tarkista ja muokkaa jokainen ja julkaise vasta sitten — vain julkaistut kortit näkyvät käyttäjille (ja tallentuvat heidän laitteelleen offline-käyttöä varten). Turvallisuuskriittistä sisältöä ei koskaan julkaista automaattisesti. Luonnoksen luonti maksaa n. 1 snt / kortti.

Kaaviokuvaus (näkömalli)

Tekstinpoiminta ei näe piirroksia (sulakerasia, tunkin paikka, ohjauspainikkeet). Tämä ajo renderöi jokaisen sivun kuvaksi selaimessasi, antaa sen näkömallin kuvattavaksi ja tallentaa kuvauksen sivun tekstin jatkoksi ja hakuindeksiin (sivu indeksoidaan samalla uudelleen, joten vaikutus näkyy heti). Hinta n. 0,3–0,5 snt/sivu eli noin 1–1,5 € per 300-sivuinen käsikirja. Ajon voi pysäyttää ja jatkaa myöhemmin. Pidä tämä välilehti auki ajon ajan (se saa olla taustalla).

Testauspaneeli

Ajaa kysymyksen oikean haku- ja vastausputken läpi ja näyttää mitä sivuja haettiin ja millä pisteillä. Toimii myös passiivisille dokumenteille, joten uuden käsikirjan laadun voi tarkistaa ennen aktivointia. Ei kirjaa mitään käyttäjätilastoihin eikä kuluta kysymysrajoja (mutta maksaa tavallisen vastauksen hinnan, n. 1 snt).