What is this project?

Los Quioscos it's such an important project for me, because was my first experience with actual coding. Long story short, our final high school project was to build a functional website. My best friend and I decided to create something more community-oriented, and we ended up with an app that 'holds the meeting' between local farmers and clients. Although we put out whole hearts onto the project, the time wasn't enough and we ended with just a draft. That was almost two years ago. I've always dreamed of properly finishing the project, and 2024 would be the year when i finally do it.

The initial purpose is to build a web app (hoping to do it on 6 months), and mainly just learning everything possible. I plan to design some branding (if it's pretty would motivate me more) , and designing the necessary diagrams and user interface, all that before starting to code.

Let's start with some brainstorming

As i already said, 'Los Quioscos' it's a virtual grocery shopping platform, where a marketplace is provided for rural sellers to offer their products to both individual buyers and businesses. Taking in account this project takes place in Colombia, it's specially useful to supporting Colombian rural products, so they won't be overshadowed or forced to pay high fees just to (barely) compete with the big companies.

Who are 'Los Quioscos' users?

Quiosqueros/as: They are the ones selling the products

They have statistics for overall best-selling product, product with the highest profit, total earnings, users served, and a comparison of earnings between individual users and businesses
They can view and respond to complaints, questions, or claims about their products or services
They can have direct chats with users
They can create contracts with businesses to arrange orders for specific products (under conditions, some established by the platform, others by the kiosk owner and the business)
Their kiosk and each product have a rating
No rating is acquired until there are more than 10 people who have rated
It shows how many customers have made purchases
When users search for any product, products with higher ratings from kiosks with similarly high ratings are displayed first
Payment system should work through PSE (payment system similar to Mercado Libre «i need to research how to implement it»)
Users can comment on products (and attach photos) so that the general public can see them

Considering that these are organic products, fast delivery is crucial. For product shipping/delivery, two options are offered:
- Kiosk's means: The kiosk has its transportation, either owned or from third parties. With this type of delivery, the kiosk can decide whether to charge for shipping, if there should be a minimum purchase of x pesos for it to be free, or if it's free regardless of the quantity purchased. For this option, the package to be delivered has a QR code that is scanned, allowing users to track the package's location in real-time. Upon receiving the package, the user must confirm receipt, and payment will be processed.
- Pickup: If the business is located within a certain radius, the user can pick up the order and confirm that it has been received.
The kiosk can decide whether it wants to take on the role of a supplier (working with businesses) or not. If choosing to do so, it must register the name and ID of a legal representative, in addition to providing photos of their identification document (the legal representative of the business must also do this)

Negocio: The goal of the 'business' user is to be able to make contracts/orders in advance

They can negotiate deals (everything must be recorded in writing).

They can negotiate contracts until both parties reach a conclusion.
They can cancel contracts (both sides can do so with a minimum of 5 days' notice before any order or request).
Any changes to the contract must be made with a minimum of 5 days' notice, and it should be clarified from when the changes should be implemented.
They can design contracts, agreeing on how many and how much of a product they need, delivery dates, for how long, and who is the legal responsible party.
Every business must have a legal representative.
Agreements for shipping are to be determined between the kiosk and the business.
When shipping goods, confirmation from the kiosk that it has been sent (according to established agreements) and confirmation from the business that it has been received is always required.
The business primarily targets restaurants, private chefs, and small businesses in general that want to acquire organic products directly from the field.

Cliente: These are regular customers, whether families or individuals

Businesses inherit the characteristics of these customers

These customers make payments through the platform, can leave comments on products (it is necessary to attach photos), provide ratings to both the Kiosk and the products
They can ask questions, file complaints, and make claims.
They can purchase products
They have a history of orders placed (whether they have been canceled, rejected, or successfully delivered)
They have a settings page where they can change their personal details or delete their account
They can save multiple addresses and choose which one to use for delivery when placing an order
Receive notifications, whether about a new status of their orders, responses to questions, complaints, or claims, notifications when the order has arrived, or when it is ready for pickup, etc
They have a 'market basket' where they can save products and quantities they wish to purchase

Conclusions

Based on this basic draft, i'll proceed to organize it on a more understandable way, and later on i'll design the most necessary aspects, and go (the fastest that i can) to coding and deployment

See you guys soon! <3

new project: Los Quioscos

Table of contents