The Omaha Playground Collective is your ultimate source for all things playgrounds, parks + fun in Omaha, Nebraska. Our mission is to provide a comprehensive guide to help you discover the best recreational spaces for your family.
You'll need a Supabase and GitHub account to run this app locally. You'll also need to install Docker and Docker Compose. Node version 18.18.2 is recommended.
You'll need to clone the GitHub repo to your local machine.
You'll need to add the .env file with your DATABASE_URL, GITHUB_ID, GITHUB_SECRET, NEXTAUTH_URL, and NEXTAUTH_SECRET.
You'll need to add the following environment variables to your .env file. There is an example .env file in the root directory of the project called .env.example. You can copy this file and rename it to .env. You'll need to add your own values to the variables in the .env file.
To use the Supabase database in the app, you'll need to add the connection string to your .env file. Here is an example of what that looks like:
# .env file
DATABASE_URL=postgres://postgres:<password>@local<your_supabase_url>.host:5432/postgres- To use the app, you'll need to add the NEXTAUTH_SECRET and NEXTAUTH_URL in your .env file. You can generate a new secret on the command line with
openssl rand -base64 32Here is an example of what that looks like:
# .env file
NEXTAUTH_SECRET=<your_nextauth_secret>
NEXTAUTH_URL="http://localhost:3000"- To use Nextauth in the app, you'll need to add the Next Auth Github Provider to your .env file. Here is an example of what that looks like:
# .env file
GITHUB_ID=<your_github_id>
GITHUB_SECRET=<your_github_secret>After installation you can run the following commands to get the app up and running locally.
docker compose builddocker compose up -dTo stop the app, run the following command:
docker compose downThis project is licensed under the terms of the Creative Commons Zero v1.0 Universal.
As a parent, I want to access playground information to discover suitable options for my family.
As a parent, I want to find playgrounds for my family quickly based on criteria like appropriate options or playground surface type.
As an administrator, I want to share playground information with other parents to use.
As an administrator, I want to manage playground information to ensure it's up-to-date and accurate.
Given that I am a parent looking for playgrounds, when I access the playground information, then I should be able to view a list of playgrounds in my area with details such as location, facilities, and rating.
- The system should display a user-friendly interface for accessing playground information.
- Users should be able to easily browse and filter the list of playgrounds.
- The playground information should be categorized by location, age range, rating, and playground surfaces.
- Each playground entry should include details, including its name, address, age range, shade, and other relevant information.
Given that I am a parent finding for a playground, when I perform a filter using the predefined critera, then I should receive relevant results based on my filter options.
- The filter functionality should be easily accessible from the main interface.
- Users should be able to enter filter by such as location, age range, surface area, and ada compliance.
- The filter results should include playgrounds that match the filter criteria.
- The results should be displayed in an organized and easily readable format.
- Users should be able to click on a result to access more detailed information about the playground.
Given that I am an administrator wanting to share playground information, when I create an entry, then I should be able to publish it to the app.
- The system should provide a blog creation interface within the administrator's dashboard.
- Administrators should be able to input relevant information about the playground, including its name, location, facilities, and any additional useful details.
- Administrators should be able to format and structure the blog post, including adding text, images, and links.
- Once the blog post is created, administrators should be able to publish it.
- The published blog post should be accessible to other parents using the application
Given that I am an administrator responsible for managing playground information, when I update playground details, then the changes should be reflected in the app, and the information should remain accurate.
- The platform should provide an interface for administrators to edit, update, and delete playground information.
- After making changes, the updated information should be displayed or removed from the application.
- Users accessing the platform should see the most recent, active, and accurate playground details.
- Any changes made by administrators should be tracked and documented for reference.
As a hacker, I want to exploit vulnerabilities in the search feature to gain unauthorized access to the backend system.
As an administrator, I accidentally delete or update playground information to provide incorrect details.
- Regularly conduct security assessments, including penetration testing and vulnerability using tools such as OWASP ZAP and SonarQube.
- Implement strong access controls and authentication mechanisms to prevent unauthorized access to data.
- Maintain audit logs to capture details of access attempts, user activities, and system changes.
- Implement a content log that records all changes made by administrators, making it possible to track and reverse unauthorized modifications.
- Maintain a robust data recovery and backup system to ensure that data can be restored in the event of accidental deletion or modification.
