Update: README

- Update `README` to make it more readable
- Add screenshot to `README`
This commit is contained in:
Candifloss 2025-04-07 11:26:20 +05:30
parent 7bcc5091bc
commit 1e54494317
2 changed files with 66 additions and 41 deletions

107
README.md
View File

@ -1,45 +1,70 @@
# Python Flask CRUD Application # AssetTrack 📊
A minimal python flask app for inventory management, with some basic functionality: **Simple, Powerful, Customizable Asset Management for Teams**
- Fetch and display items from the MySQL db as an html table
- Add new items to the db (individually) using a form
- Edit existing (individual) items in the db using a form
- Delete (individual)items in the db
- Add a batch of new items from a csv file
- Edit a batch of existing items with new data from a csv file
- Let the user preview and edit the csv data in a table before submission
- Use an admin-defined configuration to decide the attributes of an item, and how to manage the db and data
## Acknowledgment ![AssetTrack Interface](extra/AssetTrack_Screenshot1.png)
This project was originally forked from [this project](https://github.com/MovieTone/crud-flask-export-csv), although it has undergone significant improvent, and resembles nothing like it. ## Overview
## File structure: AssetTrack is a lightweight, self-hosted inventory system for physical asset management. Designed for IT teams and small businesses, it offers enterprise-grade customization without complexity:
```
. - 🏷️ **Tailored Fields** - Adapt to any asset type through simple configuration
├── app.py # Main application file - 🔄 **CSV Power** - Bulk import/export with intelligent validation
├── config.py # Application configuration (database, item attributes) - 👥 **Team Ready** - Secure multi-user access control
├── definitions/ # Definitions for attributes and database models - 🔒 **Your Data, Your Rules** - No cloud dependencies
│ ├── attribute.py # Attribute types (text, integer, date, select) - ⚡ **Essential Only** - No bloat, just core functionality
│ └── models.py # SQLAlchemy models and dynamic table creation
├── functions/ # Helper functions Built with Python Flask and MySQL for reliability and easy self-hosting.
│ ├── process_csv.py # Extract and process CSV data
│ ├── validate_config.py # Validate configuration file ---
│ └── validate_values.py # Validate user input and CSV data
├── routes/ # Flask routes ## Key Features
│ ├── confirm_save.py # Save validated CSV data to the database
│ ├── create.py # Add new items ### Custom Data Structure
│ ├── delete.py # Delete items ✔ Define fields through simple configuration (text, numbers, dates, dropdowns)
│ ├── export_csv.py # Export data as CSV ✔ Automatic generation of:
│ ├── update.py # Edit existing items - Database schema
│ ├── upload.py # Upload and process CSV files - Web forms
│ └── viewall.py # View all items in the database - Data tables
├── static/ # Static files (e.g., JavaScript) - CSV templates
│ └── edited_csv.js # JavaScript for editing CSV preview tables
└── templates/ # HTML templates ### Bulk Operations
├── csv_preview.html # Preview and edit CSV data ✔ Import/export assets via CSV
├── delete.html # Confirm item deletion ✔ Smart validation with actionable error messages
├── item_form.html # Form for adding/editing items
├── upload.html # Upload CSV file ### Modern Interface
└── viewList.html # Home page (view all items) ✔ Clean Bootstrap 5 interface
``` ✔ Mobile-responsive design
✔ Client-side validation
---
## Technology Stack
| Component | Technology | Purpose |
|-----------------|-------------------------|-----------------------------|
| Core Framework | Python Flask | Backend logic and routing |
| Database | MySQL/MariaDB | Persistent data storage |
| Frontend | Bootstrap 5 | Responsive UI components |
| Security | Flask-Login | Authentication system |
---
## Roadmap
### Planned Features
- 🔍 Advanced search with custom filters
- 🔐 LDAP/Active Directory integration
- 🌙 Dark mode support
## Getting Started
For installation and configuration details, visit our [project wiki](https://git.candifloss.cc/assettrack/wiki).
---
## License & Copyright
© 2025 [candifloss](https://candifloss.cc)
📜 Licensed under [GNU GPLv3](/LICENSE)

Binary file not shown.

After

Width:  |  Height:  |  Size: 126 KiB