README.txt

HƯỚNG DẪN CHẠY FILE

----------------------------------------
1. CẤU HÌNH .env (Chỉ áp dụng cho local):
----------------------------------------

Thay các tham số sau trong file .env:
  DB_HOST=localhost
  DB_USER=root
  DB_PASSWORD=Yahana0509@
  DB_NAME=demohmdrinks
  DB_PORT=4000

  GROQ_API_KEY=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
  COHERE_API_KEY=v34SUVXvG16NlmEZQt1mtwSeUbbdbxCy5KCFue11
  GOOGLE_API_KEY_1=AIzaSyCO-RlqYewC4e9BEPoC8m-AxHUY7J3_o2E
  COHERE_API_KEY_2=v34SUVXvG16NlmEZQt1mtwSeUbbdbxCy5KCFue11
  COHERE_API_KEY_3=v34SUVXvG16NlmEZQt1mtwSeUbbdbxCy5KCFue11
  GOOGLE_API_KEY=AIzaSyCO-RlqYewC4e9BEPoC8m-AxHUY7J3_o2E
  OPENAI_API_KEY=

Nếu bạn sử dụng server online như TiDB, có thể sử dụng các thông số bên dưới (hiện đang được comment lại trong .env):
  MYSQL_USER_NAME=LMjutwKKRG72ypx.root
  MYSQL_PASSWORD=mYF2H7KLqpH20XEK
  MYSQL_PORT=4000
  MYSQL_DATABASE=pychatbot
  MYSQL_HOST=gateway01.eu-central-1.prod.aws.tidbcloud.com

------------------------------------------------------
2. THAY ĐỔI ĐƯỜNG DẪN DB TRONG FILE `chat.py`
------------------------------------------------------

Mở file chat.py và chỉnh dòng kết nối database:

Nếu có mật khẩu:
  db = SQLDatabase.from_uri("mysql+pymysql://root:Yahana0509%40@127.0.0.1:4000/demohmdrinks")

Nếu không có mật khẩu:
  Tại phần:
    db_config = {
        "host": os.getenv("DB_HOST"),
        "user": os.getenv("DB_USER"),
        "password": os.getenv("DB_PASSWORD"),
        ...
    }
  -> Hãy comment dòng "password": os.getenv("DB_PASSWORD"),

-------------------------------------------------------------
3. THAY ĐỔI CẤU HÌNH MYSQL (KHÔNG DÙNG PASSWORD)
-------------------------------------------------------------

Vào file: repository/MySQL/Config_Database_MySQL.py

Tìm dòng:
  password=MYSQL_PASSWORD,
-> và comment lại nếu không có password.

Nếu bạn sử dụng server MySQL Online (TiDB, PlanetScale...), thay function `get_db_engine()` bằng:

    def get_db_engine():
        dsn = URL.create(
            drivername="mysql+pymysql",
            username=MYSQL_USER_NAME,
            password=MYSQL_PASSWORD,
            host=MYSQL_HOST,
            port=MYSQL_PORT,
            database=MYSQL_DATABASE
        )
        connect_args = {
            "ssl_verify_cert": True,
            "ssl_verify_identity": True,
            "ssl_ca": 'cert.pem',
        }
        return create_engine(
            dsn,
            connect_args=connect_args,
        )

------------------------------------------------------
4. CHẠY ỨNG DỤNG VỚI MÔI TRƯỜNG THÔNG THƯỜNG
------------------------------------------------------

Bước 1: Tạo môi trường ảo (venv)
  python -m venv venv

Bước 2: Kích hoạt môi trường ảo

  * Windows CMD:
    venv\Scripts\activate

  * Windows PowerShell:
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted -Force
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force
    Set-ExecutionPolicy Unrestricted -Scope Process
    venv\Scripts\Activate.ps1

  * macOS/Linux:
    source venv/bin/activate

Bước 3: Cài đặt thư viện cần thiết:
  pip install -r requirements.txt

Bước 4: Chạy server FastAPI:
  python main.py

Sau khi chạy, truy cập tài liệu API tại:
  - http://127.0.0.1:8085/docs
  - hoặc: https://rightly-poetic-amoeba.ngrok-free.app/docs