A full-stack TypeScript monorepo application built with Turborepo, featuring a clean architecture pattern and domain-driven design.

Project Overview

Task Enterprise is a robust task management system with user authentication, role-based access control, and a modern React frontend.

Key Features

User authentication and authorization
Role-based access control with permission management
Task management with CRUD operations
Modern React frontend with shadcn-ui
Clean architecture with domain-driven design
Type-safe development with TypeScript

User Requirements

User Requirements Requirement Analysis

Project Structure

Architecture

The project is organized into multiple packages and apps, each with its own purpose.

graph TD subgraph Client_Layer [Client Side] A[Frontend App] end subgraph Server_Layer [Backend Services] B[ Controller] C[Business Logic] D[Prisma Client] end subgraph Data_Layer [Database] E[(PostgreSQL)] F[(Redis Cache)] end A -->|HTTP/REST| B B --> C C --> D D --> E C -.-> F

Apps

apps/restapi: Express.js REST API backend service
apps/web: React frontend application with shadcn-ui and Tailwind CSS

Packages

packages/core: Domain entities, interfaces, repositories, and use cases
packages/database: Database implementations (Prisma)
packages/errors: Custom error handling utilities
packages/eslint-config: Shared ESLint configurations
packages/permission-manager: Role and Attribute-based (RBAC & ABAC) access control system
packages/schemas: Zod validation schemas
packages/shared: Shared utilities
packages/typescript-config: Shared TypeScript configurations

`Shared Interfaces:`

classDiagram class JsonWebToken { <<interface>> sign() string verify() boolean } class HashPassword { <<interface>> hash() string compare() boolean } class DateFormatter { <<interface>> xAgo() string xRemain() string xDate() string difference() string } class Logger { <<interface>> log() void warn() void error() void debug() void }

`Repositories:`

classDiagram class UserRepository { <<interface>> findAll() findById() findByEmail() findByEmailWithPassword() update() remove() } class TodoRepository { <<interface>> findAll() findById() findByEmail() update() remove() }

`Use Cases:`

#### User UseCases:

Use Case	Description
Registration	Allows new users to sign up and create an account in the system.
Login	Validates user credentials and provides access via session or token.
AddUser	An administrative action to manually create and invite new users.
ViewUser	Retrieves a list of multiple users, usually for administrative purposes.
ViewSingleUser	Fetches the specific profile details and roles for a single user.
UpdateUser	Updates existing user information like name, email, or permissions.
DeleteUser	Removes a user account or marks it as inactive in the database.

#### Todo Use Cases

Use Case	Description
CreateTodo	Creates a new task entry assigned to the authenticated user.
ViewTodos	Lists all tasks belonging to a user or a specific filtered set.
UpdateTodo	Modifies task details such as title, description, or status.
DeleteTodo	Removes a specific task entry permanently from the list.

`Entity Relationship Diagram`:

erDiagram Users ||--o{ Todo : "has" Users ||--|| Role : "assigned" Users { UUID id PK string email string email_unique string name Role role datetime createdAt datetime updatedAt datetime deletedAt } Todo { UUID id PK string title string description boolean completed UUID userId FK datetime createdAt datetime updatedAt datetime deletedAt } Role { string user string admin string super_admin }

`Permission Flow:`

graph LR SA[Super Admin] --> Admin Admin --> UP[AdminUserPermissions] SA --> USP[SuperAdminUserPermissions] UP --> Create UP --> ViewAll UP --> View USP --> Update USP --> Delete Admin --> User User --> TP[TodoPermissions] TP --> T_Create[Create] TP --> T_ViewAll[ViewAll] TP --> T_View[View] TP --> T_Update[Update] TP --> T_Delete[Delete]

Getting Started

Prerequisites

Node.js >= 18
pnpm 9.0.0
PostgreSQL database

Installation

Clone the repository:

git clone git@github.com:mislam-dev/task-management-enterprise.git
cd task-management-enterprise

Install dependencies:

pnpm install

Set up environment variables:

Copy .env.example to .env
Update the database connection string and other required variables

N:B: There are several folder where .env.example is exist. You should update those

Set up the database:

pnpm -F @todo/database prisma:generate
pnpm -F @todo/database prisma:migrate

Development

Start all services in development mode:

pnpm dev

Other useful commands:

# Build all packages
pnpm build

# Run linting
pnpm lint

# Format code
pnpm format

# Type checking
pnpm check-types

Docker Support

This project support docker. Run following command to start: docker compose up

Architecture

The application follows a clean architecture pattern with:

Domain Layer (packages/core)
Infrastructure Layer (packages/database, packages/shared)
Presentation Layer (apps/restapi, apps/web)

About Me

Hi! I'm a passionate software engineer dedicated to creating enterprise-level solutions. With a focus on clean architecture and domain-driven design, I strive to build scalable and maintainable applications that solve real-world problems.

My Expertise

Full-stack Development with TypeScript
Clean Architecture & DDD Principles
Enterprise Application Design
Modern Frontend Development (React)
Backend Development (Node.js/Express)

Contact Me

Get in Touch

I'm always open to discussing technology, software architecture, or potential collaborations. Feel free to reach out through any of these channels:

📧 Email: mmislam027@gmail.com
💼 LinkedIn: https://www.linkedin.com/in/mislam-dev/
🐱 GitHub: https://github.com/mislam-dev
🌐 Portfolio: https://mislam-dev.vercel.app/

Let's Connect

Whether you're interested in contributing to this project, have questions about the implementation, or just want to connect, I'd love to hear from you!