fix folders and add requests

Author: leodisarli

README.md

@@ -49,9 +49,14 @@ Run [Composer](https://getcomposer.org/) to install all dependencies.
 composer install --prefer-dist
 ```
 
-Ensure the folder ./storage are with all rights to save log and cache (alread set in composer install, but ...)
+Ensure the composer install create the cache folders and give then permissions in ./storage, if don't you'll have to create and give permitions yourself:
 ```sh
-chmod -R 777 ./storage
+mkdir storage/framework \
+&& mkdir storage/framework/cache \
+&& mkdir storage/framework/cache/data \
+&& mkdir storage/framework/sessions \
+&& mkdir storage/framework/views \
+&& chmod -R 777 ./storage
 ```
 
 To check the build for this project look at ./ops/docker/dev folder.
@@ -76,12 +81,6 @@ Now you can access the health-check [http://localhost:8101](http://localhost:810
 }
 ```
 
-### Requests samples
-
-You can find a sample of requests you can do in the file `requests.http` (for the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension on VSCode) or using curl commands listed in the file `requests.curl`.
-
-Not all requests are documented yet (Work in progress)
-
 ### Creating your automatic crud domain
 
 For create your brand new domain with a complete crud use the command:
@@ -111,6 +110,38 @@ This command will create a folder in `app/Domains`, new files in `routes`, `data
 php artisan migration
 ```
 
+### Requests samples
+
+Within the `/ops/requests` folder, you'll discover a collection of sample requests showcasing.
+
+Requests have been meticulously documented in three different formats for your convenience:
+
+1. Postman Collections
+
+Files: `postman_collection.json` and `postman_environments.json`
+
+Tool: Postman
+
+These collections provide a comprehensive overview of the available API requests. Import them into Postman to explore and execute requests seamlessly.
+
+
+2. Visual Studio Code (VSCode) REST Client Extension:
+
+File: `requests.http`
+
+Extension: [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client)
+
+With the extension installed in VSCode open the `requests.http` file. This extension allows you to send HTTP requests directly from your code editor, making it easy to interact with the API.
+
+
+3. CURL Commands:
+
+File: `requests.curl`
+
+For those who prefer the command line, CURL commands are provided in the `requests.curl` file. Execute these commands in your terminal to interact with the API using the widely-used CURL tool.
+
+Choose the documentation format that aligns with your preferred workflow and start seamlessly interacting with the API.
+
 ### Ulid
 
 For primary key value, this project using [Ulid](https://github.com/not-empty/ulid-php-lib) value, but you can pass other pattern in insert route if you prefer.

composer.json

@@ -35,7 +35,7 @@
     },
     "scripts": {
         "post-install-cmd": [
-            "chmod -R 777 storage"
+            "./ops/folders.sh"
         ],
         "checkall" : [
             "@lint",

ops/docker/prod/php-fpm/Dockerfile

@@ -24,7 +24,6 @@ RUN tar -xvf /usr/src/newrelic-php5-9.21.0.311-linux.tar.gz -C /usr/src && \
 
 COPY . /var/www/html
 
-
 WORKDIR /var/www/html
 
 EXPOSE 9000

ops/folders.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+DIR1="storage/framework"
+DIR2="storage/framework/cache"
+DIR3="storage/framework/cache/data"
+DIR4="storage/framework/sessions"
+DIR5="storage/framework/views"
+
+
+if [ ! -d "$DIR1" ]; then
+    mkdir "$DIR1"
+    echo "folder $DIR1 created"
+fi
+if [ ! -d "$DIR2" ]; then
+    mkdir "$DIR2"
+    echo "folder $DIR2 created"
+fi
+if [ ! -d "$DIR3" ]; then
+    mkdir "$DIR3"
+    echo "folder $DIR3 created"
+fi
+if [ ! -d "$DIR4" ]; then
+    mkdir "$DIR4"
+    echo "folder $DIR4 created"
+fi
+if [ ! -d "$DIR5" ]; then
+    mkdir "$DIR5"
+    echo "folder $DIR5 created"
+fi
+
+chmod -R 777 storage
+echo "permissions set on storage"