ӹjSrSSKrSSKrSSKrSSKrSrSrS\S\4Sjr S\S\4Sjr SS\S\ 4S jjr S \S\4S jr S\4S jrSS jrS\4SjrS\4Sjrg)uMEGOSZTOTT (KÖZÖS) DOKUMENTUMOK - segédek (v80). Leírás: docs/KOZOS_DOKUMENTUM.md MI EZ? A Használati utasítás / Gépkönyv / Adatlap NEM egy adott gépre szól, hanem a gép TÍPUSÁRA (gyártó + típus). Ezeket ezért nem kell gépenként újra fizikailag feltölteni: egy fájlra több gép hivatkozhat (Miklós kérése). HOGYAN MŰKÖDIK? * A megosztott fájl fizikailag az `uploads//kozos/` mappában van (NEM egy gép mappájában), és MINDEN érintett gépnek saját `File` sora van ugyanarra az útvonalra (`/uploads//kozos/`). Séma-változás nincs: a "hivatkozás" egyszerűen egy közös útvonalra mutató File-sor, ezért minden meglévő olvasó (fájllista, mobil napi ellenőrzés "Használati utasítás letöltése", rendszeradmin export, PDF-ek) változatlanul működik. * Az első megosztáskor a fájl a feltöltő gép mappájából a közös mappába költözik (másolás -> az adatbázis commit -> csak utána törlődik a régi példány, így egy sikertelen mentés nem veszít fájlt). * Törlés: egy hivatkozás törlése csak az adott gép sorát törli; a FIZIKAI fájl csak akkor törlődik, ha az utolsó hivatkozás is megszűnt (`arva_kozos_torlese`). A rendszeradmin gép- / céltörlése is ezt használja, így egy gép törlése nem viszi el a többi gép dokumentumát. * Kiszolgálás: `/uploads//kozos/` (routers/files.py) - akkor érhető el, ha a felhasználó LEGALÁBB EGY olyan gépet láthat (is_machine_allowed), amelynek van ilyen útvonalú File-sora (a gép-alapú ellenőrzés ide nem alkalmazható, mert a fájl nem egy gép mappájában van). N)uHasználati utasításu GépkönyvAdatlapkozos company_idreturncSUS[3$)uVA cég közös dokumentum-mappája (fájlrendszer-útvonal, tehát NINCS vezető '/').zuploads//)KOZOS_MAPPA_NEVrs */var/www/website/kozos_dokumentum_utils.py kozos_mappar s j\?"3 44c S[U5S3$)u?Az adatbázisban tárolt útvonal előtagja (vezető '/' -tel).r)r r s r kozos_prefixr"s {:&'q ))r c,U(dgUbUR[U55$URS5n[U5S:H=(aJ USS:H=(a; USR 5=(a! US[ :H=(a [ US5$) upIgaz, ha az útvonal egy közös mappába mutat (adott cégre, vagy - ha company_id None - bármelyik cégére).Fruploads) startswithrsplitlenisdigitr bool) file_pathrreszeks r kozos_utvonal_er's ##L$<== __S !F v;!  Dq Y 6 D6!9;L;L;N DSYZ[S\`oSo DtxyABzCuDDr rcUR[R5R[RRU:H5R 5$)u(Hány File-sor mutat erre az útvonalra.)querymodelsFilefilterrcount)dbrs r hivatkozas_szamr&1s8 88FKK ' ' (=(=(J K Q Q SSr cZ[URU5(agUR=(d SRS5nU(a$[RR U5(d [ U5e[U5n[R"USS9 [RRU5n[RRU5upV[S5HnUS:XaUO(US[R"5RS S U3nUSU3n [U S 5n [US 5n [ R""X5 S S S 5 S S S 5 SU -UlX)4s $ ['S 5e!,(df  N2=f!,(df  N;=f![$a Mf=f)uBiztosítja, hogy a File-sor fizikai fájlja a cég közös mappájában legyen. Ha még nem ott van: átmásolja (a régit NEM törli), és átírja a `fajl.file_path`-t. Visszatérés: a régi fizikai fájl útvonala (amit a hívó a COMMIT UTÁN töröl `fizikai_torol`-ral), vagy None, ha már közös volt; második elem: az újonnan létrehozott másolat útvonala (hibánál a hívó ezt törli). Hiányzó forrásfájlnál FileNotFoundError.)NNrT)exist_okr_Nxbrbu=Nem sikerült egyedi fájlnevet képezni a közös mappában.)rrlstripospathisfileFileNotFoundErrorr makedirsbasenamesplitextrangeuuiduuid4hexopenshutil copyfileobjFileExistsError RuntimeError) fajlrforrasmappanevtorzs kiterjeszteskiserletjelolthelycelbes r kozosbe_masolrK6sXt~~z22nn" * *3 /F //''  #EKK% ''  6 "C''**3/E!H A eWAdjjl6F6Fr6J5KL>+Z&" dD!S$vt*<""2++=!t| V WW +=*<!!   sH F* F 7E:F F: F F  F FF F*)F*cU(a'[R"URS55 gg![a gf=f)uqFizikai fájl törlése, hiba esetén csendben (a hívó már commitolt; egy árva fájl nem okoz adatvesztést).rN)r0remover/OSError)rHs r fizikai_torolrOPs8   IIdkk#& '    s %0 ==cdU(d [5$UR[RR5R [RR R[U555R5Vs1sHun[U5(dMUiM sn$s snf)uA megadott gépek File-sorainak közös mappába mutató útvonalai (törlés előtt gyűjtendő, törlés után `arva_kozos_torlese`-nek adandó).) setr r!r"rr# machine_idin_listallr)r%gep_idkus r kozos_utvonalakrXYs~ u hhv{{445<rcs" H5C5C5 *S*S* D3D$DT3T3T XCX4C  r