3j. >SrSSKrSSKrSSKrSSKrSSKJrJrJr SSKJ r J r J r SSK J r Jr SSKJr SSKrSSKJr SrS rS r\R."S \-S -\"\5-S -5rSrSrS\4SjrS\ \4SjrS\S\4SjrS\S\4SjrS\S\ S\ S\4Sjr!S\S\ S\ \RD4Sjr#S\S\ S\ S\$4Sjr%S\S\ S\$4Sjr&S\S\ S\ S\ \$\ \\ S 44S!jr'S\S"\ S#\ S\$4S$jr(S\S\ S\ \)4S%jr*S\S\ S\ S 4S&jr+S\S\ S'\ S\ S\$4 S(jr,g))u Partner-cégek kódos összekapcsolása (2026-10-06). MI EZ? A bérbeadás/kihelyezés bérlő-választója korábban AZ ÖSSZES rendszerben lévő aktív céget név szerint felsorolta - ez önmagában adatszivárgás volt (egy cég megtudhatta, kik mások használják a rendszert), nem csak UX-probléma. A user kérése szerint ehelyett két cég csak akkor kapcsolódhat össze, ha mindketten, A RENDSZEREN KÍVÜL (telefon, e-mail, személyesen) megosztanak egymással egy meghívókódot. HOGYAN MŰKÖDIK? 1. Cég A egy Admin/Emelőgép ügyintéző jogú felhasználója meghívókódot generál (`kod_general`) - ez EGYSZER jelenik meg a képernyőn, a cégnek magának kell átadnia Cég B-nek, a rendszer sosem küldi el automatikusan. 2. Cég B egy Admin/Emelőgép ügyintéző jogú felhasználója beírja a kódot (`kod_beiranyitasa`) - ha érvényes (nem lejárt, nem használt, nem a saját cége kódja), azonnal létrejön egy Aktív CegPartnerseg mindkét cég között. 3. Innentől Cég A és Cég B egymást látják a bérbeadás/kihelyezés bérlő-választójában (routers/machines.py, berlo_cegek_valaszthato) - de senki mást. A konkrét gép-kihelyezést a bérlőnek továbbra is EGYEDILEG kell jóváhagynia (BerletiIdoszak.jovahagyva) - a partnerség csak a választási kört szűkíti. FORMÁTUM 10 karakter, 32 betűs ábécéből (nincs összetéveszthető I, O, 0, 1 - ugyanaz az ábécé, mint a 2FA mentőkódoknál), kijelzéskor "ABCDE-FGHJK". Beíráskor a kis/nagybetű, a szóköz és a kötőjel nem számít. TÁROLÁS (biztonság) Az adatbázisban SOHA nincs nyers kód: csak HMAC-SHA256 lenyomat (kulcs: SECRET_KEY) - egy adatbázis-kiszivárgás önmagában nem ad használható kódot. A kód 72 óráig érvényes és csak EGYSZER használható fel (atomi: `UPDATE ... WHERE felhasznalva_at IS NULL`). TALÁLGATÁS ELLEN A beváltás (redeem) már bejelentkezett Admin/EÜI usert igényel (nem anonim), a kód 50 bites (32^10), ÉS a `tul_sok_sikertelen_probalkozas_e` egy óránkénti, felhasználónkénti korlátot ad (AuditLog-alapú, nem folyamat-memóriában él, így workerek között konzisztens - l. docs/LOGIN_VEDELEM.md hasonló indoklását a memória-alapú számlálók hibájáról). Egyik függvény sem commitol (a hívó commitol, a naplóbejegyzéssel egy tranzakcióban).N)datetime timedeltatimezone)ListOptionalTuple)selectupdate)Session) SECRET_KEY H ABCDEFGHJKLMNPQRSTUVWXYZ23456789[z]{}<returncd[R"[R5R SS9$)N)tzinfo)rnowrutcreplace%/var/www/website/partner_ceg_utils.py_mostr=s# << % - -T - ::rc[U[5(dg[R"SSU5R 5n[ R U5(aU$S$)uA beírt kód normalizált alakja (nagybetű, szóköz és kötőjel nélkül), vagy None, ha nem lehet érvényes kód (rossz hossz / nem megengedett karakter) - ilyenkor DB-lekérdezés sem kell.Nz[\s\-_]) isinstancestrresubupper_MINTA fullmatch)kodtisztas r normalizalr)AsJ c3   VVJC ( . . 0F%%f--6747r normalizaltc:US[S-S-U[S-S-$)uKijelzésre: "ABCDE-FGHJK".N-) KOD_HOSSZr*s rformazr0Js(  Q '# - INO0L LLrc[R"[R"S5SU3RS5[R 5R 5$)uA kód HMAC-SHA256 lenyomata (hex, kulcs: SECRET_KEY) - globálisan kereshető (a beváltó nem tudja előre, melyik cég kódját váltja be, ezért a lenyomat nem köthető cég-azonosítóhoz).zutf-8z partner_kod:)hmacnewr encodehashlibsha256 hexdigestr/s r _lenyomatr8OsE 88J%%g.,{m0L0S0ST[0\^e^l^l m w w yyrdbceg_iduser_idc SRS[[555n[5nUR [ R "U[U5UUU[[S9-S95 [U5$)uÚj meghívókódot készít a megadott céghez. Visszaadja a NYERS kódot kijelzésre alkalmas alakban - EZ AZ EGYETLEN ALKALOM, amikor a nyers kód létezik. Nem commitol. Egy cégnek egyszerre több, még fel nem használt kódja is lehet (párhuzamosan több partnert is hívhat).rc3V# UHn[R"[5v M! g7f)N)secretschoiceABECE).0_s r kod_general..YsD3CaGNN5))3Cs'))hours)r:kod_hashletrehozo_user_id letrehozva_atlejar_at) joinranger.raddmodels CegMeghivoKodr8rKOD_ERVENYESSEG_ORAr0)r9r:r;nyersmosts r kod_generalrRUsh GGD53CD DE 7DFF6  5!! (;<<   %=rcUR[R5R[RRU:H[RR R S5[RR[5:5R[RRR55R5$)uA cég még fel nem használt, le nem járt meghívókódjai (a nyers kód ezekben SOHA nincs benne - csak a metaadatok, pl. mikor jár le, ki generálta). GET-kezelő is hívja - szándékosan a régi stílusú ORM-lekérdezéssel (nem az újabb, "select(...)"-es szintaxissal), mert az utóbbit a tests/t_get_audit.py "GET nem ír" statikus elemzése névalapú, nem szemantikai jellel szűri, és tisztán olvasó lekérdezésnél is álpozitívat adna.N) queryrMrNfilterr:felhasznalva_atis_rIrorder_byrHdescall)r9r:s rsajat_aktiv_kodokr[es 88F(( ) 0 0##v-,,006%%/ hv##116689##% @rkod_idc UR[[R5R [RR U:H[RR U:H[RRRS55R[5S9RSS95nURS:H$)uEgy saját, még fel nem használt kód érvénytelenítése (a lejárati idő "mára" állításával - nem töröljük, hogy a történetben nyoma maradjon). Nem commitol.N)rIFsynchronize_session) executer rMrNwhereidr:rVrWvaluesrexecution_optionsrowcount)r9r:r\eredmenys rkod_visszavonasarhrszzv##$   # #v -  ' '6 1  0 0 4 4T :  !  u  5 H    !!rc[5[[S9- nUR[ [ R R5R[ R RU:H[ R RS:H[ R RU:5R[55R5R5n[!U5[:$)uIgaz, ha a felhasználó az utóbbi órában túl sok sikertelen kód-beváltást próbált - a folyamat-memóriában élő számlálók (l. docs/LOGIN_VEDELEM.md) helyett AuditLog-alapú, így workerek között (gunicorn, több folyamat) is konzisztens.)minutesu"Partner-kód beváltás sikertelen)rr!SIKERTELEN_PROBALKOZAS_ABLAK_PERCrar rMAuditLogrcrbr; field_name timestamplimitSIKERTELEN_PROBALKOZAS_KORLATscalarsrZlen)r9r;hatardarabs r tul_sok_sikertelen_probalkozas_erus Gi(IJ JE JJv!!"  OO # #w . OO & &*N N OO % % . , - gi  u:6 66rbeiranyito_ceg_idbeiranyito_user_idzmodels.Companyc "[U5nUcgUR[[R5R [RR [U5:H[RRRS5[RR[5:55R5nUcgURU:Xag[5nUR[[R5R [RRUR:H[RRRS55R!XbUS9R#SS95nUR$S:wag[R&"URUS UUR(US 9nUR+U5 UR-5 UR/[R0UR5n S SU 4$) uA beírt kód beváltása - ha érvényes, ATOMIAN felhasználtnak jelöli és létrehozza az Aktív CegPartnerseg-et. Visszaad egy (siker, hibaüzenet, partner_ceg) hármast. Nem commitol - a hívónak siker/hiba után is azonnal commitolnia kell (a hiba-naplózás miatt is).N)FuÉrvénytelen formátumú kód!N)Fu8A kód érvénytelen, lejárt vagy már felhasználták!N)FuREz a kód a saját cégedhez tartozik, nem lehet önmagaddal partnerséget kötni!N)rVfelhasznalo_ceg_idfelhasznalo_user_idFr^r`Aktív)ceg_a_idceg_b_idallapotrHrGelfogado_user_idT)r)rar rMrNrbrFr8rVrWrIrscalar_one_or_noner:r rcrdrerf CegPartnersegrGrLflushgetCompany) r9r'rvrwr*sorrQrg partnerseg generalo_cegs rkod_beiranyitasarsS/K= **v##$   ) )Y{-C C  0 0 4 4T :  ) )EG 3   {V zz&&p 7Dzzv##$ v##&&#&&0&2F2F2V2V2Z2Z[_2` a `r s  u  5 H AV%%"//+ JFF:HHJ66&..#**5L | ##rceg_id_1ceg_id_2c UR[[RR5R [RR S:H[RRU:H[RRU:H-[RRU:H[RRU:H--55R5SL$)uLIgaz, ha a két cég között van Aktív partnerség (bármelyik irányban).r{N) rar rMrrcrbr~r|r}scalar)r9rrs r partnerek_ers ::v##&&'--  ( (H 4&&//8;@T@T@]@]ai@ij((11X=&BVBVB_B_ckBkln   fhd rcHUR[R5R[RRS:H[RR U:H[RR U:H-5R[RRR55R5n/nUHSnUR U:Xa URO URnURURXTRS.5 MU U$)uA cég összes Aktív partnersége, a MÁSIK fél cég-objektumával és a partnerség-sor id-jével (a "Visszavonás" gombhoz) - kijelzésre kész lista. GET-kezelő is hívja - l. a sajat_aktiv_kodok megjegyzését a régi stílusú ORM-lekérdezés indokáról.r{) partnerseg_idcegrH)rTrMrrUr~r|r}rXrHrYrZceg_bceg_aappendrc)r9r:sorokrgr masik_cegs rpartnersegek_listajars HHV)) * 1 1$$0    & && 0V5I5I5R5RV\5\] hv##116689##% H!$!7CIISYY #&&UfUfgh Orc`[X5Vs/sHo"S(dMUSPM sn$s snf)u]A cég aktív partner-cégei, Company-objektumként (a kihelyezés bérlő-választójához).r)r)r9r:ps rpartner_cegek_listajars+22> K>E(HAeH> KK Ks + +rc UR[[R5R [RR U:H[RR S:H[RRU:H[RRU:H-5RS[5US9RSS95nURS:H$)uA partnerség visszavonása - bármelyik fél megteheti. Nem törli az esetleg már futó aktív BerletiIdoszak-ot (az a külön "Bérlet lezárása" út), csak új kihelyezést blokkol a jövőben. Nem commitol.r{ Visszavonva)r~visszavonva_atvisszavono_user_idFr^r`) rar rMrrbrcr~r|r}rdrrerf)r9r:rr;rgs rpartnerseg_visszavonasarszzv##$   # #} 4  ( (H 4  ! ! * *f 49M9M9V9VZ`9` a  egRY Z  u  5 H    !!r)-__doc__r5r2r"r>rrrtypingrrr sqlalchemyr r sqlalchemy.ormr rMconfigr r.rOr@compiler!r%rprkrr)r0r8intrRrNr[boolrhrurrdictrrrrrrrs%`L 22((%"   * D5L5(3y>9D@ A "$&!;x;8x}8MMM z3z3z G S 3 3  @' @3 @48L8L3M @ " "# "s "t " 773747"-$-$#-$SV-$[`aegopsgtv~@PwQbQ\R-$` G s c d  W c d4j  LgLsLt