Phụ lục 9. Mẫu cấu trúc thư mục cho hệ thống AI local bệnh viện

1. Cấu trúc tổng thể đề xuất

/opt/ai/
  apps/
  configs/
  modelfiles/
  scripts/
  docs/

/mnt/ai/
  rag/
  indexes/
  metadata/
  cache/
  tmp/
  logs/

/mnt/data/
  documents/
  uploads/
  datasets/
  archive/

/mnt/backup/
  ai/
  ollama/
  rag/
  configs/
  databases/
  logs/

2. Thư mục ứng dụng

/opt/ai/apps/

Dùng để lưu:

• API trung gian.
• Worker xử lý hàng đợi.
• Dashboard quản trị.
• Công cụ kiểm tra hệ thống.

3. Thư mục cấu hình

/opt/ai/configs/

Dùng để lưu:

• Cấu hình API.
• Prompt template.
• Mapping chatbot với model.
• Cấu hình RAG.
• Cấu hình queue.
• Cấu hình log.

Không lưu mật khẩu/token ở đây nếu không phân quyền chặt.

4. Thư mục Modelfile

/opt/ai/modelfiles/

Ví dụ:

/opt/ai/modelfiles/
  bv-assistant.Modelfile
  bv-qlcl.Modelfile
  bv-khth.Modelfile
  bv-cntt.Modelfile
  bv-phapluat-yte.Modelfile

5. Thư mục RAG

/mnt/ai/rag/
  raw/
  cleaned/
  chunks/
  embeddings/
  faiss/
  metadata/
  versions/

Ý nghĩa:

• raw: tài liệu gốc đưa vào pipeline.
• cleaned: text đã làm sạch.
• chunks: văn bản đã chia chunk.
• embeddings: vector hoặc dữ liệu trung gian.
• faiss: index hiện hành.
• metadata: metadata tài liệu/chunk.
• versions: các phiên bản index cũ để rollback.

6. Thư mục tài liệu

/mnt/data/documents/
  quy-trinh/
  bieu-mau/
  qlcl/
  dieu-duong/
  cntt/
  phap-luat-y-te/
  dao-tao/
  qms/
  restricted/

7. Thư mục upload

/mnt/data/uploads/

Khuyến nghị chia theo ngày:

/mnt/data/uploads/
  2026/
    05/
      17/

Cần có chính sách tự xóa file tạm và kiểm soát dữ liệu nhạy cảm.

8. Thư mục log

/mnt/ai/logs/
  api/
  rag/
  queue/
  audit/
  errors/

Cần cấu hình logrotate.

9. Thư mục backup

/mnt/backup/ai/
  configs/
  modelfiles/
  rag/
  databases/
  scripts/
  ollama-model-list/

Không nhất thiết backup toàn bộ model mỗi ngày. Nên backup Modelfile, cấu hình, metadata, index và danh sách model.