coopOS to jeden system informatyczny dla spółdzielni: zamiast kilku osobnych programów i papierów jest jedno logowanie, jedna baza danych i jeden zestaw zasad mówiących, kto co może zobaczyć. Ta strona opisuje, co już działa, co może powstać dalej i jak do tej pory wyglądała praca. Jeśli chcesz najpierw samemu poklikać, zacznij od przewodnika po systemie.
Jeden system dla czterech grup
- Mieszkańcy i członkowie: portal po zalogowaniu, „Moje mieszkanie", dokumenty członkowskie, zgłaszanie awarii, terminarz, ankiety, liczniki, rezerwacje.
- Pracownicy działów: rejestr członków i lokali, osobny widok dla każdego działu, publikowanie aktualności.
- Zarząd i Rada Nadzorcza: posiedzenia, uchwały, protokoły i zadania; dostęp tylko do odczytu tam, gdzie tak być powinno.
- Operatorzy IT: osobna konsola do ról, uprawnień, treści strony i ustawień.
Każdy widzi tylko to, co jest mu potrzebne i do czego ma uprawnienia. Pilnuje tego serwer, a nie sam wygląd strony. Szczegóły, kto co widzi, są w opisie kont testowych.
Co już działa
Strona publiczna spółdzielni
Aktualności, komunikaty, dokumenty (statut, regulaminy, przepisy prawa, wzory), wyszukiwarka odporna na literówki, poradnik mieszkańca, mapy osiedli, galerie zdjęć i formularze z załącznikami. Menu, stopkę i strony można zmieniać z panelu, bez programisty. Dokumenty trafiają na stronę automatycznie z repozytorium treści spółdzielni.
Portal mieszkańca i pracowników
Logowanie z odzyskiwaniem hasła, „Moje mieszkanie" powiązane z rejestrem, dokumenty członkowskie, rejestr członków i lokali z importem z pliku CSV. Dane osobowe i PESEL mają osobne uprawnienia, a każde ich otwarcie jest zapisywane w dzienniku.
Zgłoszenia awarii
Mieszkaniec zgłasza awarię w portalu (ze zdjęciem) albo przez formularz na stronie, dostaje numer i widzi status. Dział techniczny ma kolejkę z priorytetami i przypisaniem do pracowników. Pracownik osiedla widzi tylko zgłoszenia swojego osiedla, a notatki wewnętrzne nigdy nie trafiają do mieszkańca.
Posiedzenia i uchwały
Zarząd, Rada Nadzorcza i Walne Zgromadzenie, zbudowane na przepisach regulaminów spółdzielni: terminy zawiadomień (21 dni dla Walnego, 7 dni dla Rady), kworum, powtarzanie głosowania przy remisie, wyłączenia, głosowanie tajne, numeracja uchwał i rejestr. Protokół z szkicem, e-mail do członków przy zwołaniu Walnego, zadania wynikające z uchwał i widok kalendarza. Członkowie widzą zwołane Walne, porządek obrad, projekty uchwał i zatwierdzone protokoły.
Dział techniczny
Karty techniczne budynków, harmonogram przeglądów (termin następnego liczy się sam, a w poniedziałek rano idzie e-mail z przeglądami po terminie), instalacje (windy, gaz), remonty z etapami i budżetem oraz rejestr wykonawców.
Życie osiedla (najnowsze moduły)
- Wiadomości celowane: aktualność wysyłana mailem tylko do mieszkańców jednego budynku, klatki, osiedla albo wszystkich, z policzeniem odbiorców przed wysłaniem.
- Terminarz z kalendarzem do telefonu i przypomnieniami e-mail.
- Ankiety: szybkie pytania do mieszkańców (to sondaż, a nie głosowanie statutowe).
- Odczyty liczników podawane przez mieszkańców: sprawdzane, oznaczane, eksportowane do pliku.
- Rezerwacje sal, placów zabaw, miejsc parkingowych i lokali gościnnych, z akceptacją przez pracownika.
Bezpieczeństwo i dane osobowe
- Osobne konta operatorów z logowaniem dwuskładnikowym (kod z telefonu) i kodami awaryjnymi.
- Dziennik dostępu do danych osobowych i zmian ról.
- Uprawnienia przypisane do roli i zakresu (np. osiedla), z wykluczeniami ról (np. nikt nie jest naraz w Zarządzie i w Radzie).
- Hasła są przechowywane tylko jako nieodwracalny skrót (nikt, także administrator, nie odczyta ich w bazie), reset odbywa się jednorazowym linkiem, a liczba prób logowania jest ograniczona.
- Codzienna kopia zapasowa z cotygodniowym sprawdzianem odtworzenia, monitoring co 5 minut i alarm na zewnątrz.
- Strona działa przez szyfrowane połączenie (HTTPS).
Do zrobienia w tym obszarze: szyfrowanie numerów PESEL w bazie, zasady przechowywania danych i eksport wszystkich danych o osobie (RODO) oraz kopia poza serwerem (wymaga wykupienia magazynu).
System na telefonach
Cały system działa w przeglądarce telefonu, bez instalowania czegokolwiek: strony i panele dopasowują się do wielkości ekranu. Menu panelu chowa się pod przyciskiem z trzema kreskami w lewym górnym rogu.
Zobacz sam: zeskanuj kod aparatem telefonu (albo wpisz smdm.piotrsocha.dev) i zaloguj się jednym z kont demonstracyjnych. Lista kont i opis tego, co każde z nich pokazuje, jest w Kontach testowych, a hasło poda osoba prowadząca prezentację.
Przykładowe widoki z telefonu (od lewej: strona główna z komunikatem, zgłoszenie awarii z historią, harmonogram przeglądów, rezerwacje):
Co może być dalej
Poniżej makiety, czyli projekty graficzne celu, a nie działające funkcje. Pokazują kierunek, w którym system może się rozwijać. Co z tego powstanie i w jakiej kolejności, powinna zdecydować spółdzielnia.
Finanse i opłaty mieszkańca
Saldo, naliczenia, wpłaty i dokumenty z systemu księgowego w jednym widoku, a w portalu „Opłaty i rozliczenia". Wymaga dostępu do systemów, w których spółdzielnia już pracuje (Papyrus, eMieszkaniec) i ustaleń z ich dostawcami.
Wnioski online
Mieszkaniec składa wniosek (np. o zaświadczenie), a pracownik prowadzi go przez etapy, od przyjęcia do decyzji, z załącznikami i terminami.
Powiadomienia SMS i w aplikacji
Dziś system wysyła e-maile. Makieta pokazuje szersze powiadomienia (SMS, powiadomienia w aplikacji) z wyborem kanałów przez mieszkańca.
Księga zdarzeń budynku
Pełna historia budynku w jednym miejscu: awarie, przeglądy, remonty, modernizacje, dokumentacja i powiązane zgłoszenia.
Pulpity dla poszczególnych ról
Pulpit członka, działu technicznego, Zarządu, finansów i Rady Nadzorczej, z kluczowymi wskaźnikami na jednej stronie. Część widoków już działa (techniczny, posiedzenia, zgłoszenia), reszta pokazuje na razie przykładowe liczby.
Aplikacja mobilna
Dziś telefon korzysta ze strony w przeglądarce. Makieta pokazuje, jak mogłaby wyglądać osobna aplikacja: logowanie (także odciskiem palca), ekran główny, finanse i płatności, zgłaszanie usterek ze zdjęciami, rezerwacje, mapa, ogłoszenia i dokumenty. To pomysł, a nie decyzja: wiele z tych ekranów (zgłoszenia, rezerwacje, dokumenty) działa już w przeglądarce telefonu.
Monitoring wizyjny
Pomysł na wspólny panel kamer z uprawnieniami i zapisem, kto oglądał nagrania. To pozycja wymagająca osobnej decyzji spółdzielni ze względu na ochronę danych osobowych.
Inne kierunki
Zaproszenia mieszkańców do portalu, raporty zgłoszeń (statystyki awarii i czasów realizacji), osoby prawne jako posiadacze tytułu, przekazanie tytułu jednym krokiem, dalsze moduły z makiet. Moduł finansowy z programem wFirma jest wstrzymany do decyzji spółdzielni.
Jak do tej pory wyglądała praca
Kto za co odpowiada
System powstaje przy użyciu asystenta AI do programowania (Claude Code). Autor odpowiada za wymagania, architekturę, decyzje i przegląd. Asystent pisze kod, testy i dokumentację według jego wytycznych, niczego nie rozstrzyga sam. Tempo dotyczy kodu: integracje z zewnętrznymi systemami zależą od dostępów i ustaleń z dostawcami, więc nie da się ich przyspieszyć w ten sam sposób.
Jakość pilnują m.in. testy automatyczne uruchamiane przy każdej zmianie, dziennik dostępu do danych osobowych, architektura i zasady opisane w repozytorium oraz prywatne repozytorium z historią każdej zmiany.
Dzień po dniu
- Dzień 1: szkielet systemu (Symfony, Nuxt, PostgreSQL), logowanie i konta, konsola operatora i dziennik audytu.
- Dzień 2: uprawnienia i role, portal dla każdej grupy, aktualności i osiedla.
- Dzień 3 (weekend): edytor treści, dokumenty i pliki, wyszukiwarka i baza wiedzy, rejestr członków i lokali, dokumenty członkowskie, ustawienia systemu.
- Dzień 4 (weekend): mapy osiedli, galerie, formularze i poczta, struktura organów spółdzielni.
- Dzień 5: zgłoszenia awarii, zmiana i odzyskiwanie hasła, obrazy produkcyjne, automatyczne wdrażanie, instrukcja wdrożenia i pierwsze uruchomienie na serwerze.
- Dzień 6: posiedzenia i uchwały, dział techniczny, logowanie dwuskładnikowe, kopie zapasowe, monitoring.
- Dzień 7: życie osiedla: wiadomości celowane, terminarz z kalendarzem do telefonu, ankiety, liczniki, rezerwacje.
- Dzień 9: nowa nazwa i adres systemu, lokalny HTTPS do pracy, przewodnik dla Rady (ta strona i jej siostrzane).
W liczbach
| Czas od pustego repozytorium do działającego systemu na serwerze | 5 dni |
| Dni z pracą nad kodem do dziś | 8 |
| Kod serwera | ok. 42 tys. linii |
| Kod strony i portalu | ok. 15 tys. linii |
| Testy automatyczne | 451 testów (ok. 12 tys. linii) |
| Migracje bazy danych | 47 |
| Zapisane zmiany w historii | 75 |
Ile to zajęłoby samodzielnemu seniorowi
To szacunek, a nie pomiar, i trzeba go czytać ostrożnie. Policzono, ile godzin potrzebowałby doświadczony programista (senior), pracując sam od zera nad takim samym zakresem, z projektem, kodem, testami, dokumentacją i wdrożeniem:
| Zakres | Szacunek (godziny) |
|---|---|
| Fundament: szkielet, logowanie, konta, konsola operatora, audyt | 100–140 |
| Uprawnienia, role i widoki dla ról | 80–120 |
| Strona publiczna: edytor treści, aktualności, osiedla, mapy, galerie | 200–280 |
| Dokumenty, pliki, wyszukiwarka, baza wiedzy z automatycznym importem | 180–250 |
| Rejestr członków i lokali, dokumenty członkowskie, ochrona danych | 120–170 |
| Formularze, poczta, hasła, logowanie dwuskładnikowe, limity prób | 100–140 |
| Organy spółdzielni, posiedzenia i uchwały według regulaminów | 130–180 |
| Dział techniczny i zgłoszenia awarii | 130–190 |
| Życie osiedla: wiadomości celowane, terminarz, ankiety, liczniki, rezerwacje | 120–180 |
| Wdrożenie: obrazy, automatyczne wdrażanie, kopie, monitoring, dokumentacja | 100–150 |
| Razem | ok. 1260–1800 |
Dla porównania praca autora przy tym samym zakresie to ok. 9 dni kalendarzowych, co przy założeniu 50–100 godzin jego własnej pracy (decyzje, przegląd, sprawdzanie na telefonach) daje przyspieszenie rzędu od ok. 13 do ok. 36 razy, realnie około 20 razy w liczbie przepracowanych godzin. W czasie kalendarzowym różnica jest większa: senior pracujący sam na pełnym etacie (ok. 150 godzin produktywnych miesięcznie) potrzebowałby na to ok. 8–12 miesięcy.
Czego ten szacunek nie mówi:
- Wszystkie liczby, także czas autora, to założenia i rząd wielkości. Nikt nie mierzył godzin na bieżąco, a sam szacunek przygotował asystent AI.
- Przyspieszenie dotyczy pisania kodu. Rozmowy z dostawcami, uzyskanie dostępów, decyzje spółdzielni i wdrożenie u prawdziwych użytkowników trwają tyle samo, co zawsze.
- Kod pisany z asystentem wymaga przeglądu, a dopiero praca z prawdziwymi użytkownikami pokaże, co trzeba poprawić. Testy automatyczne zmniejszają to ryzyko, ale go nie usuwają.
- System jest na etapie pokazowym, a nie wieloletniego, sprawdzonego w boju produktu.