This application (called 🌱 Rolnopol) was prepared and developed only for testing purposes. It provides:

• A graphical user interface (GUI)
• REST API
• Integrated Swagger documentation

The application includes features such as logic, resource management, authorization, statistics and charts. It is intentionally designed with deliberately bugs🐛 and challenges to simulate real-world project complexities.

🌱 Rolnopol is ideal for learning test automation, refining QA techniques, and practicing with scenarios encountered in diverse, real-world projects with diverse real-world scenarios.

• Introduction
• Features
• Deployment
• Contact & Support

🌱 Rolnopol is a realistic farming management application built specifically for practicing test automation in a real-world domain. It simulates complex business workflows while providing an architecture perfect for testing various automation scenarios.

• Express.js Framework with modular middleware (authentication, rate limiting, logging)
• Versioned REST APIs (v1/v2) for testing API evolution and compatibility
• JSON File Database for easy data manipulation and test state control
• Layered Architecture: routes → controllers → services → data access

• Authentication & Authorization: tokens, role-based access, session management
• API Testing: CRUD operations, data validation, error handling, rate limiting
• Business Logic: Financial transactions, marketplace workflows, resource management
• UI & Integration: Web interfaces, real-time updates, end-to-end workflows

• Agricultural Business: Farm management, livestock operations, staff coordination
• Financial Operations: Digital banking, payment systems, financial reporting
• Data Processing: Weather integration, performance metrics, analytics

• Intentional Bugs for debugging and error handling practice
• Edge Cases requiring thorough test coverage
• Progressive Difficulty from basic CRUD to complex workflows
• Real-world Scenarios simulating production application behavior

This architecture provides a perfect playground for practicing modern test automation techniques while working with realistic business domains and complex system interactions.

Instructions how to deploy presented service to various free hosting sites.

• Deploy to Local (recommended)
• Deploy using Docker image

Requirements:

• node.js https://nodejs.org/ - installed in the system -
  • tested on node.js v22 and v24
• git https://git-scm.com/ - installed in the system

Steps:

1. Open the project root directory in cmd/terminal
2. Clone the repository using git clone ...
   • this is the preferred way to use this application
3. Run npm i
   • to install modules (don't use node.js global packages!)
4. Run npm run start
   • to start 🌱 Rolnopol

The application will be available at http://localhost:3000

For convenience, the project includes several scripts to start the application in different environments. These scripts automatically navigate to the project root and keep the terminal window open if the application stops or crashes.

• Windows (CMD): Run start.bat
• PowerShell: Run .\start.ps1
• Linux/macOS (Bash): Run ./start.sh
• Linux/macOS (Zsh): Run ./start.zsh

For more details, see START_SCRIPTS.md.

For testing and demonstration purposes, the application includes several pre-configured demo users. You can use these credentials to explore different features:

Note: These are demo credentials for local development and testing only. Passwords are stored in plain text for easier testing and account management.

Steps:

1. Download zipped repository
2. Unzip and replace Your local instance of 🌱 Rolnopol
3. Run npm i in root directory
   • to install new modules
4. Run npm run start
   • to start 🌱 Rolnopol

Steps:

1. Open the project root directory in cmd/terminal
2. Pull latest changes using git pull
3. Run npm i
   • to install new modules
4. Run npm run start
   • to start 🌱 Rolnopol

One possibility is to reset all Your local changes and pull new version.Using this method You will lose all Your local changes and data!

Steps:

1. Open the project root directory in cmd/terminal
2. Reset local changes and pull latest changes using:

   git reset --hard HEAD
   git pull
   

3. Run npm i
   • to install new modules
4. Run npm run start
   • to start 🌱 Rolnopol

Render - a popular Heroku-like PaaS with a free tier and a “Deploy to Render” button for one-click deploys.

• Create free account on: https://dashboard.render.com/register
• After successful registration hit the button:

• name your app
• hit Apply
• wait a while and click link to project Rolnopol
• click link to open app (under project name and repository)
• enjoy 750 free hours of service per month

When deploying the 🌱 Rolnopol application on Render, please be aware that the application may not function fully due to the limitations of the Render platform. However, we are making every effort to ensure the highest possible compatibility.

This method can be used:

• locally
• in CI/CD services (GitHub Actions, GitLab CI etc.)

On local environment:

• latest Docker is installed

Just run following command to get latest image:

docker run -p 3000:3000 -d jaktestowac/rolnopol

or specific version:

docker run -p 3000:3000 -d jaktestowac/rolnopol:1.0.24

Application should be running under http://localhost:3000/

Images are available at: 🐋 https://hub.docker.com/r/jaktestowac/rolnopol

We hope you'll have a great time testing and automating this application!

The challenges and features included are designed to help you grow your testing skills while having fun.

If you have any ideas for improvements or encounter any issues, please don't hesitate to open an issue on our GitHub repository.

Your feedback helps make 🌱 Rolnopol better for everyone!

📢 Looking forward to your contributions and happy testing!

🔝 Back to top

Feel free to reach out to us:

• 🌐 Website: jaktestowac.pl
• 💼 LinkedIn: jaktestowac.pl
• 💬 Discord: Polish Playwright Community
• 📧 Support: Check our website for contact details

We have gathered a collection of resources to help you learn and master Playwright, both in Polish and English. Whether you're a beginner or an advanced user, these resources will help you enhance your skills and knowledge.

• JavaScript and TypeScript for Testers - Comprehensive (13h+) course on JavaScript and TypeScript for testers, with practical examples and exercises
• Professional Test Automation with Playwright - Comprehensive (100h+) course on Playwright, test automation, CI/CD and test architecture
• Back-end Test Automation - Comprehensive (45h+) course on Back-end Test Automation with Postman, Mocha, Chai, and Supertest
• Free Playwright Resources - Comprehensive and Free Polish learning materials
• Playwright Basics - YouTube series (Polish)
• Playwright Elements - Advanced concepts (Polish)
• Playwright MCP - MCP course (Polish)
• Discord Community - First Polish Playwright community!
• Playwright Info - first and only Polish Playwright blog

• VS Code Extensions - Our free Playwright plugins

Gain an edge by combining AI knowledge with the most popular tools in the IT market.
We'll show you how to accelerate with AI and build a professional test automation framework. 😉

• AI_Testers - Main page about AI_Testers Program
• AI_Testers LinkedIn - Follow us on LinkedIn

Happy testing and automation! 🚀

jaktestowac.pl Team ❤️💚

PS. For more resources and updates, follow us on our website and GitHub.

Built with ❤️💚 for the Playwright and test automation community