Update: README
- Update `README` to make it more readable - Add screenshot to `README`
This commit is contained in:
parent
7bcc5091bc
commit
1e54494317
107
README.md
107
README.md
@ -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
|

|
||||||
|
|
||||||
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)
|
||||||
|
BIN
extra/AssetTrack_Screenshot1.png
Normal file
BIN
extra/AssetTrack_Screenshot1.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 126 KiB |
Loading…
Reference in New Issue
Block a user