README

Survloop，位于 Laravel 之上。Survloop 是一个基于 Laravel 的引擎，用于设计数据库并创建一个适合移动端的用户界面来填充数据。

目录

• 要求
• 入门
• 文档
• 路线图
• 变更日志
• 贡献指南

要求

• php: >=7.4
• laravel/framework: 8.0.*
• rockhopsoft/survloop: 0.2.*

入门

使用 Laradock 安装 Survloop.org

首先，在 Mac、Windows 或在线服务器上 安装 Docker。然后获取 Laravel 的一个副本（最新测试版本为 v5.8.3）...

$ git clone https://github.com/laravel/laravel.git survlooporg
$ cd survlooporg

接下来，安装并启动 Laradock（最新测试版本为 v7.14）。

$ git submodule add https://github.com/Laradock/laradock.git
$ cd laradock
$ cp env-example .env
$ docker-compose up -d nginx mysql phpmyadmin redis workspace

在 Docker 容器启动完成后，使用 root 密码 "root" 进入 mysql 容器。这似乎可以解决最新版本的 MYSQL 的问题。

$ docker-compose exec mysql bash
# mysql --user=root --password=root default
mysql> ALTER USER 'default'@'%' IDENTIFIED WITH mysql_native_password BY 'secret';
mysql> exit;
$ exit

此时，您可以浏览到 https://:8080 以访问 PhpMyAdmin。

Server: mysql
Username: default
Password: secret

最后，进入 Laradock 的工作空间容器并安装 Survloop.org。

$ docker-compose exec workspace bash
# cp .env.example .env
# nano .env

编辑 Laravel 环境文件中的这几行

DB_HOST=mysql
DB_DATABASE=default
DB_USERNAME=default

然后继续安装...

# composer install
# php artisan key:generate
# php artisan make:auth
# composer require rockhopsoft/survlooporg
# echo "0" | php artisan vendor:publish --force
# composer dump-autoload
# php artisan optimize
# sed -i 's/App\\User::class/App\\Models\\User::class/g' config/auth.php
# php artisan migrate
# php artisan optimize
# composer dump-autoload
# php artisan db:seed --class=SurvloopSeeder
# php artisan db:seed --class=SurvloopOrgSeeder

如果一切顺利，当您浏览到 https:/// 时，您将被要求创建一个主管理员用户帐户。如果它已加载，但看起来很糟糕（没有 CSS），请重新加载页面一次...希望它看起来像一个新的安装。

不使用 Laradock 安装 Survloop.org

• 使用 Composer 安装带有默认用户认证的 Laravel，一个必需的包

$ composer global require "laravel/installer"
$ composer create-project laravel/laravel survlooporg "8.0.*"
$ cd survlooporg
$ php artisan key:generate
$ php artisan make:auth
$ composer require rockhopsoft/survlooporg
$ sed -i 's/App\\User::class/App\\Models\\User::class/g' config/auth.php

• 更新 composer，发布包迁移等...

$ echo "0" | php artisan vendor:publish --force
$ php artisan migrate
$ composer dump-autoload
$ php artisan db:seed --class=SurvloopSeeder
$ php artisan db:seed --class=SurvloopOrgSeeder

• 目前，要应用数据库设计更改到您正在工作的同一安装，根据您的服务器，您可能还需要类似以下内容...

$ chown -R www-data:33 app/Models
$ chown -R www-data:33 database

• 在浏览器中加载以创建超级管理员帐户并开始使用。

文档

安装后，该系统数据库设计的文档可在 /dashboard/db/all 找到。该系统的数据录入用户体验设计可在 /dashboard/tree/map?all=1&alt=1 找到。

更多信息可在 https://survloop.org/package-files-folders-classes 找到。

路线图

以下是下一个版本（1.0）的 TODO 列表。这是我第一次在 Laravel 或 GitHub 上构建。所以对不起。

• 完成各种 Survloop 安装的统计信息
• 代码注释、学习和实施更多社区标准。

变更日志

贡献指南

请帮助我了解在这个社区中共享代码的最佳实践。请在问题页面上报告您发现的任何问题。