Техническая документация

Документация разработчика

public — веб-корень; src содержит код, а storage — закрытую базу SQLite.

Документация разработчика

Продукт и обязательные решения

That's My Dash 0.8.1 — Ð¿ÐµÑ€ÑÐ¾Ð½Ð°Ð»ÑŒÐ½Ð°Ñ Ð²ÐµÐ±-ÑÑ‚Ñ€Ð°Ð½Ð¸Ñ†Ð° Ð´Ð»Ñ Ð½ÐµÑÐºÐ¾Ð»ÑŒÐºÐ¸Ñ Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»ÐµÐ¹. Ð¢Ñ€ÐµÐ±ÑƒÑŽÑ‚ÑÑ PHP 8.2+, SQLite Ð¸ HTTPS. MySQL, ÐºÐ¾Ð¼Ð°Ð½Ð´Ð½Ð°Ñ ÑÑ‚Ñ€Ð¾ÐºÐ° Ð¸ Ñ€ÑƒÑ‡Ð½Ð¾Ð¹ Ð¸Ð¼Ð¿Ð¾Ñ€Ñ‚ Ð±Ð°Ð·Ñ‹ Ð½Ðµ Ð´Ð¾Ð»Ð¶Ð½Ñ‹ ÑÑ‚Ð°Ð½Ð¾Ð²Ð¸Ñ‚ÑŒÑÑ Ñ‚Ñ€ÐµÐ±Ð¾Ð²Ð°Ð½Ð¸ÑÐ¼Ð¸. Ð¡ÑƒÑ‰ÐµÑÑ‚Ð²ÑƒÑŽÑ‰Ð¸Ðµ Ð±Ð°Ð·Ñ‹ Ñ€Ð°ÑÑˆÐ¸Ñ€ÑÑŽÑ‚ÑÑ Ð´Ð¾Ð±Ð°Ð²Ð¾Ñ‡Ð½Ð¾; config.php Ð¸ Ð²ÐµÑÑŒ ÐºÐ°Ñ‚Ð°Ð»Ð¾Ð³ storage ÑÐ¾Ñ Ñ€Ð°Ð½ÑÑŽÑ‚ÑÑ.

Ð˜Ð½Ñ‚ÐµÑ€Ñ„ÐµÐ¹Ñ Ð¿Ð¾Ð´Ð´ÐµÑ€Ð¶Ð¸Ð²Ð°ÐµÑ‚ Ð²Ð¾ÑÐµÐ¼ÑŒ ÑÐ·Ñ‹ÐºÐ¾Ð², Ð°Ð½Ð³Ð»Ð¸Ð¹ÑÐºÐ¸Ð¹ ÑÐ²Ð»ÑÐµÑ‚ÑÑ Ñ‚ÐµÑ Ð½Ð¸Ñ‡ÐµÑÐºÐ¸Ð¼ Ñ€ÐµÐ·ÐµÑ€Ð²Ð½Ñ‹Ð¼ ÑÐ·Ñ‹ÐºÐ¾Ð¼.

ÐÑ€Ñ

итектура

public — предполагаемый веб-корень.
src содержит обработку запросов, базу, безопасность и HTTP-вызовы.
views содержит шаблоны и не изменяет данные.
storage содержит SQLite, кэш и локальные языковые файлы и остается закрытым.
public/index.php выполняет действия, загружает контекст и представление.

ÐŸÑ€Ð°Ð²Ð¸Ð»Ð° ÐºÐ¾Ð´Ð° Ð¸ Ð´Ð°Ð½Ð½Ñ‹Ñ

Используйте строгие типы и подготовленные запросы PDO.
ÐŸÑ€Ð¸ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¸ Ð»Ð¸Ñ‡Ð½Ñ‹Ñ

Ð´Ð°Ð½Ð½Ñ‹Ñ ÑƒÑ‡Ð¸Ñ‚Ñ‹Ð²Ð°Ð¹Ñ‚Ðµ id Ñ‚ÐµÐºÑƒÑ‰ÐµÐ³Ð¾ Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ.

Экранируйте вывод и не разрешайте пользовательский HTML.
Все записи используют POST, CSRF, проверку и контроль владельца.
Миграции добавочные, идемпотентные и обратно совместимые.
Основное редактирование работает без JavaScript.

Безопасность, доступность и языки

Ð’Ð½ÐµÑˆÐ½Ð¸Ðµ Ð·Ð°Ð¿Ñ€Ð¾ÑÑ‹ Ð¸ÑÐ¿Ð¾Ð»ÑŒÐ·ÑƒÑŽÑ‚ Ñ‚Ð¾Ð»ÑŒÐºÐ¾ HTTPS, Ð±Ð»Ð¾ÐºÐ¸Ñ€ÑƒÑŽÑ‚ Ñ‡Ð°ÑÑ‚Ð½Ñ‹Ðµ ÑÐµÑ‚Ð¸ Ð¸ Ð¾Ð³Ñ€Ð°Ð½Ð¸Ñ‡Ð¸Ð²Ð°ÑŽÑ‚ Ð¿ÐµÑ€ÐµÐ½Ð°Ð¿Ñ€Ð°Ð²Ð»ÐµÐ½Ð¸Ñ, Ð²Ñ€ÐµÐ¼Ñ Ð¸ Ñ€Ð°Ð·Ð¼ÐµÑ€. Google ÐšÐ°Ð»ÐµÐ½Ð´Ð°Ñ€ÑŒ Ð½ÐµÐ¾Ð±ÑÐ·Ð°Ñ‚ÐµÐ»ÐµÐ½. Ð¦ÐµÐ»ÑŒ — WCAG 2.2 AA: ÑÐµÐ¼Ð°Ð½Ñ‚Ð¸Ñ‡ÐµÑÐºÐ¸Ð¹ HTML, ÐºÐ»Ð°Ð²Ð¸Ð°Ñ‚ÑƒÑ€Ð°, Ð²Ð¸Ð´Ð¸Ð¼Ñ‹Ð¹ Ñ„Ð¾ÐºÑƒÑ, Ð¼Ð°ÑÑˆÑ‚Ð°Ð±Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ðµ, ÑƒÐ¼ÐµÐ½ÑŒÑˆÐµÐ½Ð¸Ðµ Ð´Ð²Ð¸Ð¶ÐµÐ½Ð¸Ñ Ð¸ Ð²Ñ‹ÑÐ¾ÐºÐ¸Ð¹ ÐºÐ¾Ð½Ñ‚Ñ€Ð°ÑÑ‚. Ð¯Ð·Ñ‹ÐºÐ¸ Ð½Ð°Ñ Ð¾Ð´ÑÑ‚ÑÑ Ð² languages, Ð»Ð¾ÐºÐ°Ð»ÑŒÐ½Ñ‹Ðµ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ — Ð² storage/languages. :place Ð¸ {query} Ð½Ðµ Ð¿ÐµÑ€ÐµÐ²Ð¾Ð´ÑÑ‚ÑÑ.

Контроль выпуска

Запускайте проверки PHP, JavaScript, JSON и языков. Тестируйте чистую установку и обновление, телефон и компьютер, светлую и темную темы, роли, разделение пользователей, клавиатуру, экранный диктор и масштаб. Обновляйте VERSION, README, CHANGELOG, PROJECT_STATUS и аудит.