{"id":28916277,"url":"https://github.com/elmarcelfarias/pontoapi-laravel10","last_synced_at":"2026-05-08T05:06:05.603Z","repository":{"id":298798344,"uuid":"1001134982","full_name":"ElMarcelFarias/pontoapi-laravel10","owner":"ElMarcelFarias","description":"PontoAPI - Sistema de Registro de Ponto com Laravel 10: API RESTful para gerenciamento de registro de ponto de funcionários, desenvolvida com Laravel 10, JWT Authentication, MySQL e Redis. Permite autenticação segura, controle de horários por jornada, geração de relatórios em PDF e gerenciamento de usuários com permissões.","archived":false,"fork":false,"pushed_at":"2025-06-21T18:48:54.000Z","size":174,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-21T19:35:53.779Z","etag":null,"topics":["api","api-rest","authentication","docker","dompdf","jwt-authentication","mysql","pdf","php8","redis","rest"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ElMarcelFarias.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T22:03:19.000Z","updated_at":"2025-06-21T18:48:57.000Z","dependencies_parsed_at":"2025-06-13T01:28:41.646Z","dependency_job_id":"fbb838f7-48b0-4f07-8b18-1d6f96ba999f","html_url":"https://github.com/ElMarcelFarias/pontoapi-laravel10","commit_stats":null,"previous_names":["elmarcelfarias/pontoapi-laravel10"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ElMarcelFarias/pontoapi-laravel10","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElMarcelFarias%2Fpontoapi-laravel10","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElMarcelFarias%2Fpontoapi-laravel10/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElMarcelFarias%2Fpontoapi-laravel10/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElMarcelFarias%2Fpontoapi-laravel10/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ElMarcelFarias","download_url":"https://codeload.github.com/ElMarcelFarias/pontoapi-laravel10/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElMarcelFarias%2Fpontoapi-laravel10/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261211570,"owners_count":23125537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-rest","authentication","docker","dompdf","jwt-authentication","mysql","pdf","php8","redis","rest"],"created_at":"2025-06-21T23:30:38.203Z","updated_at":"2026-05-08T05:06:05.595Z","avatar_url":"https://github.com/ElMarcelFarias.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Ponto API\n### Passo a passo\nClone Repositório\n```sh\ngit clone https://github.com/ElMarcelFarias/pontoapi-laravel10\n```\n```sh\ncd pontoapi-laravel10\n```\n\n\nCrie o Arquivo .env\n```sh\ncp .env.example .env\n```\n\n\nAtualize as variáveis de ambiente do arquivo .env\n```dosini\nAPP_NAME=\"pontoapi\"\nAPP_URL=http://localhost:8989\n\nDB_CONNECTION=mysql\nDB_HOST=db\nDB_PORT=3306\nDB_DATABASE=pontoapi\nDB_USERNAME=root\nDB_PASSWORD=root\n\nCACHE_DRIVER=redis\nQUEUE_CONNECTION=redis\nSESSION_DRIVER=redis\n\nREDIS_HOST=redis\nREDIS_PASSWORD=null\nREDIS_PORT=6379\n```\n\n\nSuba os containers do projeto\n```sh\ndocker-compose up -d\n```\n\n\nAcesse o container app\n```sh\ndocker-compose exec app bash\n```\n\n\nInstale as dependências do projeto\n```sh\ncomposer install\n```\n\nJWT Authentication (Instale o pacote JWT)\n```sh\ncomposer require tymon/jwt-auth\n```\n\nPublique a configuração\n```sh\nphp artisan vendor:publish --provider=\"Tymon\\JWTAuth\\Providers\\LaravelServiceProvider\"\n```\n\nGere o secret JWT\n```sh\nphp artisan jwt:secret\n```\n\nGeração de PDF (Instale o DomPDF)\n```sh\ncomposer require barryvdh/laravel-dompdf\n```\n\nCrie o link do storage\n```sh\nphp artisan storage:link\n```\n\nRode as migrations para construir as tabelas no BD\n```sh\nphp artisan migrate\n```\n\nCrie a pasta para relatórios PDF\n```sh\nmkdir exports\nchmod -R 775 exports\n```\n\nAcesse a API\n[http://localhost:8989](http://localhost:8989)\n\nRequisitos \n* Laravel 10\n* PHP 8.1\n* MySQL 5.7+\n* Redis\n* JWT.\n\nAs rotas da API estão documentadas em documentacao_rotas_api.\n[Documentação da API](https://github.com/ElMarcelFarias/pontoapi-laravel10/blob/master/documentacao_rotas_api.md)\n\nDocumentacao das rotas com Swagger\n\n```sh\ndocker pull docker.swagger.io/swaggerapi/swagger-ui\n```\n\nSubir o container:\n\n```sh\ndocker run -p 90:8080 -e SWAGGER_JSON=/tmp/openapi-resolved.json -v $(pwd):/tmp docker.swagger.io/swaggerapi/swagger-ui\n```\n\nAcesse em [Documentacao Swagger](http://localhost:90/)\n\nPara acessar as rotas protegidas, envie o header:\n\n```sh\nAuthorization: Bearer \u003cseu_token_jwt\u003e\n```\n\nGere a key do projeto Laravel\n```sh\nphp artisan key:generate\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felmarcelfarias%2Fpontoapi-laravel10","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felmarcelfarias%2Fpontoapi-laravel10","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felmarcelfarias%2Fpontoapi-laravel10/lists"}