📋 Tổng Quan

Dự án Hệ Thống Quản Lý Doanh Nghiệp với AI là một nền tảng ERP mạnh mẽ được xây dựng trên Odoo 15, tích hợp công nghệ AI tiên tiến để tối ưu hóa quản lý nhân sự, dự án và công việc. Hệ thống cung cấp giao diện trực quan, phân tích thông minh và tự động hóa quy trình nghiệp vụ.

🎯 Mục Tiêu Dự Án

• ✅ Tự động hóa quy trình quản lý nhân sự
• ✅ Tối ưu hóa quản lý dự án với phân tích AI
• ✅ Nâng cao hiệu suất công việc với gợi ý thông minh
• ✅ Cung cấp báo cáo và phân tích dữ liệu chi tiết
• ✅ Tích hợp AI để hỗ trợ ra quyết định

✨ Tính Năng Nổi Bật

🧑‍💼 Module Quản Lý Nhân Sự (nhan_su)

📊 Module Quản Lý Dự Án (quan_ly_du_an)

✅ Module Quản Lý Công Việc (quan_ly_cong_viec)

🤖 Module AI Assistant (ai_assistant)

🛠 Công Nghệ Sử Dụng

📦 Hướng Dẫn Cài Đặt

Yêu Cầu Hệ Thống

• OS: Ubuntu 20.04+ / Debian 11+ / macOS / Windows (WSL2)
• RAM: Tối thiểu 4GB, khuyến nghị 8GB+
• Disk: 10GB trống
• Python: 3.10 hoặc cao hơn
• PostgreSQL: 13 hoặc cao hơn
• Docker & Docker Compose (khuyến nghị)

Bước 1: Clone Repository

git clone https://github.com/Trinhvhao/TTDN-16-05-N5.git
cd TTDN-16-05-N5

Bước 2: Cài Đặt Dependencies

Trên Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y \
    libxml2-dev libxslt-dev libldap2-dev libsasl2-dev \
    libssl-dev python3.10-distutils python3.10-dev \
    build-essential libffi-dev zlib1g-dev python3.10-venv \
    libpq-dev git wget curl

Trên macOS:

brew install [email protected] postgresql libxml2 libxslt openldap

Bước 3: Tạo Virtual Environment

python3.10 -m venv venv
source venv/bin/activate  # Linux/macOS
# hoặc: venv\Scripts\activate  # Windows

Bước 4: Cài Đặt Python Packages

pip install --upgrade pip
pip install -r requirements.txt

Bước 5: Setup Database

Sử dụng Docker (Khuyến nghị):

docker-compose up -d

Hoặc PostgreSQL thủ công:

sudo -u postgres createuser -s odoo
sudo -u postgres createdb odoo_fitdnu

Bước 6: Cấu Hình Odoo

Tạo file odoo.conf:

[options]
addons_path = addons
db_host = localhost
db_password = odoo
db_user = odoo
db_port = 5432
db_name = odoo_fitdnu
xmlrpc_port = 8069
logfile = /var/log/odoo/odoo.log
log_level = info

Bước 7: Khởi Chạy Odoo

./venv/bin/python3 odoo-bin -c odoo.conf -d odoo_fitdnu -i nhan_su,quan_ly_du_an,quan_ly_cong_viec,ai_assistant

Hoặc với dev mode:

./venv/bin/python3 odoo-bin -c odoo.conf -d odoo_fitdnu --dev=all

Bước 8: Truy Cập Hệ Thống

Mở trình duyệt và truy cập: http://localhost:8069

Đăng nhập với:

• Email: admin
• Password: admin

🚀 Hướng Dẫn Sử Dụng

Cài Đặt Modules

1. Đăng nhập với tài khoản admin
2. Vào menu Ứng dụng (Apps)
3. Tìm và cài đặt các module:
   • Quản Lý Nhân Sự (nhan_su)
   • Quản Lý Dự Án (quan_ly_du_an)
   • Quản Lý Công Việc (quan_ly_cong_viec)
   • AI Assistant (ai_assistant)

Cấu Hình AI Assistant ⚠️ (QUAN TRỌNG)

Lưu ý: Module AI Assistant yêu cầu API key để hoạt động

Cách 1: Qua giao diện web

1. Vào AI Assistant → Cấu hình
2. Nhập thông tin:
   • API Key: Lấy từ OpenRouter.ai
   • Model: Chọn model phù hợp (mặc định: google/gemini-2.0-flash-exp:free)
   • Temperature: 0.7 (khuyến nghị)
   • Max Tokens: 4000
3. Click "Test Kết Nối" để kiểm tra
4. Nhấn Lưu

Cách 2: Sử dụng script

python3 test_ai_config.py

Hướng dẫn chi tiết

Xem: AI_CONFIG_GUIDE.md

Demo Data

Hệ thống tự động tạo dữ liệu mẫu:

• 10 nhân viên
• 5 phòng ban
• 3 dự án
• 15 công việc

📚 Tài Liệu

🏗 Kiến Trúc Hệ Thống

odoo-fitdnu/
├── addons/                      # Custom modules
│   ├── nhan_su/                # Module quản lý nhân sự
│   │   ├── models/            # Business logic
│   │   ├── views/             # UI templates
│   │   ├── data/              # Demo & seed data
│   │   ├── security/          # Access rights
│   │   └── __manifest__.py
│   ├── quan_ly_du_an/         # Module quản lý dự án
│   ├── quan_ly_cong_viec/     # Module quản lý công việc
│   └── ai_assistant/          # Module AI assistant
├── odoo/                        # Odoo core framework
├── docs/                        # Documentation
├── docker-compose.yml          # Docker configuration
├── odoo.conf                   # Odoo configuration
├── requirements.txt            # Python dependencies
└── README.md                   # This file

🎨 Screenshots

🤝 Đóng Góp

Chúng tôi hoan nghênh mọi đóng góp! Vui lòng xem CONTRIBUTING.md để biết thêm chi tiết.

Cách đóng góp:

1. Fork repository
2. Tạo branch mới (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Mở Pull Request

👥 Nhóm Phát Triển

Nhóm 5 - TTDN-16-05

• Trịnh Văn Hào - Team Lead & Full-stack Developer
  • GitHub: @Trinhvhao
  • Email: [email protected]

Giảng Viên Hướng Dẫn

• ThS. [Tên Giảng Viên]
• Khoa Công Nghệ Thông Tin
• Đại Học FIT DNU

📄 License

Dự án được phát hành dưới giấy phép LGPL-3.0

🙏 Lời Cảm Ơn

• Odoo Community - Framework tuyệt vời
• OpenRouter - AI API platform
• PostgreSQL Team - Database mạnh mẽ
• Khoa CNTT - Đại Học FIT DNU - Hỗ trợ và hướng dẫn

📞 Liên Hệ & Hỗ Trợ

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [email protected]

📈 Roadmap

• [x] Phase 1: Core modules (Nhân sự, Dự án, Công việc)
• [x] Phase 2: AI Assistant integration
• [ ] Phase 3: Mobile application
• [ ] Phase 4: Advanced analytics & BI
• [ ] Phase 5: Multi-company support
• [ ] Phase 6: IoT integration