Skip to content

Commit 7b2de5b

Browse files
Add files via upload
1 parent b01da2c commit 7b2de5b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

81 files changed

+7849
-0
lines changed

Old banking website/v0.1/README.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# Hackathon Banking API
2+
3+
A ready-to-use banking API server for hackathon projects. This Flask-based API provides a comprehensive set of features
4+
for managing virtual currencies, wallets, and transactions.
5+
6+
## Features
7+
8+
- **Bank/Currency Management**
9+
- Setup new bank/currency name
10+
- Configure bank rules
11+
- Mint and burn currency
12+
13+
- **Wallet Operations**
14+
- Create new wallets
15+
- View wallet balances
16+
- Freeze, unfreeze, or burn wallets
17+
- Reset wallet balances
18+
19+
- **Transaction Processing**
20+
- Currency transfers with idempotency support
21+
- Transaction categorization
22+
- Transaction approval workflow
23+
- Refund requests
24+
25+
- **Role-Based Access Control**
26+
- Admin, User, and Guest roles
27+
- Proper permission enforcement
28+
29+
- **Reporting**
30+
- Public transaction logs
31+
- Private user logs
32+
- Audit logs for admin actions
33+
- Wallet leaderboard
34+
35+
- **User Management**
36+
- Password reset requests
37+
- User authentication
38+
39+
## Getting Started
40+
41+
### Prerequisites
42+
43+
- Python 3.8 or higher
44+
- PostgreSQL database
45+
- Git
46+
47+
### Installation
48+
49+
1. Clone the repository:
50+
\`\`\`
51+
git clone https://github.com/yourusername/hackathon-banking-api.git
52+
cd hackathon-banking-api
53+
\`\`\`
54+
55+
2. Create a virtual environment:
56+
\`\`\`
57+
python -m venv venv
58+
source venv/bin/activate # On Windows: venv\Scripts\activate
59+
\`\`\`
60+
61+
3. Install dependencies:
62+
\`\`\`
63+
pip install -r requirements.txt
64+
\`\`\`
65+
66+
4. Set up environment variables:
67+
Create a .env file in the root directory with:
68+
\`\`\`
69+
POSTGRESQL_DB_URL=postgresql://username:password@localhost:5432/banking_db
70+
JWT_SECRET=your_jwt_secret_key
71+
FLASK_ENV=development
72+
\`\`\`
73+
74+
5. Initialize the database:
75+
\`\`\`
76+
flask db init
77+
flask db migrate -m "Initial migration"
78+
flask db upgrade
79+
\`\`\`
80+
81+
6. Create an admin user:
82+
\`\`\`
83+
flask create-admin --username admin --password secure_password
84+
\`\`\`
85+
86+
7. Run the server:
87+
\`\`\`
88+
flask run
89+
\`\`\`
90+
91+
The API will be available at http://localhost:5000
92+
93+
## API Documentation
94+
95+
For detailed API documentation, see the [API Documentation](https://your-deployed-app.com/api-docs) page.
96+
97+
## License
98+
99+
This project is licensed under the MIT License - see the LICENSE file for details.

0 commit comments

Comments
 (0)