https://github.com/ibuildrun/hqstudio
HQ Studio - Premium Auto Tuning CRM System. Web + Desktop + API monorepo
https://github.com/ibuildrun/hqstudio
crm csharp docker dotnet nextjs react typescript wpf
Last synced: 3 months ago
JSON representation
HQ Studio - Premium Auto Tuning CRM System. Web + Desktop + API monorepo
- Host: GitHub
- URL: https://github.com/ibuildrun/hqstudio
- Owner: ibuildrun
- License: mit
- Created: 2025-12-20T19:37:06.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-12T09:37:49.000Z (5 months ago)
- Last Synced: 2026-01-12T18:44:18.251Z (5 months ago)
- Topics: crm, csharp, docker, dotnet, nextjs, react, typescript, wpf
- Language: C#
- Size: 2.75 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# HQ Studio
[](README.md) [](README.ru.md)
[](https://github.com/randomu3/hqstudio/actions/workflows/ci.yml)
[](https://github.com/randomu3/hqstudio/actions/workflows/release.yml)
[](https://codecov.io/gh/randomu3/hqstudio)
[](https://github.com/randomu3/hqstudio/releases)
[](https://opensource.org/licenses/MIT)
A comprehensive solution for an auto tuning studio: website, API, and desktop CRM application.
**[Demo Site](https://randomu3.github.io/hqstudio/)** | **[Releases](https://github.com/randomu3/hqstudio/releases)** | **[API Docs](docs/API.md)** | **[Architecture](docs/ARCHITECTURE.md)** | **[Git & CI/CD](docs/GIT-INTEGRATION.md)**
## Project Structure
```
├── HQStudio.API/ # ASP.NET Core 8.0 Backend
├── HQStudio.API.Tests/ # API Integration Tests
├── HQStudio.Web/ # Next.js 14 Frontend
├── HQStudio.Desktop/ # WPF Desktop Application
├── HQStudio.Desktop.Tests/# Desktop Unit Tests
└── docker-compose.yml # Production Docker setup
```
## Desktop Application Screenshots
Show screenshots
### Login Window
### Dashboard (Dark Theme)
### Orders
### Clients
### Services
### Staff
### Settings
### Dashboard (Light Theme)
## Quick Start
### Requirements
- .NET 8.0 SDK
- Node.js 20+
- Docker (optional)
### Local Development
```bash
# Clone the repository
git clone https://github.com/randomu3/hqstudio.git
cd hqstudio
# Copy env files
cp .env.example .env
# Run API
cd HQStudio.API
dotnet run
# Run Web (in another terminal)
cd HQStudio.Web
npm install
npm run dev
# Run Desktop (Windows)
cd HQStudio.Desktop
dotnet run
```
### Docker (development with hot-reload)
```bash
docker-compose -f docker-compose.dev.yml up --build
```
### Docker (production)
```bash
docker-compose up --build -d
```
## Tests
```bash
# API tests
dotnet test HQStudio.API.Tests
# Web tests
cd HQStudio.Web && npm test
# Desktop tests
dotnet test HQStudio.Desktop.Tests
```
## CI/CD
The project uses a fully automated CI/CD pipeline:
| Workflow | Purpose |
|----------|---------|
| **CI** | API, Web, Desktop tests + Codecov |
| **Release** | Semantic versioning, CHANGELOG, Docker images |
| **Pages** | Deploy Web to GitHub Pages |
| **CodeQL** | Security analysis |
| **Dependabot** | Auto-update dependencies |
### Conventional Commits
All commits must follow the format:
```
feat(api): add new feature
fix(web): fix bug
docs: update documentation
```
More details: [CONTRIBUTING.md](CONTRIBUTING.md) | [Git & CI/CD](docs/GIT-INTEGRATION.md)
## Technologies
### Backend (API)
- ASP.NET Core 8.0
- Entity Framework Core
- PostgreSQL / SQLite
- JWT Authentication
- Swagger/OpenAPI
### Frontend (Web)
- Next.js 14 (App Router)
- React 18
- TypeScript
- Tailwind CSS
- Framer Motion
### Desktop
- .NET 8.0 WPF
- MVVM Pattern
- Material Design
## Environment Variables
See `.env.example` for the full list of variables.
## License
MIT License — see [LICENSE](LICENSE)
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute.
## Security
See [SECURITY.md](SECURITY.md) for the security policy.