https://github.com/felipefma/market
market
https://github.com/felipefma/market
Last synced: 4 months ago
JSON representation
market
- Host: GitHub
- URL: https://github.com/felipefma/market
- Owner: FelipeFMA
- License: mit
- Created: 2025-03-05T23:01:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-13T00:53:02.000Z (about 1 year ago)
- Last Synced: 2025-04-05T14:20:31.130Z (about 1 year ago)
- Language: JavaScript
- Size: 1020 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ๐๏ธ Online Market Project
## ๐ Overview
A simple yet functional online market system with customer and admin interfaces. This project was created for learning purposes and to explore web development concepts in a practical way.
## ๐ฏ Purpose
- Learning project to understand JavaScript, HTML, and CSS
- Experimenting with client-server architecture
- Understanding state management and DOM manipulation
- Practice working with APIs and data persistence
## ๐ Features
### Customer Interface
- Browse products
- Add items to cart
- Real-time price calculation
- Search functionality
- Dark/Light theme toggle
### Admin Interface
- Add new products
- Edit existing products
- Delete products
- View statistics
- Search functionality
## โ๏ธ Technical Details
- Frontend: HTML, CSS, JavaScript
- Backend: Node.js with Express
- Data Storage: JSON file
- API: RESTful endpoints
## ๐ค AI Assistance
This project was developed with significant help from AI tools as part of the learning process. The code structure and implementation were guided by AI while learning JavaScript and web development concepts.
## ๐ง Code Status
The current codebase is a working prototype but needs significant refactoring:
- Code organization needs improvement
- Better separation of concerns needed
- Comments and documentation to be added
- Error handling could be enhanced
- Security features to be implemented
## ๐ฆ Installation
1. Clone the repository
```bash
git clone [repository-url]
```
2. Install dependencies
```bash
npm install express cors
```
## ๐ฎ Running the Project
1. Navigate to the project directory
```bash
cd market
```
2. Start the server
```bash
node server.js
```
3. Access the application
- Open your browser and go to `http://localhost:3000`
4. Default Admin Credentials
```json
{
"username": "admin",
"password": "123456"
}
```
## ๐ง Requirements
- Node.js
- NPM
- Modern web browser
## ๐ฅ Contributing
Feel free to fork, modify, and make pull requests. As this is a learning project, any input or suggestions are welcome!
## ๐ Note
This project is not intended for production use. It's a learning tool and demonstration of basic web development concepts.
## ๐ Acknowledgments
Special thanks to [รtalo](https://github.com/Italo-Schezar), a friend of mine that gave me the idea of this project and to ChatGPT/Claude because... well... LOL