https://github.com/devmount/sales
A service sales manager made for freelancers.
https://github.com/devmount/sales
filament freelancing hacktoberfest laravel sales sales-analysis sales-tax
Last synced: 7 months ago
JSON representation
A service sales manager made for freelancers.
- Host: GitHub
- URL: https://github.com/devmount/sales
- Owner: devmount
- License: mit
- Created: 2023-08-22T15:59:24.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-06T07:25:02.000Z (7 months ago)
- Last Synced: 2025-03-17T03:11:43.949Z (7 months ago)
- Topics: filament, freelancing, hacktoberfest, laravel, sales, sales-analysis, sales-tax
- Language: PHP
- Homepage:
- Size: 3.88 MB
- Stars: 16
- Watchers: 3
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sales
A service sales manager especially for freelancers. Built in German, available in English too.
## Features
- A dashboard showing current trends and tax data
- Keep track of clients
- Create projects for clients and provide estimations
- Create invoices and fill them with descriptive positions
- PDF export invoices from projects
- Keep track of expenses
- Keep track of gifts/donations (e.g. if you're an OS maintainer)
- Anonymize data in staging/dev environments
## Setup
Prerequisites:
- PHP 8.2 or later
- PHP extensions: mbstring, zip, xml, curl, dom, intl, mysql
- Composer 2.5 or later
```bash
git clone https://github.com/devmount/sales # get files
cd sales # switch to app directory
composer install # install dependencies
cp .env.example .env # init environment configuration
touch database/database.sqlite # create database file (or setup your database of choice)
php artisan migrate # create database structure
php artisan key:generate # build a secure key for the app
php artisan db:seed # create initial admin user
npm i
```
## Commands
To anonymize all personal data, run the following command:
```bash
php artisan db:anonymize
```
## Development
To start a local development server, run:
```bash
php artisan serve
```
Now you can log in on with the initial admin user credentials (email: `admin@example.com`, password: `Joh.3,16`).
## Production
To build the application for production, run:
```bash
composer install --optimize-autoloader --no-dev
php artisan config:cache # combine all configuration files into a single, cached file
php artisan route:cache # reduce all route registrations into a single method call within a cached file
php artisan view:cache # precompile all blade views
php artisan icons:cache # precompile all icons
npm run build
```
In `.env` set `APP_DEBUG` to false and `APP_URL` to your production url. Change more values if needed.
The webserver should be configured to serve the `public/` directory as root.
If you don't have composer installed on your webserver (e.g. because you are restricted by your provider), you can download a portable version into the project root:
```bash
wget https://getcomposer.org/download/latest-stable/composer.phar
chmod +x composer.phar
php composer.phar # use composer commands like this
```
## License
This project is a filament / Laravel framework based open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).