O24 Platform Documentation
📘 Enterprise-ready · Clean Architecture · DDD · Microservices · Event-driven
O24 Platform là một hệ sinh thái OpenAPI & Transaction Platform được thiết kế cho các hệ thống tài chính hiện đại, bao gồm Core Banking, Fintech, Wallet và Payment.
🌐 Giới thiệu
O24 Platform được xây dựng để đáp ứng các nhu cầu:
O24 Document là cổng tài liệu chính thức, giúp Developer, BA/SA, DevOps và đội Integration nắm bắt toàn bộ kiến trúc & nghiệp vụ.
🧱 Kiến trúc tổng thể
┌──────────────────────────────────────────────────────────────┐
│ Client Applications │
│ (Web / Mobile / App) │
└────────────────────────────┬─────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────┐
│ API Gateway / BFF │
│ (Auth, RateLimit, Routing) │
└────────────────────────────┬─────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────┐
│ O24 Microservices │
│ │
│ • Wallet Service • Core Banking Gateway (CBG) │
│ • Deposit / Loan Service • CMS / Config / Media │
│ • Transaction Service • Notification (SMS/Push/Email) │
│ • Reporting / CDC / Audit │
└────────────────────────────┬─────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────┐
│ Core & External Systems │
│ │
│ • Oracle Core Banking (O9) • RabbitMQ / Kafka │
│ • SQL Server / PostgreSQL • Firebase / SMS Provider │
└──────────────────────────────────────────────────────────────┘🧠 Triết lý thiết kế
O24 được xây dựng dựa trên các nguyên tắc kiến trúc hiện đại:
| Nguyên tắc | Mô tả |
|---|---|
| Clean Architecture | Tách biệt rõ ràng các layer, business logic độc lập |
| DDD (Domain-Driven Design) | Thiết kế theo domain nghiệp vụ |
| Transaction-driven | Mọi thao tác đều được quản lý qua transaction |
| Event-driven | Tích hợp bất đồng bộ qua events |
| Enterprise Security | Bảo mật & audit toàn diện |
👉 Business logic luôn độc lập với framework, database, UI.
📦 Cấu trúc dự án Backend (.NET)
Clean Architecture Mapping
| Layer | Mục đích |
|---|---|
| Domain | Business rules thuần túy |
| Application | Use case, orchestration |
| Infrastructure | DB, Core Banking, External APIs |
| WebAPI | REST / gRPC endpoints |
🔐 Security & Authentication
O24 áp dụng các cơ chế bảo mật enterprise-grade:
- ✅ JWT / OAuth2 / API Key – Xác thực đa phương thức
- ✅ Device Binding – Ràng buộc thiết bị
- ✅ OTP / Smart OTP – Xác thực 2 lớp
- ✅ Role-based Access Control – Phân quyền chi tiết
- ✅ Full Audit Trail – Ghi log toàn bộ hoạt động
🗄 Database Strategy
| Database | Mục đích |
|---|---|
| Oracle | Core Banking |
| SQL Server | Transaction, Wallet, CMS |
| PostgreSQL | Reporting, Analytics |
| Redis | Cache, Session |
🛠 Tech Stack
| Frontend Docs | Backend |
|---|---|
| Nextra 4, Next.js | .NET 8/9/10 |
| Database | Messaging |
|---|---|
| Oracle, SQL Server, PostgreSQL | RabbitMQ |
| Infrastructure | CI/CD |
|---|---|
| Docker, Nginx, Linux | GitLab / GitHub Actions |
📘 Cấu trúc tài liệu
- introduction
- architecture
- wallet
- transaction
- deposit
- api-reference
- database
- dev-guide
- deployment
- faq
🚀 Local Development
pnpm install
pnpm devTruy cập: http://localhost:3000
📌 Định hướng mở rộng
- 🤖 AI / RAG / Knowledge Base – Tích hợp trí tuệ nhân tạo
- ⚙️ Rule Engine – Hệ thống luật nghiệp vụ
- 🏢 Multi-tenant – Hỗ trợ đa khách hàng
- 🌐 OpenAPI Marketplace – Nền tảng chia sẻ API
- 🧪 Sandbox & Developer Portal – Môi trường thử nghiệm
📄 License
O24 Platform – Internal / Enterprise License
© O24 / VKNIGHT / JITS
License
MIT License - feel free to use this template for your projects!
Ready to build your docs? Get Started →