|
@@ -1,9 +1,12 @@
|
1
|
1
|
# ERPSAAS
|
2
|
2
|
|
3
|
|
-
|
4
|
|
-
|
5
|
|
-
|
6
|
|
-
|
|
3
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 01 46 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/5146c4db-dffc-4207-9095-2ebb80d452e1">
|
|
4
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 04 05 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/d7115830-6912-4267-ab54-17f7dbcc21cd">
|
|
5
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 23 31 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/c85862ac-62ff-4c0d-9b2a-f7393ad977ef">
|
|
6
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 24 11 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/3a4deebc-528c-4b84-91db-9f0515de883d">
|
|
7
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 24 46 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/c50a899d-ee6f-4300-92a9-4a41c5433972">
|
|
8
|
+<img width="1920" alt="Screenshot 2024-05-07 at 10 55 56 PM" src="https://github.com/andrewdwallo/erpsaas/assets/104294090/6395030a-6688-4b08-bf6c-b12b5e591b31">
|
|
9
|
+
|
7
|
10
|
|
8
|
11
|
This repo is currently a work in progress — PRs and issues welcome!
|
9
|
12
|
|
|
@@ -191,6 +194,25 @@ public static function getAllLanguages(): array
|
191
|
194
|
}
|
192
|
195
|
```
|
193
|
196
|
|
|
197
|
+## Plaid Integration
|
|
198
|
+
|
|
199
|
+To integrate [Plaid](https://plaid.com/) with your application for enhanced financial data connectivity, you must first create an account with Plaid and obtain your credentials. Set your credentials in the `.env` file as follows:
|
|
200
|
+
|
|
201
|
+```env
|
|
202
|
+PLAID_CLIENT_ID=your-client-id
|
|
203
|
+PLAID_CLIENT_SECRET=your-secret
|
|
204
|
+PLAID_ENVIRONMENT=sandbox # Can be sandbox, development, or production
|
|
205
|
+PLAID_WEBHOOK_URL=https://my-static-domain.ngrok-free.app/api/plaid/webhook # Must have /api/plaid/webhook appended
|
|
206
|
+```
|
|
207
|
+
|
|
208
|
+The `PLAID_WEBHOOK_URL` is essential as it enables your application to receive real-time updates on transactions from connected bank accounts. This webhook URL must contain a static domain, which can be obtained from services like ngrok that offer a free static domain upon signup. Alternatively, you may use any other service that provides a static domain.
|
|
209
|
+
|
|
210
|
+After integrating Plaid, you can connect your account on the "Connected Accounts" page and link your financial institution. Before importing transactions, ensure to run the following command to process the queued transactions:
|
|
211
|
+
|
|
212
|
+```bash
|
|
213
|
+php artisan queue:work --queue=transactions
|
|
214
|
+```
|
|
215
|
+
|
194
|
216
|
## Testing
|
195
|
217
|
|
196
|
218
|
This project includes testing using [Pest](https://pestphp.com/). The current
|
|
@@ -214,6 +236,7 @@ The testing process automatically handles refreshing and seeding the test databa
|
214
|
236
|
migration is required. For more information on how to write and run tests using
|
215
|
237
|
Pest, refer to the official documentation: [Pest Documentation](https://pestphp.com/docs).
|
216
|
238
|
|
|
239
|
+
|
217
|
240
|
## Dependencies
|
218
|
241
|
|
219
|
242
|
- [filamentphp/filament](https://github.com/filamentphp/filament) - A collection of beautiful full-stack components
|
|
@@ -224,6 +247,7 @@ Pest, refer to the official documentation: [Pest Documentation](https://pestphp.
|
224
|
247
|
- [akaunting/laravel-money](https://github.com/akaunting/laravel-money) - Currency formatting and conversion package for
|
225
|
248
|
Laravel
|
226
|
249
|
- [squirephp/squire](https://github.com/squirephp/squire) - A library of static Eloquent models for common fixture data
|
|
250
|
+- [awcodes/filament-table-repeater](https://github.com/awcodes/filament-table-repeater) - A modified version of the Filament Forms Repeater to display it as a table.
|
227
|
251
|
|
228
|
252
|
***Note*** : It is recommended to read the documentation for all dependencies to get yourself familiar with how the
|
229
|
253
|
application works.
|