Alpha Platform Guides

What is Alpha Testing?

The FinAegis platform is currently in alpha testing phase, which means:

• All transactions and balances are simulated (no real money)
• Features are being actively developed and may change
• Some functionality may be incomplete or unstable
• Your feedback helps shape the platform

Creating Your Test Account

Follow these steps to create an alpha testing account:

1. Click "Register" on the homepage
2. Use a test email address (can be your real email)
3. Create a password (this is for testing only)
4. Explore the demo dashboard with simulated data

Note: No real identity verification is required during alpha testing.

Available Features in Alpha

Currently available for testing:

• User registration and authentication
• Dashboard with simulated account data
• GCU concept demonstration
• Basic API endpoints (12 endpoints)
• Admin panel (for authorized testers)

Local Development Environment

Set up FinAegis locally for development:

Tech Stack Overview

FinAegis is built with:

Contributing Guidelines

How to contribute to FinAegis:

1. Fork the repository on GitHub
2. Create a feature branch (git checkout -b feature/your-feature)
3. Make your changes and test thoroughly
4. Run tests (./vendor/bin/pest)
5. Commit with clear messages
6. Push to your fork and create a pull request

Simulated Transactions

Testing transaction flows:

• All balances are simulated (starting with demo funds)
• Transactions don't involve real money or banks
• Currency conversions use demo exchange rates
• Transaction history is for demonstration only

Feel free to test all transaction types without worry - nothing is real!

API Testing

Testing the REST API:

1. Register for an account to get API access
2. Use the API documentation at /developers/api-docs
3. Test with tools like Postman or curl
4. All API responses use simulated data

GCU Demo Features

Exploring the Global Currency Unit concept:

• View the current GCU composition (demonstration values)
• See how democratic voting will work (UI preview only)
• Test currency conversion with GCU
• Understand the multi-currency basket concept

Note: Actual voting functionality will be implemented in beta phase.

Reporting Bugs

Found a bug? Here's how to report it:

1. Check if the issue already exists on GitHub
2. Create a new issue with a clear title
3. Provide steps to reproduce the bug
4. Include error messages or screenshots
5. Mention your environment (OS, browser, etc.)

Feature Requests

Have an idea for a new feature?

• Check our roadmap to see if it's planned
• Create a GitHub issue with [Feature Request] tag
• Describe the feature and its benefits
• Provide use cases and examples
• Join the discussion on existing requests

Community Discussion

Join our community:

• GitHub Discussions for general topics
• Email [email protected] for direct feedback
• Star the repository to show support
• Share the project with other developers