# CẤU TRÚC THƯ MỤC CHUẨN (PROJECT DIRECTORY TREE)
# Thiết kế chuẩn cho Shared Hosting (Tách biệt mã nguồn ngoài web root)

```
/home/{user}/                           # Thư mục gốc tài khoản hosting (trên cPanel/DirectAdmin)
│
├── app/                                # [NGOÀI WEB ROOT] Toàn bộ mã nguồn & logic bảo mật
│   ├── bin/                            # Các script dòng lệnh (CLI), cron jobs
│   │   ├── cron_integrity_check.php    # Quét toàn vẹn SHA-256 mã nguồn định kỳ
│   │   ├── cron_update_cf_ips.php      # Cập nhật danh sách IP Cloudflare & .htaccess
│   │   ├── cron_scheduled_publish.php  # Đăng bài viết theo lịch hẹn
│   │   ├── cron_backup.php             # Tự động xuất CSDL, nén & mã hóa bản sao lưu
│   │   └── installer.php               # Trình cài đặt 1 lần (tự khóa & xóa sau khi dùng)
│   │
│   ├── config/                         # Cấu hình hệ thống (CHỈ chứa cấu hình tĩnh/mẫu)
│   │   ├── app.php                     # Tên site, debug mode, timezone, admin path
│   │   ├── database.php                # Cấu hình kết nối PDO MariaDB/MySQL
│   │   ├── security.php                # CSP, HSTS, Rate limit rules, Turnstile, Alerting
│   │   └── social.php                  # Danh sách & thứ tự nút mạng xã hội mặc định
│   │
│   ├── migrations/                     # Quản lý phiên bản cấu trúc CSDL
│   │   ├── 001_create_core_tables.sql  # Users, passkeys, sessions, rate_limits, audit_log
│   │   ├── 002_create_content_tables.sql # Posts, categories, tags, series, media
│   │   └── 003_create_redirects_settings.sql # Redirects, system_settings, login_attempts
│   │
│   ├── src/                            # Mã nguồn ứng dụng (PSR-4 Namespace: App\)
│   │   ├── Core/                       # Thành phần hạt nhân
│   │   │   ├── Application.php         # Khởi động ứng dụng, xử lý lifecycle
│   │   │   ├── Router.php              # Bộ định tuyến nhẹ, an toàn (Strict Route Matching)
│   │   │   ├── Request.php             # Đóng gói HTTP request, xác thực IP từ Cloudflare
│   │   │   ├── Response.php            # Đóng gói HTTP response, tự động gắn Security Headers
│   │   │   ├── Database.php            # Singleton PDO Connection (Prepared Statements only)
│   │   │   ├── SecurityHeaders.php     # Quản lý CSP, HSTS, Permissions-Policy, Fetch Metadata
│   │   │   ├── CsrfGuard.php           # Sinh & kiểm tra CSRF token theo phiên
│   │   │   ├── RateLimiter.php         # Token Bucket rate limiter (File/DB fallback)
│   │   │   ├── SessionManager.php      # Quản lý phiên trong DB (__Host- cookie, Strict)
│   │   │   ├── AuditLogger.php         # Ghi log có cấu trúc JSON, băm IP người dùng
│   │   │   ├── Notifier.php            # Gửi cảnh báo khẩn qua Telegram Bot & SMTP
│   │   │   └── ExceptionHandler.php    # Bắt lỗi toàn cục, fail-closed, log mã đối soát
│   │   │
│   │   ├── Controllers/                # Tầng điều khiển
│   │   │   ├── Admin/                  # Khu vực quản trị (Động, bảo vệ nghiêm ngặt)
│   │   │   │   ├── AuthController.php  # Đăng nhập Passkey/Password, TOTP, Logout
│   │   │   │   ├── DashboardController.php # Bảng tổng quan, trạng thái bảo mật
│   │   │   │   ├── PostController.php  # CRUD bài viết, phiên bản, kích hoạt build tĩnh
│   │   │   │   ├── CategoryController.php # Quản lý chuyên mục 2 cấp
│   │   │   │   ├── SeriesController.php   # Quản lý chuỗi bài viết (Series)
│   │   │   │   ├── MediaController.php    # Upload ảnh, re-encode, generate WebP
│   │   │   │   ├── SocialController.php   # Cấu hình nút nổi Facebook, Telegram...
│   │   │   │   ├── SettingController.php  # Đổi mật khẩu, passkey, cấu hình site
│   │   │   │   └── BackupController.php   # Tải bản sao lưu mã hóa, xuất dữ liệu
│   │   │   │
│   │   │   └── Public/                 # Tầng hiển thị công khai (Fallback khi chưa có cache tĩnh)
│   │   │       ├── HomeController.php  # Dựng trang chủ tĩnh
│   │   │       ├── ContentController.php # Dựng bài viết, chuyên mục, thẻ, series
│   │   │       └── SearchController.php  # Phục vụ chỉ mục tìm kiếm JSON tĩnh
│   │   │
│   │   ├── Services/                   # Nghiệp vụ logic độc lập
│   │   │   ├── StaticBuilderService.php # Render toàn bộ HTML tĩnh vào public_html/cache/
│   │   │   ├── MarkdownService.php     # Parse Markdown, format Callouts, sanitize HTML
│   │   │   ├── ImageProcessorService.php # Re-encode GD/Imagick, strip EXIF, build srcset
│   │   │   ├── WebAuthnService.php     # Xử lý xác thực Passkey FIDO2/WebAuthn
│   │   │   ├── CloudflarePurgeService.php # Gọi API Cloudflare xóa cache khi cập nhật bài
│   │   │   └── IntegrityService.php    # So khớp hash SHA-256 mã nguồn phát hiện webshell
│   │   │
│   │   └── Repositories/               # Tầng truy xuất CSDL (Prepared statements tuyệt đối)
│   │       ├── UserRepository.php
│   │       ├── PostRepository.php
│   │       ├── CategoryRepository.php
│   │       ├── MediaRepository.php
│   │       └── AuditRepository.php
│   │
│   ├── templates/                      # Giao diện hiển thị (Tự escape theo ngữ cảnh)
│   │   ├── admin/                      # Giao diện khu quản trị
│   │   │   ├── layout.php
│   │   │   ├── login.php
│   │   │   ├── dashboard.php
│   │   │   ├── post_editor.php         # Trình soạn thảo Markdown + Callout Toolbar
│   │   │   ├── social_links.php        # Cấu hình nút nổi mạng xã hội
│   │   │   └── audit_logs.php
│   │   │
│   │   └── public/                     # Giao diện công khai (Dùng để render ra tĩnh)
│   │       ├── layout.php
│   │       ├── home.php
│   │       ├── post.php                # Đọc bài viết, ô nhấn mạnh, mục lục dính
│   │       ├── category.php
│   │       ├── series.php
│   │       ├── search.php
│   │       ├── error_403.php
│   │       ├── error_404.php
│   │       ├── error_429.php
│   │       ├── error_500.php
│   │       └── partials/               # Thành phần tái sử dụng
│   │           ├── header.php
│   │           ├── footer.php
│   │           ├── social_fab.php      # Nút nổi tròn Facebook + Telegram
│   │           └── callouts.php        # SVG & style ô nhấn mạnh
│   │
│   ├── tests/                          # Bộ kiểm thử bảo mật & logic
│   │   ├── Security/                   # Test XSS, CSRF, Path Traversal, Polyglot Image
│   │   └── Unit/                       # Test Router, Markdown, RateLimit
│   │
│   └── vendor/                         # Thư viện bên thứ ba (Cài từ máy local/CI, có composer.lock)
│
├── storage/                            # [NGOÀI WEB ROOT] Dữ liệu động & log hệ thống
│   ├── app_config.secure.php           # File chứa mật khẩu CSDL, bot token, secret key (Quyền 0600)
│   ├── backups/                        # Thư mục lưu file sao lưu mã hóa (.enc)
│   ├── logs/                           # Log có cấu trúc JSON (security.log, error.log)
│   ├── ratelimit/                      # Bộ đếm token bucket (nếu host không có APCu)
│   └── baselines/                      # File lưu trữ hash chuẩn để đối soát toàn vẹn
│
└── public_html/                        # [DUY NHẤT ĐƯỢC MÁY CHỦ WEB PHỤC VỤ CÔNG KHAI]
    ├── index.php                       # Front controller duy nhất
    ├── .htaccess                       # Quy tắc bảo vệ, chống duyệt thư mục, chặn PHP trong upload
    ├── robots.txt                      # Hướng dẫn bot tìm kiếm
    ├── sitemap.xml                     # Sơ đồ trang web tĩnh
    ├── .well-known/
    │   └── security.txt                # Khai báo bảo mật theo chuẩn RFC 9116
    │
    ├── cache/                          # [CỐT LÕI CHỐNG DDOS] Chứa toàn bộ file HTML tĩnh
    │   ├── .htaccess                   # Cho phép đọc file trực tiếp, tắt PHP execution
    │   ├── index.html                  # Bản tĩnh trang chủ
    │   ├── p/                          # Bản tĩnh từng bài viết
    │   ├── c/                          # Bản tĩnh chuyên mục & mục con
    │   ├── s/                          # Bản tĩnh series
    │   ├── t/                          # Bản tĩnh thẻ
    │   └── search-index.json           # Chỉ mục tìm kiếm tĩnh tải theo nhu cầu
    │
    ├── assets/                         # Tài nguyên tĩnh nội bộ (KHÔNG dùng CDN bên thứ ba)
    │   ├── css/
    │   │   ├── main.css                # CSS công khai (Dưới 30KB, dark mode, callouts, FAB)
    │   │   └── admin.css               # CSS khu quản trị
    │   ├── js/
    │   │   ├── search.js               # Tìm kiếm nội bộ phía client bằng JSON tĩnh
    │   │   ├── theme.js                # Chuyển dark/light mode lưu qua localStorage
    │   │   ├── fab.js                  # Hiệu ứng nút nổi mạng xã hội
    │   │   └── admin_editor.js         # Xử lý phím tắt, live preview, paste upload ảnh
    │   └── fonts/                      # Font WOFF2 tự lưu nội bộ (subset tiếng Việt)
    │
    └── uploads/                        # Thư mục chứa hình ảnh minh họa bài viết
        ├── .htaccess                   # CHẶN THỰC THI PHP TUYỆT ĐỐI, Nosniff, cấm file lạ
        └── images/                     # Ảnh đã re-encode WebP/JPEG theo kích thước
```
