fixed rout

2026-01-23 00:53:35 +04:00
parent 2e516fa4d3
commit 34f6c80e57
45 changed files with 0 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,175 @@
+# FastCheck - СБП Payment System
+
+FastCheck is an online payment system that allows users to create and manage payment checks with СБП (Faster Payment System).
+
+## Features
+
+- ✅ QR Code Authentication
+- ✅ Balance Management
+- ✅ Create FastCheck with custom amount
+- ✅ Accept FastCheck with number and PIN
+- ✅ View Active Checks
+- ✅ Transaction History
+- ⏳ Bank Integration (To be implemented)
+
+## Tech Stack
+
+- **Framework**: Angular 21
+- **Language**: TypeScript
+- **Styling**: SCSS
+- **HTTP Client**: Angular HttpClient
+- **QR Code**: angularx-qrcode
+- **API**: RESTful API (api.fastcheck.store)
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (v18 or higher)
+- npm (v10 or higher)
+
+### Installation
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm start
+
+# The app will run on http://localhost:4200
+```
+
+### Build
+
+```bash
+# Production build
+npm run build
+
+# Output will be in dist/ folder
+```
+
+## Project Structure
+
+```
+src/
+├── app/
+│   ├── components/
+│   │   ├── login/              # QR login with polling
+│   │   ├── dashboard/          # Main dashboard
+│   │   ├── active-checks/      # Active FastChecks list
+│   │   └── history/            # Transaction history
+│   ├── services/
+│   │   ├── api.service.ts      # HTTP client wrapper
+│   │   ├── auth.service.ts     # Authentication logic
+│   │   └── fastcheck.service.ts # FastCheck operations
+│   ├── models/                 # TypeScript interfaces
+│   ├── guards/                 # Route guards
+│   └── app.routes.ts           # Route configuration
+```
+
+## API Documentation
+
+### Implemented APIs
+
+- ✅ `GET /ping` - Check server availability
+- ✅ `GET /websession` - Create QR session
+- ✅ `GET /websession/:id` - Check login status (polling)
+- ✅ `DELETE /websession/:id` - Logout
+- ✅ `POST /fastcheck` - Create new FastCheck
+- ✅ `POST /fastcheck` - Accept FastCheck
+- ✅ `GET /fastcheck` - Check FastCheck status
+
+### Missing APIs (Mocked in Frontend)
+
+See `public/missing-apis.txt` for complete specifications:
+
+- ❌ `GET /balance` - Get user balance
+- ❌ `GET /fastcheck/active` - Get active checks
+- ❌ `GET /fastcheck/history` - Get transaction history
+
+**Note**: These APIs are currently mocked in the frontend. The backend team needs to implement them.
+
+## Features Overview
+
+### 1. Authentication
+- Scan QR code with mobile app
+- Auto-polling every 2 seconds
+- Session management with sessionStorage
+
+### 2. Dashboard
+- View current balance
+- Create new FastCheck
+- Accept existing FastCheck
+- FastCheck format: `xxxx-xxxx-xxxx`
+- Code format: `xxxx`
+
+### 3. Active Checks
+- View all unused FastChecks
+- Copy number and code to clipboard
+- See expiration dates
+
+### 4. Transaction History
+- View used/expired checks
+- Filter by created/accepted
+- See timestamps
+
+### 5. Balance Top-Up (To be implemented)
+- Bank integration needed
+- Will redirect to bank payment page
+- Auto-refresh balance after payment
+
+## Development Notes
+
+### Mock Data
+
+The following services return mock data:
+- `getBalance()` - Returns 150,000 RUB
+- `getActiveFastChecks()` - Returns 2 sample active checks
+- `getFastCheckHistory()` - Returns 2 sample history records
+
+Replace the mocked `of()` observables with real API calls once backend is ready.
+
+### Environment Configuration
+
+Update `src/environments/environment.ts` for different API URLs:
+
+```typescript
+export const environment = {
+  production: false,
+  apiUrl: 'https://api.fastcheck.store'
+};
+```
+
+## Backend Requirements
+
+Backend team needs to implement:
+
+1. **Balance API** - `GET /balance`
+2. **Active Checks API** - `GET /fastcheck/active`
+3. **History API** - `GET /fastcheck/history`
+4. **Bank Integration** - Payment gateway integration
+
+See `public/missing-apis.txt` for detailed API specifications.
+
+## Security Notes
+
+- SessionId stored in sessionStorage (clears on tab close)
+- All authenticated requests include Authorization header
+- FastCheck codes are sensitive - handle securely
+- Implement HTTPS in production
+
+## Browser Support
+
+- Chrome (latest)
+- Firefox (latest)
+- Safari (latest)
+- Edge (latest)
+
+## License
+
+Private - 4Pay
+
+## Contact
+
+For questions or issues, contact: sdarbinyan@4pay.ru