{"id":20463335,"url":"https://github.com/fflch/minibib","last_synced_at":"2025-04-13T08:10:39.866Z","repository":{"id":38304465,"uuid":"277837980","full_name":"fflch/minibib","owner":"fflch","description":"Controle de pequenos acervos e empréstimos","archived":false,"fork":false,"pushed_at":"2024-09-20T18:24:44.000Z","size":448,"stargazers_count":1,"open_issues_count":2,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-27T00:04:52.147Z","etag":null,"topics":["hacktoberfest","hacktoberfest-accepted"],"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/fflch.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}},"created_at":"2020-07-07T14:23:50.000Z","updated_at":"2025-01-21T03:44:57.000Z","dependencies_parsed_at":"2024-09-06T22:27:12.075Z","dependency_job_id":null,"html_url":"https://github.com/fflch/minibib","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fflch%2Fminibib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fflch%2Fminibib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fflch%2Fminibib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fflch%2Fminibib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fflch","download_url":"https://codeload.github.com/fflch/minibib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681491,"owners_count":21144700,"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":["hacktoberfest","hacktoberfest-accepted"],"created_at":"2024-11-15T13:10:36.888Z","updated_at":"2025-04-13T08:10:39.838Z","avatar_url":"https://github.com/fflch.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003eSobre o sistema\u003c/h1\u003e\nO sistema, baseado em CRUD, é fundamentado em 3 relações:\n\n- Acervo de Material (Records)\n- Tombo dos Exemplares (Instances)\n- Empréstimos Registrados (Um exemplar para um usuário)\n\nO acervo pode ser utilizado para consulta online, além de servir como sistema interno de empréstimos na biblioteca, com base no tombo/localização do exemplar.\n\n\u003ch1\u003eComo usar\u003c/h1\u003e\n\u003ch2\u003ePrimeros passos\u003c/h2\u003e\n\nPara pode ter acesso às ações de administrador do sistema na sua máquina, vá ao arquivo .env e, caso não haja uma variável \"ADMINS=\" acrescente-a e, nela, insira seu número USP.\nPara que o sistema reconheça como um Número USP válido, é necessário que você possua o valor das variáveis:\u003cbr/\u003e\u003cbr/\u003e\n\u003cb\u003e\nREPLICADO_HOST\u003cbr /\u003e\nREPLICADO_PORT\u003cbr /\u003e\nREPLICADO_DATABASE\u003cbr /\u003e\nREPLICADO_USERNAME\u003cbr /\u003e\nREPLICADO_PASSWORD\u003cbr /\u003e\nREPLICADO_CODUNDCLG\u003cbr /\u003e\nREPLICADO_SYBASE\u003cbr /\u003e\nSENHAUNICA_KEY\u003cbr /\u003e\nSENHAUNICA_SECRET\u003cbr /\u003e\nSENHAUNICA_CALLBACK_ID\u003cbr /\u003e\n\u003c/b\u003e\nno seu arquivo .env.\n\u003cbr /\u003e\n\u003ch3\u003eADMIN\u003c/h3\u003e\nPara ter, enfim, as ações e permissões do administrador do sistema, logue-se.\n\u003ch1\u003eCadastramento de exemplares\u003c/h1\u003e\nO sistema permite, aos administradores logados nesse sistema via Senha Única, o cadastramento e manuseio de materiais para o acervo da biblioteca. Para cadastrar um exemplar, os administradores preenchem um formulário com as principais informações do material.\u003cbr /\u003e Uma vez criados, os materiais ficam listados na página principal. Nela, há um campo de busca por título, autor e tombo. \u003cbr/\u003e Cada material permite ações como edição, visualização detalhada do material e o registro de um exemplar com seu tombo e localização.\n\n\u003ch1\u003eImportação de vários exemplares que estejam em um CSV\u003c/h1\u003e\n\nEsta ação cadastra automaticamente no sistema vários exemplares de livros com um comando realizado no terminal (dezenas de milhares de exemplares, até onde foi testado):\n\nPara importação de materiais que estejam em um arquivo CSV, é necessário que os exemplares contenham os campos \"autores\",\"titulo\" e \"tipo\" e estejam todos preenchidos obrigatoriamente.\n\u003eATENÇÃO: é de extrema importância verificar se o nome dos campos do CSV estão idênticos ao nome dos campos da Base de Dados;\n\n\u003eno arquivo \"ImportCsv.php\", localizado pasta app/Console/Commands, é necessário mudar somente o diretório onde o arquivo CSV se encontra\n\n\u003ecaso teu arquivo haja mais campos do que os que hajam na function handle(), será necessário cadastrar manualmente, seguindo como exemplo o código.\n\n\u003eapós verificada a primeira etapa e realizada a segunda, abra o terminal, no diretório que se encontra o projeto Minibib, dê o comando 'php artisan import-csv', e espere até que a importação seja realizada.\n\n\u003ch1\u003eInstances\u003c/h1\u003e\nOs exemplares (instances) registram a localização física na biblioteca e tombo do material (record), os respectivos exemplares de cada material ficam listados na página principal. Dessa forma, a página principal serve como consulta online para o público, e controle interno para os funcionários como o de permitir sua edição e emprestar o exemplar. \n\n\u003ch1\u003eEmpréstimos\u003c/h1\u003e\nO empréstimo associa o exemplar (ID do material) ao aluno pelo seu Nº USP.\n\nOs empréstimos ativos são listados em uma página secundária, com informações básicas como título do material, nome do aluno e botão para devolução. Os dias são contabilizados com base na data de empréstimo, a data de devolução é preenchida ao confirmar a devolução do material pelo funcionário responsável. Dessa forma, no banco de dados ficam registrados as datas de empréstimo/devolução, o ID do exemplar, ID do funcionário e o número USP do aluno. \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffflch%2Fminibib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffflch%2Fminibib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffflch%2Fminibib/lists"}