🏢 Odoo 15 - Hệ Thống Quản Lý Tài Sản & Kế Toán

Đại Nam University	AIoT Lab	Khoa CNTT

Trường Đại học Đại Nam  •  AIoT Lab  •  Khoa Công Nghệ Thông Tin

Giải pháp ERP tích hợp cho doanh nghiệp Việt Nam

• 🎯 Tổng Quan
• ✨ Tính Năng Chính
• 📦 Các Module
• 🚀 Hướng Dẫn Cài Đặt
• 📚 Tài Liệu
• 🎓 Demo & Hướng Dẫn Sử Dụng
• 🏗️ Kiến Trúc
• 🤝 Đóng Góp
• 📞 Liên Hệ

👉 Xem poster PDF đầy đủ

Dự án này là một giải pháp ERP doanh nghiệp được xây dựng trên nền tảng Odoo 15.0, chuyên biệt hóa cho các doanh nghiệp tại Việt Nam. Hệ thống được thiết kế để quản lý tài sản cố định, kế toán tài chính và nhân sự một cách tích hợp.

• Doanh nghiệp nhỏ - vừa tại Việt Nam
• Kỹ sư phần mềm muốn học Odoo framework
• Kế toán viên cần công cụ quản lý số hóa
• Quản lý tài sản cần giải pháp khấu hao tự động

Mục đích: Quản lý nhân viên, phòng ban, chức vụ, chứng chỉ

Tính năng chính:

• ✅ Thông tin nhân viên (mã NV, tên, ngày sinh, email, v.v.)
• ✅ Quản lý phòng ban & cơ cấu tổ chức
• ✅ Chức vụ & mô tả công việc
• ✅ Chứng chỉ & bằng cấp
• ✅ Lịch sử công tác
• ✅ Liên kết với tài sản (quản lý nhân viên)

Model chính: nhan_vien, phong_ban, chuc_vu, chung_chi, lich_su_cong_tac

Mục đích: Quản lý vòng đời tài sản cố định & khấu hao tự động

Tính năng chính:

• ✅ Quản lý thông tin tài sản chi tiết
• ✅ Lịch sử sử dụng & bảo trì
• ✅ Mượn/trả tài sản cho nhân viên
• ✅ Kiểm kê tài sản định kỳ
• ✅ Quản lý vòng đời, vị trí tài sản

Model chính: tai_san, khau_hao, lich_su_su_dung, phieu_muon, phieu_kiem_ke, thanh_ly_tai_san

Mục đích: Quản lý kế toán, hóa đơn, bút toán theo chuẩn Việt Nam

Tính năng chính:

• ✅ Hệ thống tài khoản kế toán theo TT200/133 (mặc định)
• ✅ Hóa đơn mua hàng chi tiết
• ✅ Bút toán kép tự động (Nợ/Có)
• ✅ Sổ cái & Sổ chi tiết
• ✅ Quản lý công nợ nhà cung cấp
• ✅ Khấu hao tài sản
• ✅ Thanh lý tài sản
• ✅ Báo cáo tài chính
• ✅ Quản lý thuế GTGT

Model chính: tai_khoan_ke_toan, hoa_don_mua, but_toan_ke_toan, so_cai, so_chi_tiet, khau_hao_tai_san

• OS: Ubuntu 22.04 LTS (khuyên dùng)
• Python: 3.8+
• PostgreSQL: 13+
• Memory: 2GB RAM tối thiểu (4GB khuyên dùng)
• Disk: 5GB cho dữ liệu

git clone https://github.com/HuyHoangFSDev/TTDN-15-05-N1.git
cd TTDN-15-05-N1

# Cài đặt các thư viện hệ thống
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 \
    postgresql-client

python3.10 -m venv ./venv
source venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

# Option A: Sử dụng Docker
docker-compose up -d

# Option B: Cài đặt PostgreSQL thủ công
sudo apt-get install postgresql
sudo -u postgres createuser -P odoo
sudo -u postgres createdb -O odoo odoo_db

Copy từ template:

cp odoo.conf.template odoo.conf

Nội dung odoo.conf (ví dụ):

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

# Khởi tạo database mới
python3 odoo-bin.py -c odoo.conf -d odoo_database --stop-after-init

# Cài đặt 3 module chính
python3 odoo-bin.py -c odoo.conf -d odoo_database \
    -i nhan_su,quan_ly_tai_san,tai_chinh_ke_toan \
    --stop-after-init

python3 odoo-bin.py -c odoo.conf -d odoo_database

# Hoặc nâng cấp tất cả modules mỗi lần chạy
python3 odoo-bin.py -c odoo.conf -d odoo_database -u all

Truy cập: http://localhost:8069

Thông tin đăng nhập mặc định:

• Username: admin
• Password: admin

⏱️ Thời gian: ~20 phút

1. Menu → Nhân sự → Tạo phòng ban "Kế Toán"
2. Menu → Nhân sự → Tạo chức vụ "Kế Toán Trưởng"
3. Menu → Nhân sự → Tạo nhân viên "Trần Thị B"
4. Menu → Tài sản → Tạo loại tài sản "Máy tính"
5. Menu → Tài sản → Tạo nhà cung cấp "DELL Vietnam"

Menu → Kế toán → Hóa đơn mua → Tạo mới
├─ Nhà cung cấp: DELL Vietnam
├─ Chi tiết:
│  ├─ Dell XPS 13: 25,000,000 VND (Đánh dấu là tài sản)
│  └─ Chuột không dây: 500,000 VND
└─ Xác nhận → Bút toán tự động sinh

Menu → Tài sản → Quản lý Tài sản → Tạo từ hóa đơn
├─ Loại: Máy tính
├─ Khấu hao: 60 tháng (5 năm)
├─ Lưu
└─ Xem khấu hao: 25M / 60 = ~417K VND/tháng

Menu → Kế toán → Báo cáo → Sổ chi tiết
├─ Chọn TK 211 (Máy móc): Ghi nợ 25,000,000
├─ Chọn TK 331 (Phải trả): Ghi có 25,000,000
└─ Kiểm tra bút toán tự động

Menu → Tài sản → Khấu hao tài sản
└─ Xem khấu hao tháng này: 417,000 VND

Sau 5 năm:
Menu → Tài sản → Quản lý Tài sản → Thanh lý
└─ Hệ thống tính lỗ & tạo bút toán tự động

Coming soon 🎬

┌─────────────────────────────────────┐
│   🌐 Giao Diện Web (Odoo GUI)      │
├─────────────────────────────────────┤
│     📡 Odoo Server (Python)         │
│  ┌──────────────────────────────┐   │
│  │ 👥 nhan_su (Nhân sự)         │   │
│  │ 🏢 quan_ly_tai_san (Tài sản) │   │
│  │ 📊 tai_chinh_ke_toan (Kế toán)   │
│  └──────────────────────────────┘   │
└─────────────────────────────────────┘
           ⬇️ ORM
┌─────────────────────────────────────┐
│    🗄️  PostgreSQL Database          │
│  (Lưu trữ tất cả dữ liệu)           │
└─────────────────────────────────────┘

Hóa Đơn Mua
    ⬇️ Xác nhận
Bút Toán Tự Động
    ⬇️ Ghi sổ
Sổ Cái & Sổ Chi Tiết
    ⬇️ Báo cáo
Báo Cáo Tài Chính

Tài Sản (từ Hóa Đơn)
    ⬇️ Hàng tháng
Khấu Hao Tự Động
    ⬇️ Ghi sổ
Giá Trị Còn Lại
    ⬇️ Thanh lý
Bút Toán Thanh Lý

Liên Kết Chính:

res.partner (Nhà cung cấp)
    ⬆️ 1:N
hoa_don_mua (Hóa đơn)
    ⬇️ 1:N
chi_tiet_hoa_don_mua (Chi tiết)
    ⬆️
tai_san (Tài sản)
    ⬇️ 1:N
khau_hao_tai_san (Khấu hao)
    ⬇️
but_toan_ke_toan (Bút toán)

# Giá trị còn lại
gia_tri_con_lai = gia_tien_mua - khau_hao_tich_luy

# Tỷ lệ khấu hao
ti_le_khau_hao = (khau_hao_tich_luy / gia_tien_mua) * 100

# Khấu hao hàng tháng
khau_hao_hang_thang = gia_tien_mua / thoi_gian_su_dung_thang

Phiếu Mượn:    Draft → Duyệt → Hoàn thành → Hủy
Thanh Lý:      Draft → Xác nhận → Hoàn thành
Hóa Đơn:       Nháp → Xác nhận → Thanh toán
Khấu Hao:      Draft → Ghi nhận → Hoàn thành

• ⏰ Tính khấu hao tài sản - Chạy hàng ngày lúc 2:00 AM
• 📊 Cập nhật sổ cái - Hàng ngày
• 📉 Cập nhật báo cáo - Theo yêu cầu

# Kiểm tra đường dẫn addons_path
python3 odoo-bin.py -c odoo.conf --addons-path=/path/to/addons

# Kiểm tra PostgreSQL
psql -h localhost -U odoo -d odoo_database

# Khởi động PostgreSQL
sudo service postgresql start

→ Kiểm tra: Tài sản có ngày bắt đầu khấu hao chưa?
→ Kiểm tra: Tài sản có liên kết với hóa đơn chưa?
→ Chạy lại: ./odoo-bin.py -u quan_ly_tai_san

→ Kiểm tra: Hóa đơn có ở trạng thái "Xác nhận" không?
→ Kiểm tra: Tài khoản kế toán có được cấu hình không?
→ Chạy lại: ./odoo-bin.py -u tai_chinh_ke_toan

Chúng tôi hoan nghênh mọi đóng góp từ cộng đồng! 🎉

1. Fork repository này
2. Tạo branch cho tính năng của bạn (git checkout -b feature/AmazingFeature)
3. Commit thay đổi (git commit -m 'Add some AmazingFeature')
4. Push đến branch (git push origin feature/AmazingFeature)
5. Mở Pull Request

• ✅ Tuân theo PEP 8
• ✅ Thêm docstring cho tất cả hàm
• ✅ Viết test cho mọi tính năng mới
• ✅ Cập nhật tài liệu

Xem CONTRIBUTING.md để chi tiết hơn.

Dự án này được cấp phép dưới LGPL-3 License - xem file LICENSE để chi tiết.

• Hieu - Initial work
• HuyHoangFSDev - GitHub Host

• 📧 Email: contact@company.com
• 🌐 Website: http://www.yourcompany.com
• 💬 Discord: Link Discord
• 📱 Facebook: Link Facebook

Q: Tôi có thể sử dụng cho sản xuất không? A: Có, nhưng hãy kiểm tra kỹ và backup dữ liệu.

Q: Có hỗ trợ cho các tỉnh khác ngoài VN không? A: Có, bạn có thể custom lại theo chuẩn địa phương.

Q: Chi phí để triển khai là bao nhiêu? A: Miễn phí, nhưng bạn cần tài nguyên IT để cài đặt & bảo trì.

Vui lòng cho chúng tôi một ⭐ trên GitHub!

# Clone nhanh nhất
git clone --depth 1 https://github.com/HuyHoangFSDev/TTDN-15-05-N1.git

• Module Quản lý nhân sự
• Module Quản lý tài sản
• Module Kế toán & tài chính
• Module CRM (Quản lý khách hàng)
• Module Bán hàng
• Module Mua hàng
• Mobile App (React Native)
• API RESTful
• Dashboard Analytics
• AI-powered Insights

• Odoo Documentation
• Odoo Developer Guide
• Python ORM (Models)
• Thông Tư 200/2014/TT-BTC - Kế toán

Cảm ơn tất cả những người đã đóng góp cho dự án này!

Danh sách Contributor:

• Hieu
• HuyHoangFSDev
• [Các bạn ...]

• ✨ Thêm module Kế toán - Tài chính
• ✨ Thêm module Quản lý Tài sản
• ✨ Thêm khấu hao tự động
• ✨ Thêm tính năng mượn/trả tài sản
• 🐛 Sửa lỗi liên kết dữ liệu
• 📚 Thêm tài liệu chi tiết

• 🚀 Release ban đầu
• ✨ Module Quản lý nhân sự

🚀 Happy Coding! 🚀

Được xây dựng với ❤️ cho cộng đồng Odoo Việt Nam