🚗 AutoX.Gara

AutoX.Gara là hệ thống quản lý gara ô tô dạng Desktop Client–Server: quản lý khách hàng, xe, kho phụ tùng, dịch vụ sửa chữa, hóa đơn và nhân viên.
Client: .NET MAUI · Server: .NET · Giao tiếp: TCP qua Nalix.Network.

---

✨ Tính năng chính

🧩 Module	Mô tả
🔐 Đăng nhập	Xác thực tài khoản qua server, phiên làm việc an toàn
👥 Khách hàng	CRUD khách hàng, tra cứu, lọc
👔 Nhân viên	Quản lý hồ sơ nhân viên, lương, phân quyền
🚙 Xe (Vehicles)	Quản lý xe gắn với khách hàng
📦 Phụ tùng (Parts)	Quản lý kho linh kiện, tồn kho
🔧 Dịch vụ (Service Items)	Danh mục dịch vụ sửa chữa / bảo dưỡng
🏭 Nhà cung cấp	Quản lý nhà cung cấp phụ tùng
📋 Sửa chữa	Đơn sửa chữa (Repair Orders), hạng mục, công việc (Repair Tasks)
🧾 Hóa đơn & Giao dịch	Hóa đơn, giao dịch thanh toán

---

📌 Yêu cầu hệ thống

Thành phần	Yêu cầu
🖥️ Runtime	.NET 10 SDK
💻 Client	Windows (MAUI Windows)
🗄️ Database	SQLite (mặc định) hoặc PostgreSQL (tùy chọn)

---

📁 Cấu trúc solution

src/
├── AutoX.Gara.sln
├── AutoX.Gara.Domain/        # Entity, value object (DDD)
├── AutoX.Gara.Application/   # Use case, Nalix message handlers
├── AutoX.Gara.Infrastructure/# DbContext, Repository, Nalix listener
├── AutoX.Gara.Shared/        # DTO, protocol (request/response)
├── AutoX.Gara.Backend/       # Server (console, TCP listener)
└── AutoX.Gara.Frontend/      # Client MAUI (Windows)

➡️ Chi tiết: ARCHITECTURE.md

---

🚀 Build & chạy

1️⃣ Clone & restore

git clone https://github.com/ppn-systems/AutoX.Gara.git
cd AutoX.Gara/src
dotnet restore

2️⃣ Chạy server (Backend)

cd src/AutoX.Gara.Backend
dotnet run

Server lắng nghe TCP (port theo Nalix). Database mặc định: SQLite (AutoX.db).

3️⃣ Chạy client (Frontend – Windows)

cd src/AutoX.Gara.Frontend
dotnet build -f net10.0-windows10.0.19041.0
dotnet run -f net10.0-windows10.0.19041.0

Hoặc mở solution trong Visual Studio → chọn AutoX.Gara.Frontend (target Windows).

4️⃣ Database & migrations

Database	Ghi chú
SQLite	File DB tạo tự động (hoặc migration)
PostgreSQL	Cấu hình DatabaseType = "PostgreSQL" + ConnectionString

cd src/AutoX.Gara.Infrastructure
dotnet ef migrations add YourMigrationName --startup-project ../AutoX.Gara.Backend
dotnet ef database update --startup-project ../AutoX.Gara.Backend

➡️ Hướng dẫn chi tiết: docs/GETTING_STARTED.md

---

🖼️ Preview giao diện

Màn hình	Mô tả
🔐 Đăng nhập	Xác thực nhanh, bảo mật
👥 Khách hàng	Giao diện quản lý chuyên nghiệp
👔 Nhân viên	Theo dõi, phân quyền, hồ sơ
📦 Phụ tùng	Kho phụ tùng, tra cứu
🔧 Dịch vụ	Danh mục sửa chữa, bảo dưỡng
🏭 Nhà cung cấp	Thông tin, lịch sử nhập hàng

---

🛠️ Công nghệ sử dụng

Thành phần	Công nghệ
🖥️ Client UI	.NET MAUI 10 (Windows)
⚙️ Server	.NET 10 (Console)
📡 Giao tiếp	TCP, Nalix.Network
🗄️ Database	SQLite / PostgreSQL
🔄 ORM	Entity Framework Core 10
📝 Logging	Nalix.Logging
🧩 Client MVVM	CommunityToolkit.Mvvm

---

📚 Tài liệu

📂 Gốc repo

ARCHITECTURE.md — Kiến trúc hệ thống CONTRIBUTING.md — Đóng góp code CHANGELOG.md — Lịch sử thay đổi SECURITY.md — Báo lỗi bảo mật CODE_OF_CONDUCT.md — Quy tắc ứng xử

📁 docs/

GETTING_STARTED · CONFIGURATION · PROTOCOL DEPLOYMENT · TROUBLESHOOTING · GLOSSARY MODULES · DATABASE · FAQ OPERATIONS · ROADMAP · RELEASE DEVELOPMENT · COMPATIBILITY · THIRD_PARTY docs/README.md — Mục lục đầy đủ

---

📄 License

Dự án dùng giấy phép Apache-2.0. Xem LICENSE.

---

👤 Tác giả

PPN Corporation

Khi sử dụng hoặc đóng góp, vui lòng tuân thủ CODE_OF_CONDUCT.md.