Phantom66 / sistemaPCI

proyecto 3, trayecto 3, informatica.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

sistemaPCI

Build Status Scrutinizer Code Quality Code Climate Codacy Badge

Sistema de Gestion de Inventario Para la Division de Rehabilitacion Ocupacional.

Misión Alma Mater, Programa Nacional de Formación: Informatica, Trayecto 3, IUTOMS.

  • v0.1 Usuario
  • v0.2 Empleado
  • v0.3 Almacen
  • v0.3.x Item
  • v0.3.x Otros
  • v0.4 Pedidos
  • v0.4.x Notas
  • v0.5 Carpinteria

Ver Bitacora

Ver KanBan

Indice

Documentacion

Dentro de este repositorio existen archivos complementarios que ayudaran en la documentacion del mismo, estos son:

CHANGELOG.md, DATASTRUC.md, DEDCHANGE.md y TODO.md.

Instalacion Rapida

git clone https://github.com/slayerfat/sistemaPCI sistemaPCI 

chmod u+x sistemaPCI/caimanismo.sh 

./sistemaPCI/caimanismo.sh

Dependencias del Sistema

Para poder usar el software adecuadamente, es necesario instalar los siguientes paquetes de sofware y sus dependencias expresadas a continuacion.

NOTA: una vez completado los pasos necesarios para instalar las dependencias, es necesario ejecutar gulp en el directorio del sistema, ej: ~/sistemaPCI/src/$ gulp

Node

Para usar este repositorio es necesario tener instalado en el sistema node.js.

Para chequear que node esta instalado en tu sistema debes hacer un node -v en consola, el sistema dira vX.YY.* luego chequear que npm (node package manager) este en el sistema con un npm -v en consola.

Bower

Una vez instalado Node: npm install --global bower y luego ejecutar bower install para instalar dependencias adicionales.

Composer

Tambien es necesario instalar composer.

curl -sS https://getcomposer.org/installer │ php
mv composer.phar /usr/local/bin/composer
  • si falla pueden sudo !!
  • si falla porque no tienen curl
php -r "readfile('https://getcomposer.org/installer');" │ php
mv composer.phar /usr/local/bin/composer

Chequear que este instalado composer -V el sistema dira

Composer version 1.0.-* (...) fecha

si algo falla, chequear la documentacion de composer

Obtener las dependecias del sistema

Desde la carpeta clonada:

composer install

sistemaPCI/src/:

npm install si hace asi por el cambio de la estructura de archivos.

Si composer se queja sobre mcrypt o mysql es probable que no tengan los modulos correspondentes activados/instalados.

Para ello deberan:

sudo apt-get install php5-mcrypt

sudo apt-get install php5-mysql

sudo apt-get install php5-gd

Es de suma importancia chequear capacidad de rewrite si se pretende usar apache:

para usar links amigables es necesario configurar apache u otro servidor:

El framework viene con un archivo public/.htaccess que se utiliza para permitir URLs sin index.php.

Si utilizas Apache para servir tu aplicación Laravel, asegúrate de activar el módulo mod_rewrite. Si el archivo .htaccess que viene con Laravel no funciona con tu instalación de Apache, prueba con éste:

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

solucion sencilla: sudo a2enmod rewrite

solucion complicada: este enlace es de ayuda

Si usan xampp, wampp, lampp, deberan referirse a la documentacion de php para esos paquetes, puesto que, si falla composer, es muy probable que sea debido a los binarios de PHP utilizados por su computadora.

Otra opcion es copiar el archivo de composer.phar a donde estan los archivos de php de xampp.

google es tu aliado

Si todo sale bien, debera generar las carpetas vendor/ y node_modules/ en donde estaran las dependecias.

Sobre las dependencias

Es importante destacar que cada branch puede tener diferentes dependencias, lo que implica hacer installs adicionales segun el branch.

Gulp

antes de ejecutar gulp es necesario instalar Bower! npm install --global bower y luego ejecutar bower install para instalar dependencias adicionales.

Se puede ejecutar simplemente gulp (dentro de la carpeta src) para copiar y compilar sass y otros archivos a la carpeta publica del sistema.

NOTA: verificar que tengan gulp instalado antes de ejecutar

se vera:

[21:43:07] Using gulpfile ~/sistemaPCI/src/gulpfile.js
[21:43:07] Starting 'default'...
[21:43:07] Starting 'sass'...
[21:43:09] Finished 'default' after 2.05 s
[21:43:11] gulp-notify: [Laravel Elixir]
[21:43:11] Finished 'sass' after 3.79 s
[21:43:11] Starting 'copy'...
[21:43:11] Finished 'copy' after 159 ms

Tambien pueden hacer un gulp watch para autocompilar scss (sass).

Permisos

Es necesario cambiar los permisos en algunas carpetas del sistema, esto se debe a que Laravel necesta escribir sus logs y necesita compilar ciertas cosas.

Se debe otorgar la escritura a laravel en estos directorios:

~/sistemaPCI/src/storage
~/sistemaPCI/src/bootstrap

la forma mas facil es: chmod go+w -R src/storage && chmod go+w -R src/bootstrap

Si se quieren poner exoticos con los permisos, o cambiar el dueño de las carpetas en el sistema operativo, lo pueden hacer.

Base de datos

Para instalar la base de datos en el sistema necesitan el archivo .env con la informacion de la base de datos.

En este archivo estan las variables usadas por mysql.

APP_ENV=local
APP_DEBUG=true
APP_KEY=SomeRandomStringOf32CharOfLenght

APP_USER=SEUDONIMO_TAL...
APP_USER_EMAIL=CORREO_TAL...
APP_USER_PASSWORD=CLAVE_TAL...
APP_USERS_PASSWORD=CLAVE_TAL...

DB_HOST=localhost
DB_DATABASE=sistemaPCI
DB_USERNAME=homestead
DB_PASSWORD=secret

CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync

MAIL_DRIVER=smtp
MAIL_HOST=mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

se hace de esta forma para mantener las claves seguras, etc, el pito y la guacharaca.

cuando tengan el archivo pueden hacer un simple:

php src/artisan migrate

y luego: php src/artisan db:seed --class="PCI\Database\DatabaseSeeder"

si por alguna razon eso falla, pueden hacer un

php src/artisan migrate:reset && php src/artisan migrate && php src/artisan db:seed --class="PCI\Database\DatabaseSeeder"

y listo, la base de datos esta localmente en el sistema.

Si falla pueden hacer un composer dump-autoload y reintentarlo, si vuelve a falla puden crear un problema (issue) en github con el error y la descripcion del mismo.

Migraciones

php src/artisan migrate:reset && php src/artisan migrate && php src/artisan db:seed --class="PCI\Database\DatabaseSeeder"

Homestead

El sistema funciona por medio de Homestead o por medio de apache/nginx u otro.

~/sistemaPCI/$ vagrant up

ver: ~/sistemaPCI/Homestead.yaml

Arbol de directorios simplificado

sistemaPCI
    ├── public
    │   ├── js y otros
    │   ├── css
    │   ├── vendor
    │   │   └── [Gulp clones] <- dependencias
    │   └── [los archivos al publico]
    └── src
        ├── app
        │   ├── Http
        │   │   ├── Controllers
        │   │   │   └── [Los Controladores]
        │   │   ├── Middleware
        │   │   │   └── [Las Autentificaciones y otros]
        │   │   ├── Requests
        │   │   │   └── [las Validaciones]
        │   │   └── [El Router]
        │   ├── Models
        │   │   └── [Los Modelos]
        │   └── Repositories
        │       └── [Los Repositorios]
        ├── config
        │   └── [La configuracion del sistema]
        ├── database
        │   ├── migrations (la base de datos)
        │   └── seeds (los datos)
        ├── node_modules
        │   └── [Dependencias en NPM]
        ├── resources
        │   ├── assets
        │   │   └── [sass, js y otros]
        │   ├── lang
        │   │   ├── es (traduccion completa)
        │   │   └── en (mensajes originales)
        │   └── views
        │       └── [Las Vistas]
        ├── storage
        │   └── logs (errores)
        ├── tests
        │   └── PCI
        |       ├── Models
        |       └── ...
        └── vendor
            └── [Dependencias en Composer]

PHP3D Technology Required

PARA PODER MANIPULAR EL CODIGO FUENTE ES NECESARIO INSTALAR LA LIBRERIA PHP3D Y TENER AL MOMENTO DE MANIPULACION LOS LENTES ESPECIALES ADAPTADOS EN 3D PARA ESTA GLORIOSA LABOR.

ESTE CODIGO ESTA IMPLEMENTADO EN LOS TRES EJES ESPACIALES PRODUCIDOS EN PHP3D.

PHP3D

ADVERTENCIA: ESTE COGIDO FUENTE GENERA MIGRAÑA

Caimaneitor::caimanais()

Se creo un mega comando por medio de Caimaneitor se puede usar directamente en artisan con: php src/artisan inspirar.

Tambien puede ser incluido en el sistema por medio de:

<?php

use PCI\Mamarrachismo\Caimaneitor\Caimaneitor;

echo Caimaneitor::caimanais();

tambien posee su Facade:

<?php

echo Caimaneitor::caimanais();

o por medio de blade: {{ Caimaneitor::caimanais() }}

Esta compleja implementacion fue inspirada por la inspiradora Inspire: Inspired by Illuminate\Foundation\Inspiring

Situacion Bio-Psico-Social

@slayerfat:

@slayerfat

@Phantom66:

@Phantom66

@githubbt:

@githubbt

Laravel PHP Framework

Este sistema usa el framework Laravel de PHP documentacion

El framework Laravel es software codigo-abierto bajo MIT

Contribuciones al Repositorio

  1. Forkealo
  2. Crea tu branch aleatorio (git checkout -b mejoras-necesarias-e-importantes)
  3. Commit tus cambios (git commit -am 'Estos son mis cambios!')
  4. Push to the branch (git push origin mejoras-necesarias-e-importantes)
  5. Crear nuevo Pull Request en Github

About

proyecto 3, trayecto 3, informatica.


Languages

Language:PHP 97.8%Language:JavaScript 1.1%Language:CSS 0.8%Language:Shell 0.2%Language:ApacheConf 0.0%