An open API service indexing awesome lists of open source software.

https://github.com/azshurith/taskflow

A full-stack workflow automation dashboard built with NuxtJS, ASP.NET, PostgreSQL, and Redis. Fully Dockerized for rapid deployment and scalable backend/frontend integration.
https://github.com/azshurith/taskflow

asp-net-mvc docker nuxtjs postgresql redis vue3

Last synced: 3 months ago
JSON representation

A full-stack workflow automation dashboard built with NuxtJS, ASP.NET, PostgreSQL, and Redis. Fully Dockerized for rapid deployment and scalable backend/frontend integration.

Awesome Lists containing this project

README

          

# ๐Ÿš€ TaskFlow

> Full-stack workflow automation dashboard โ€” scalable, modular, and built for modern development.

**TaskFlow** is a full-stack platform that brings together a NuxtJS frontend with an ASP.NET backend, powered by PostgreSQL and Redis. It's fully Dockerized for instant environment setup, and designed to support scalable development across projects requiring queuing, caching, and user authentication.

---

## ๐Ÿงฐ Tech Stack

| Layer | Technology |
|---------------|----------------------------------------|
| **Frontend** | NuxtJS 3 (Vue 3, Vite) |
| **Backend** | ASP.NET Core (C#) |
| **Database** | PostgreSQL + pgAdmin GUI |
| **Cache** | Redis |
| **Container** | Docker + Docker Compose |

---

## ๐Ÿ“ฆ Features

- โœ… Clean, modular ASP.NET backend
- ๐Ÿ–ฅ๏ธ NuxtJS 3 frontend (Vue 3 + Pinia)
- ๐Ÿ˜ PostgreSQL with pgAdmin for database management
- ๐Ÿ” Redis for sessions, queuing, and caching
- ๐Ÿณ Dockerized with fully configurable environment
- ๐Ÿ” JWT-based authentication system
- ๐Ÿ”Œ Makefile CLI with custom developer commands

---

## ๐Ÿš€ Getting Started

### 1. Clone the Repository

```bash
git clone https://github.com/Azshurith/TaskFlow.git
cd TaskFlow
```

### 2. Create `.env` File

Copy and edit the environment file:

```bash
cp .env.example .env
```

Set project details, ports, credentials, and Docker paths as needed.

### 3. Launch with Docker

```bash
make project_start
```

Access your services:
- Nuxt Frontend: `http://localhost:4000`
- ASP.NET Backend: `http://localhost:4001`
- pgAdmin: `http://localhost:4002`
- Redis: `localhost:6379`

---

## ๐Ÿ› ๏ธ Project Structure

```
backend/ # ASP.NET backend (C#)
frontend/ # Nuxt 3 frontend (Vue 3)
.docker/ # Dockerfiles and Docker config
.env # Project environment variables
Makefile # CLI commands for automation
docker-compose.yml # Multi-container orchestration
```

---

## ๐Ÿงช Makefile CLI Commands

Use `make help` to view available commands:

| Command | Description |
|---------------------|----------------------------------------------|
| `project_start` | ๐Ÿš€ Start all containers |
| `project_stop` | ๐Ÿ›‘ Stop all containers |
| `project_restart` | ๐Ÿ”„ Restart containers |
| `project_destroy` | ๐Ÿ’ฃ Destroy containers and volumes |
| `project_cleanup` | ๐Ÿงน Clean compiled backend artifacts |
| `asp_shell` | ๐Ÿ”ง Shell into ASP.NET container |
| `asp_restore` | ๐Ÿ“ฆ Restore backend dependencies |
| `asp_build` | ๐Ÿ”ง Build backend project |
| `asp_run` | โ–ถ๏ธ Run backend |
| `asp_test` | ๐Ÿงช Run backend tests |
| `nuxt_shell` | ๐Ÿ”ง Shell into Nuxt container |
| `nuxt_install` | ๐Ÿ“ฆ Install frontend packages |
| `nuxt_update` | ๐Ÿ”„ Update frontend packages |
| `nuxt_dev` | ๐Ÿ› ๏ธ Run frontend in dev mode |
| `nuxt_start` | โ–ถ๏ธ Run frontend in production mode |
| `nuxt_build` | ๐Ÿ”ง Build frontend |
| `help` | ๐Ÿ“– Show Makefile help menu |

---

## ๐Ÿ” Authentication

JWT-based authentication is integrated:

```http
Authorization: Bearer
```

---

## ๐Ÿง  Redis Use Cases

- User sessions
- Background job queues
- Temporary caching for API or DB results

---

## ๐Ÿ—๏ธ Manual Build (Frontend)

```bash
cd frontend
npm install
npm run build
```

---

## ๐Ÿ‘ค Author

**Devitrax / Azshurith**
GitHub: [@Azshurith](https://github.com/Azshurith)

---

## ๐Ÿ“„ License

[MIT](./LICENSE)