That's My Dash

Dokumentacja techniczna

Dokumentacja programisty

public jest katalogiem WWW; src zawiera kod, a storage prywatną bazę SQLite.

Dokumentacja programisty

Produkt i wiÄ

Å¼Ä ce decyzje

That's My Dash 0.8.1 to osobista internetowa strona startowa dla wielu użytkowników. Wymaga PHP 8.2+, SQLite i HTTPS. MySQL, wiersz poleceÅ„ i rÄ™czny import bazy nie mogÄ stać siÄ™ wymaganiami. IstniejÄ ce bazy sÄ rozszerzane addytywnie; config.php i caÅ‚y katalog storage pozostajÄ zachowane.

Interfejs obsługuje osiem języków, a angielski jest technicznym językiem awaryjnym.

Architektura

  • public jest katalogiem WWW.
  • src zawiera obsÅ‚ugÄ™ żÄ

    • daÅ„, bazÄ™, bezpieczeÅ„stwo i poÅ‚Ä czenia HTTP.

  • views zawiera szablony i nie zmienia danych.
  • storage zawiera SQLite, pamięć podrÄ™cznÄ

    • i lokalne języki i musi być prywatny.

  • public/index.php uruchamia akcje, ładuje kontekst i widok.

Zasady kodu i danych

  • Używaj ścisłych typów i przygotowanych zapytań PDO.
  • Przy zmianie danych prywatnych uwzględniaj id użytkownika.
  • Escapuj treść i nie dopuszczaj HTML użytkownika.
  • Każdy zapis używa POST, CSRF, walidacji i kontroli właściciela.
  • Migracje sÄ

    • addytywne, idempotentne i zgodne wstecz.

  • Podstawowa edycja działa bez JavaScript.

Bezpieczeństwo, dostępność i języki

PoÅ‚Ä czenia zewnÄ™trzne używajÄ tylko HTTPS, blokujÄ sieci prywatne i ograniczajÄ przekierowania, czas i rozmiar. Google Calendar jest opcjonalny. Celem jest WCAG 2.2 AA: semantyczny HTML, klawiatura, widoczny fokus, zoom, ograniczony ruch i wysoki kontrast. JÄ™zyki sÄ w languages, a lokalne zmiany w storage/languages. :place i {query} nie sÄ tÅ‚umaczone.

Kontrola wydania

Uruchom kontrole PHP, JavaScript, JSON i jÄ™zyków. Testuj nowÄ instalacjÄ™ i aktualizacjÄ™, telefon i komputer, jasny i ciemny motyw, role, rozdzielenie użytkowników, klawiaturÄ™, czytnik ekranu i zoom. Zaktualizuj VERSION, README, CHANGELOG, PROJECT_STATUS i audyt.