DataManager

This website helps to storage various data types and share it with others. My target is to create fully responsive, functional and scalable ERP-like website based on RWD, MFD, BDD and FDD principles. Serves as my coding sandbox, where I can experiment with different coding techniques, implement new features, and refine my skills.

Join my project and become part of building something incredible!

Live preview

    XAMPP

🛠️ Installation

• First make sure u have installed latest versions of PHP, Laravel, Vue.js, Node.js, npm, XAMPP and Composer

• I recommend use nvm for install latest supported versions of Node.js and npm,

nvm use --lts

• Clone this repository

git clone https://github.com/SzymCode/DataManager.git

• Change .env.example file to .env in root directory

• Generate APP_KEY

php artisan key:generate

• Install modules in root directory

npm install
composer update

# if you want use storybook
cd storybook
npm install

Make sure u have installed all modules!

• run XAMPP mysql server and create database

mysql -u root -p
create database datamanager
create database datamanager_test    # it's not necessary, only for tests

🚀 Run

Root directory:

npm run dev
php artisan serve

❓ Usage

Migrations

php artisan migrate:fresh --seed

# Reset database by dropping all tables and then run all migrations
# --seed flag runs the database seeders after the migrations

Factories

php artisan tinker

# if you wish, you can specify count in factory() or attributes in create()
Article::factory(100)->create();
Contact::factory(100)->create();
User::factory(100)->create();

# for Spatie Activity model
Database\Factories\ActivityFactory::new()->count(100)->create();

Tests

 Backend tests:

# run all tests
./vendor/bin/pest

# or specify group
./vendor/bin/pest --group=api

# defined tests groups:
api, article-api, contact-api, sitemap-api, user-api,
database, feature, global, unit,
commands, controllers, services, factories, migrations, models

# run all tests and check code coverage
./vendor/bin/pest --coverage

 Frontend tests:

npm run open

 Storybook:

cd storybook
yarn storybook

npm

1. Npm clean install - npm ci
2. Vite build - npm run build
3. Eslint fix - npm run lint
4. Run prettier - npm run write
5. Husky install - npm run prepare

Sitemaps

Generate XML sitemap

php artisan sitemap:generate

---

    Docker

🛠️ Installation

• First make sure u have installed latest versions of PHP, Laravel, Vue.js, Node.js, npm, Composer and Docker

• I recommend use nvm for install latest supported versions of Node.js and npm,

nvm use --lts

• Clone this repository

git clone https://github.com/SzymCode/DataManager.git

• Change .env.example file to .env in root directory

• Generate APP_KEY

php artisan key:generate

• Install modules in root directory

composer update
php artisan sail:install
sail npm install

# if you want use storybook
cd storybook
npm install

Make sure u have installed all modules!

Possible problems:

• Error: EACCES: permission denied, mkdir '/var/www/html/node_modules': sudo chmod 777 -R DataManager or Solution

🚀 Run

Root directory:

# run Docker containers in the background
sail start

# run command inside laravel.test container bash
sail npm run dev

Remember to shutdown all XAMPP processes!

Possible problems:

• Sail: no such file or directory found: Solution 1, Solution 2
• Error starting userland proxy: listen tcp4 0.0.0.0:3306: bind: address already in use: sudo service mysql stop

❓ Usage

Migrations

sail artisan migrate:fresh --seed

# Reset database by dropping all tables and then run all migrations
# --seed flag runs the database seeders after the migrations

Factories

sail tinker

# if you wish, you can specify count in factory() or attributes in create()
Article::factory(100)->create();
Contact::factory(100)->create();
User::factory(100)->create();

# for Spatie Activity model
Database\Factories\ActivityFactory::new()->count(100)->create();

Tests

 Backend tests:

# run all tests
sail pest

# or specify group
sail pest --group=api

# defined tests groups:
api, article-api, contact-api, sitemap-api, user-api,
database, feature, global, unit,
commands, controllers, services, factories, migrations, models

# run all tests and check code coverage
sail pest --coverage

 Frontend tests:

npm run open  # For now I've not configured Cypress with Docker

 Storybook - visit localhost:6006 after sail start

npm

1. Npm clean install - sail npm ci
2. Vite build - sail npm run build
3. Eslint fix - sail npm run lint
4. Run prettier - sail npm run write
5. Husky install - sail npm run prepare

Sitemaps

Generate XML sitemap

sail artisan sitemap:generate

---

  🛠️   Tech Stack

---

    Contribute

Feel free to check Project and Issues sections.
Your skills and expertise will directly contribute to the success of our project, helping us achieve our goals and create an attractive portfolio.