{"id":15103747,"url":"https://github.com/rrodrigofranco/formulamanager","last_synced_at":"2026-02-13T04:07:24.857Z","repository":{"id":253340482,"uuid":"842791833","full_name":"rrodrigofranco/FormulaManager","owner":"rrodrigofranco","description":"Este projeto consiste no desenvolvimento de um sistema de gerenciamento de fórmulas de manipulação para uma farmácia de manipulação. O sistema permitirá que os clientes solicitem fórmulas personalizadas, e cada fórmula poderá estar associada a vários ativos.","archived":false,"fork":false,"pushed_at":"2024-08-18T01:01:46.000Z","size":238,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T05:51:55.256Z","etag":null,"topics":["laravel","mysql","phpunit","swagger","testes","testes-unitarios"],"latest_commit_sha":null,"homepage":"https://www.centralfarma.com.br/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rrodrigofranco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-08-15T05:02:24.000Z","updated_at":"2024-08-18T01:01:49.000Z","dependencies_parsed_at":"2025-02-08T03:32:01.731Z","dependency_job_id":"86b2199e-349d-4dd0-a47c-9b7c3dbaaaa4","html_url":"https://github.com/rrodrigofranco/FormulaManager","commit_stats":null,"previous_names":["rrodrigofranco/formulamanager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rrodrigofranco/FormulaManager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rrodrigofranco%2FFormulaManager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rrodrigofranco%2FFormulaManager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rrodrigofranco%2FFormulaManager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rrodrigofranco%2FFormulaManager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rrodrigofranco","download_url":"https://codeload.github.com/rrodrigofranco/FormulaManager/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rrodrigofranco%2FFormulaManager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259470941,"owners_count":22862997,"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":["laravel","mysql","phpunit","swagger","testes","testes-unitarios"],"created_at":"2024-09-25T19:41:51.084Z","updated_at":"2026-02-13T04:07:24.826Z","avatar_url":"https://github.com/rrodrigofranco.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# API de Gerenciamento de Fórmulas de Manipulação\n\n## Descrição do Projeto\n\nEste projeto consiste em uma API desenvolvida para uma farmácia de manipulação, com o objetivo de gerenciar clientes, fórmulas de manipulação e os ativos utilizados nessas fórmulas. A API foi construída utilizando o framework Laravel, seguindo os princípios RESTful para garantir fácil integração e escalabilidade.\n\n### Objetivos Principais\n\n- **Gerenciamento de Dados:** A API permite o armazenamento e a manipulação de informações de clientes, fórmulas de manipulação e ativos.\n- **Processamento de Solicitações:** Implementa a lógica necessária para processar as solicitações de fórmulas feitas pelos clientes, incluindo a associação de ativos a essas fórmulas.\n- **Segurança e Eficiência:** Tratamento adequado de dados sensíveis como CPF, telefone, e nome, garantindo a segurança e a conformidade com as normas de privacidade.\n\n## Tecnologias Utilizadas\n\n- Laravel 11\n- MySQL\n- Swagger para documentação da API\n\n## Requisitos\n\n- PHP 8.x\n- Composer\n- MySQL\n\n## Instalação\n\n1. Clone o repositório:\n   \n   ```git clone https://github.com/rrodrigofranco/FormulaManager ```\u003cbr /\u003e\n   ```cd FormulaManager ```\n\n2. Instale as dependências do projeto:\n\n    ```composer install```\n\n3. Configure o arquivo .env:\n\n    ```cp .env.example .env```\u003cbr /\u003e\n    ```php artisan key:generate```\n\n4. Configure o banco de dados no arquivo .env:\n\n    ```DB_CONNECTION=mysql```\u003cbr /\u003e\n    ```DB_HOST=127.0.0.1```\u003cbr /\u003e\n    ```DB_PORT=3306```\u003cbr /\u003e\n    ```DB_DATABASE=nome_do_banco```\u003cbr /\u003e\n    ```DB_USERNAME=usuario```\u003cbr /\u003e\n    ```DB_PASSWORD=senha```\u003cbr /\u003e\n\n5. Execute as migrações:\n\n    ```php artisan migrate```\n\n6. Execute o composer:\n\n    ```composer install```\n\n## Autenticação\n\nPara acessar os endpoints da API, você precisa fornecer um token de autenticação válido. O token deve ser incluído no cabeçalho `Authorization` das suas requisições HTTP.\n\n### Criar um Usuário\n\nPara criar um novo usuário na sua aplicação, envie uma requisição POST para a rota ```/v1/auth``` com os seguintes parâmetros:\n\n**Parâmetros da Requisição:**\n\n\n```{``` \u003cbr /\u003e\n```    \"name\": \"Exemplo de Usuário\",``` \u003cbr /\u003e\n```    \"email\": \"email@exemplo.com\",``` \u003cbr /\u003e\n```    \"password\": \"senha123\",``` \u003cbr /\u003e\n```    \"password_confirmation\": \"senha123\"``` \u003cbr /\u003e\n```}``` \u003cbr /\u003e\n\nApós a criação do usuário, você receberá uma resposta contendo um token de autenticação. Esse token deve ser utilizado para autenticar suas requisições subsequentes.\n\n\n## Endpoints da API\n\n### Endpoint para Documentação\n\n- **GET /api/documentation**\n  - Acesso a documentação feita pelo swagger\n\n\n### Endpoints para Autenticação\n\n- **GET /api/v1/auth**\n  - Cria um novo usuário com um token.\n\n### Endpoints para Clientes\n\n- **GET /api/v1/clientes**\n  - Lista todos os clientes.\n\n- **POST /api/v1/clientes**\n  - Cria um novo cliente.\n  - **Parâmetros:**\n    - `nome`: string, obrigatório.\n    - `cpf`: string, obrigatório.\n    - `telefone`: string, opcional.\n\n- **GET /api/v1/clientes/{id}**\n  - Obtém detalhes de um cliente específico.\n\n- **PUT /api/v1/clientes/{id}**\n  - Atualiza as informações de um cliente específico.\n  - **Parâmetros:**\n    - `nome`: string, opcional.\n    - `cpf`: string, opcional.\n    - `telefone`: string, opcional.\n\n- **DELETE /api/v1/clientes/{id}**\n  - Exclui um cliente específico.\n\n### Endpoints para Fórmulas de Manipulação\n\n- **GET /api/v1/formulas**\n  - Lista todas as fórmulas de manipulação.\n\n- **POST /api/v1/formulas**\n  - Cria uma nova fórmula de manipulação.\n  - **Parâmetros:**\n    - `nome`: string, obrigatório.\n    - `descricao`: string, opcional.\n    - `cliente_id`: integer, obrigatório.\n\n- **GET /api/v1/formulas/{id}**\n  - Obtém detalhes de uma fórmula de manipulação específica.\n\n- **PUT /api/v1/formulas/{id}**\n  - Atualiza as informações de uma fórmula de manipulação específica.\n  - **Parâmetros:**\n    - `nome`: string, opcional.\n    - `descricao`: string, opcional.\n    - `cliente_id`: integer, opcional.\n\n- **DELETE /api/v1/formulas/{id}**\n  - Exclui uma fórmula de manipulação específica.\n\n### Endpoints para Ativos\n\n- **GET /api/v1/ativos**\n  - Lista todos os ativos.\n\n- **POST /api/v1/ativos**\n  - Adiciona um novo ativo.\n  - **Parâmetros:**\n    - `nome`: string, obrigatório.\n    - `descricao`: string, opcional.\n\n- **GET /api/v1/ativos/{id}**\n  - Obtém detalhes de um ativo específico.\n\n- **PUT /api/v1/ativos/{id}**\n  - Atualiza as informações de um ativo específico.\n  - **Parâmetros:**\n    - `nome`: string, opcional.\n    - `descricao`: string, opcional.\n\n- **DELETE /api/v1/ativos/{id}**\n  - Exclui um ativo específico.\n\n## Testes\n\nOs teste podem ser realizados através do seguinte comando: \u003cbr /\u003e\n``` php artisan test ```\n\n## Documentação da API\n\nA documentação da API foi gerada utilizando o Swagger. Para acessá-la, inicie o servidor localmente e acesse  o endpoint `/api/documentation` no seu navegador.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frrodrigofranco%2Fformulamanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frrodrigofranco%2Fformulamanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frrodrigofranco%2Fformulamanager/lists"}