https://github.com/phamtiendungcw/sobactx
SobActX s an e-commerce platform designed for medium and large businesses, providing comprehensive solutions. Using Clean Architecture with CQRS pattern, .NET Core 6, Angular 16 and SQL Server/Oracle for the database. SobActX ensures high performance, security, easy maintenance and scalability.
https://github.com/phamtiendungcw/sobactx
angular cqrs-pattern dotnet-core oracle-database sqlserver
Last synced: 13 days ago
JSON representation
SobActX s an e-commerce platform designed for medium and large businesses, providing comprehensive solutions. Using Clean Architecture with CQRS pattern, .NET Core 6, Angular 16 and SQL Server/Oracle for the database. SobActX ensures high performance, security, easy maintenance and scalability.
- Host: GitHub
- URL: https://github.com/phamtiendungcw/sobactx
- Owner: phamtiendungcw
- License: apache-2.0
- Created: 2025-02-15T09:04:47.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2025-03-13T10:54:20.000Z (about 1 month ago)
- Last Synced: 2025-03-13T11:35:15.983Z (about 1 month ago)
- Topics: angular, cqrs-pattern, dotnet-core, oracle-database, sqlserver
- Language: C#
- Homepage:
- Size: 337 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# SobActX: Superior Online Business Automated Commerce Technology eXpertise
[](https://github.com/phamtiendungcw/SobActX/actions/workflows/main.yml)
[](CONTRIBUTING.md)
[](LICENSE.txt)
**SobActX** is a robust and scalable e-commerce platform designed for medium and large businesses. It is built with **Clean Architecture** and the **CQRS pattern**, using **.NET Core 6** for the backend, **Angular 16** for the frontend, and **SQL Server/Oracle** for the database. SobActX provides powerful sales and business analytics solutions to optimize your online business experience.
---
## 🌟 **Key Features**
- 🖥️ **Modern UI/UX**: Intuitive and responsive design powered by Angular.
- ⚙️ **Scalable Backend**: ASP.NET Core for high-performance and reliability.
- 🗄️ **Database Flexibility**: Supports SQL Server and Oracle Database.
- 📦 **Comprehensive Management**: Inventory, orders, customers, and payments in one place.
- 💳 **Secure Payment Gateway**: Integration with industry-standard payment systems.
- 📈 **Advanced Reporting**: Generate real-time insights for business decision-making.
- 🖼️ **Rich Media Integration**: Seamlessly integrate images, videos, and other media into your product catalog and content.
---
## 🚀 **Getting Started**
### 1️⃣ **Clone the Repository**
```bash
git clone
cd SobActX
```
### 2️⃣ **Set Up Backend**
- Open the SobActX.sln solution in **Visual Studio**.
- Restore NuGet packages:
```bash
dotnet restore
```
- Configure database connection strings in `appsettings.json`.
- Open the Package Manager Console and run the following command to update the database:
```bash
dotnet ef database update
```
- Set SAX.Server as the startup project. Then, press **F5** or click the Start button (with the green play icon) to run the project.
### 3️⃣ **Set Up Frontend**
- Navigate to the Angular frontend folder:
```bash
cd src/SAX.UI
```
- Install dependencies:
```bash
npm install
```
- Start the Angular development server:
```bash
ng serve
```
---
## 📂 **Project Structure**
```plaintext
SobActX/
├── src/
│ ├── SAX.Application/ # Application logic
│ ├── SAX.Domain/ # Core domain models
│ ├── SAX.Infrastructure/ # Infrastructure services
│ ├── SAX.Persistence/ # Database migrations and access
│ ├── SAX.Server/ # ASP.NET Core Web API
│ ├── SAX.UI/ # Angular frontend application
├── docs/ # Project documentation
├── tests/ # Project testing
├── LICENSE.txt # License file
├── README.md # Project overview
├── CONTRIBUTING.md # Contribute to the project
└── SobActX.sln # Solution file
```
---
## 🎯 Objectives
SobActX aims to provide medium and large businesses with a comprehensive tool to:
* ✅ Efficiently manage products and orders.
* 📊 Perform in-depth analysis of sales data and customer behavior.
* 📈 Optimize business strategies based on real-time data.
* 🚀 Enhance operational efficiency through robust media integrations.
---
## 🏗️ Architecture
SobActX is built upon **Layered Architecture** principles and **Clean Architecture** to ensure maintainability, scalability, and testability. The project is structured into distinct layers:
* **Domain:** :classical_building: Contains core business entities (e.g., Product, Order, Customer), value objects (e.g., Address), domain services (e.g., OrderCalculationService), and domain events (e.g., OrderCreatedEvent). It's independent of any specific frameworks or technologies.
* **Application:** :gear: Contains use cases, implementing the **CQRS** pattern to separate read (Queries) and write (Commands) operations.
* **Infrastructure:** :hammer_and_wrench: Contains specific implementations for database, caching, logging, external services, etc.
* **Presentation:** :globe_with_meridians: Contains the Web API controllers (backend) and Angular components (frontend), responsible for interacting with the user and the Application layer.
**CQRS (Command Query Responsibility Segregation):** :left_right_arrow: CQRS is used to segregate responsibilities between read and write operations, optimizing the performance and scalability of the system.
---
## 🛠️ **Tech Stack**
* **Backend:** .NET Core 6, ASP.NET Core, Entity Framework Core
* **Frontend:** Angular 16, TypeScript, RxJS, HTML5, CSS3
* **Database:** SQL Server / Oracle
* **API:** RESTful API
* **Authentication/Authorization:** JWT (JSON Web Tokens)
* **Caching:** Redis / Memcached (optional)
* **Logging:** Serilog
* **Testing:** xUnit / NUnit / MSTest (backend), Jasmine / Karma (frontend)
* **CI/CD:** GitHub Actions
---
## 📜 **License**
This project is licensed under the [Apache 2.0 License](LICENSE.txt).
---
## 🤝 **Contributing**
We welcome contributions!
Feel free to submit pull requests, report issues, or suggest new features. Please follow our [contribution guidelines](CONTRIBUTING.md).
---