VietERP Platform is a comprehensive, enterprise-grade ERP ecosystem built with modern web technologies, specifically designed for Vietnamese enterprises. It offers a full suite of modules addressing core business needs, with built-in compliance for local regulations such as VAS accounting (TT200), e-Invoices (NĐ123), and social insurance, providing a significant advantage for businesses operating within Vietnam.

How It Works

The platform employs a modular, event-driven architecture, leveraging TypeScript across its frontend (Next.js) and backend (Next.js API Routes, NestJS). It utilizes Prisma ORM for database interactions with PostgreSQL, and NATS JetStream as a robust event bus for inter-module communication. Key functionalities like authentication, search, and notifications are handled by dedicated shared packages, promoting code reusability and maintainability. This approach allows for scalability and flexibility, enabling businesses to adopt specific modules or the entire ecosystem.

Quick Start & Requirements

• Primary install/run command: git clone https://github.com/nclamvn/Viet-ERP.git, cd Viet-ERP, npm run setup (installs dependencies, Docker, migrates DB, seeds data), then npm run dev to start the development server.
• Prerequisites: Node.js (implied by npm), Docker. Cross-platform compatibility is emphasized, requiring no make or bash for the one-command setup.
• Links: The repository itself serves as the primary documentation source.

Highlighted Details

• Scale: A substantial project with over 1.4 million lines of code, comprising 16 distinct application modules and 27 shared packages.
• Vietnamese Market Focus: Deep integration with local requirements including VAS accounting (TT200), e-Invoice (NĐ123), social insurance (BHXH/BHYT/BHTN), VietQR, and support for 20 Vietnamese banks.
• Modern Tech Stack: Utilizes Next.js 14, NestJS, Prisma, NATS JetStream, Keycloak SSO, Meilisearch (Vietnamese-optimized), PostgreSQL 16, Turborepo, Vitest, and Playwright.
• Deployment & Observability: Production-ready deployment options via Docker Compose, Kubernetes (Helm), and Infrastructure as Code (Terraform for AWS, GCP, Azure). Includes a comprehensive monitoring stack with Prometheus, Grafana, and Loki.

Maintenance & Community

The project includes standard community contribution files (CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md) and templates for issues and pull requests, indicating a structured approach to community engagement. Specific community channels like Discord or Slack are not explicitly mentioned in the README.

Licensing & Compatibility

The project is licensed under the MIT License, which is permissive and generally suitable for commercial use and integration into closed-source applications.

Limitations & Caveats

The project is presented as 100% complete across all modules and features. However, its primary focus on Vietnamese market-specific regulations and integrations means it may require significant localization effort for adoption in other regions. The extensive feature set and large codebase suggest a considerable learning curve for new developers.