| extractionMethod | Description |
|---|---|
| NUMERIC_CLASSIFICATION | This extraction method is used for handwritten digits 0 to 9. |
| CELL_OMR | This extraction method is used for omr detection. Added experimentalOMRDetectionflag to support OMR filled with pencil,any color ball pens. |
| BLOCK_ALPHANUMERIC_CLASSIFICATION | This extraction method is used for Alphanumeric detection . For example Address filed can hold block letters with digits. This feature is available from v1.5.6 release and above. |
Alignment Circle Radius Width – 36px & Height 36px Border Radius – 100px or use directly Circle shape. These alignment circles should be present in the corners of the overall table area to be able to facilitate scanning the sheet.
Box for informational fields(Can’t be scanned): Width – 26px & Height 26px Border Color - #C2C2C2 Fill Color - #ffffff
Box for Handwritten Digit or Block Letter: Width – 21px & Height 26px Border Color - #C2C2C2 Fill Color - #ffffff
OMR Bubble Width – 12px & Height - 12px Border Radius – 100px or use directly Circle shape Fill Color - #ffffff, Border Color - #C2C2C2
Row & Column Width – 41px, Height-41px Border – 1px, Border Color - #000
**Text** Font Name – “Noto Sans”, Color- #707070, Font Size – 9px (Optional, can use other fonts and colors)
**Page Size** – Custom Size, Maximum Dimension In MM - Maximum Width – 842 mm & Maximum Height- 595 mm Dimension In Inch - Maximum Width – 33 inch & Maximum Height- 24 inch Dimension In Pixel (300ppi/dpi) - Maximum Width – 3182 pixel & Maximum Height- 2248 pixel Mode - Landscape
Refer some of the layouts designed and used in `Saral` implementations.
 
 
# Firebase setup for Saral App Telemetry
Firebase setup for Saral App Telemetry
## **Setup react native side**
Some libraries have to be installed to add firebase Google Analytics and firebase Google Crashlytics in react native
```
npm i @react-native-firebase/app
npm i @react-native-firebase/analytics
npm i @react-native-firebase/crashlytics
```
### **Add In your module (app-level) Gradle file under dependencies**
```
implementation "com.google.firebase:firebase-iid:21.1.0"
implementation "com.google.firebase:firebase-bom:31.2.2"
implementation 'com.google.firebase:firebase-analytics'
implementation ('com.google.firebase:firebase-iid:21.1.0'){
transitive = true}
```
### **On the top of (app-level) Gradle file add this line**
```
apply plugin: 'com.google.gms.google-services'
apply plugin: 'com.google.firebase.analytics'
apply plugin: 'com.google.firebase.crashlytics'
```
### **Add In your root-level (project-level) Gradle file under dependencies**
```
classpath("com.google.gms:google-services:4.3.3")
classpath "com.google.firebase:firebase-iid:19.0.0"
classpath 'com.google.firebase:firebase-crashlytics-gradle:2.7.1'
```
### **Add In your frontend/SaralApp/android/app/src/main/AndroidManifest.xml**
```
< meta-data android:name="firebase_analytics_collection_enabled" android:value="true" />
< meta-data android:name="firebase_crashlytics_collection_enabled" android:value="true" />
```
### **To link the app to firebase, go to the firebae console and make project**
[firebase console](https://firebase.google.com/)
### **To link the app after the project is created**
Add google-service.json under android/app
## **Firebase Analytics Run time configuration**
For enable or disable at run time environment firebase\_analytics\_collection\_enabled in App.js file **frontend/SaralApp/App.js**
You need to add flag **isFBAnalyticsEnabled** in login api
> > /schools/login
Response from api
> > "school": { "storeTrainingData": true, "name": "Dummy school 4", "schoolId": "u002", "state": "up", "district": "district1", "autoSync": true, "autoSyncFrequency": 900000, "tags": true, "autoSyncBatchSize": 10, "offlineMode": true, "isAppForceUpdateEnabled": false, "isFBAnalyticsEnabled": true, "userId": "u002" }
Add in code useEffect(async()=>{ let hasFBAnalytics = await getLoginData();
```
const hasFBAnalyticsValue = hasFBAnalytics.school && hasFBAnalytics.school.enableFBAnalytics
if(hasFBAnalyticsValue != null){
if (__DEV__) {
analytics().setAnalyticsCollectionEnabled(hasFBAnalyticsValue);
crashlytics().setCrashlyticsCollectionEnabled(hasFBAnalyticsValue);} else{
analytics().setAnalyticsCollectionEnabled(hasFBAnalyticsValue);
crashlytics().setCrashlyticsCollectionEnabled(hasFBAnalyticsValue);}}},[])
```
**DEV** variable. By default if you run your app with **npx react-native run-android**, it will run in Debug mode and **DEV** will be true. In release mode, **DEV** will be false.\
Here **hasFBAnalyticsValue** is the flag which will come from backend as boolean.\
**If mobile is not connected with internet then data will not pushed to the firebase**
After adding all dependencie rebuild the app using **npx react-native run-android**
## **Firebase Pricing plans**
Get started at no cost,then pay as you go.\
Firebase service will be free of cost for some time but after some time events triggered it will be chargeable\
Here is the link for know all plans [pricing plans](https://firebase.google.com/pricing#blaze-calculator)
# Firebase setup for TFLite model deployment
Firebase setup for TFLite model deployment
### **Firstly We need an account of firebase to publish and download TFLite model**
version: '2.4'
services:
sandbox:
image: jonathanrogers/saral-backend:v1.7.0
container_name: sandbox
environment:
- PROFILE=dev
- PORT=3005
- MONGODB_URL=mongodb://<Insert your actual Mongo DB IP here>:27017/saralv1newdb
- JWT_SECRET=SARALDATA_NODE
- MONGODB_POOL_SIZE=50
- MIN_MONGODB_POOL_SIZE=30
- WHITELIST_DOMAINS=<add your domain/subdomain name here(eg: https://your-domain-name.com)>
ports:
- "3005:3005"
| Sr No | Name of Resource Provisioned |
|---|---|
| 1 | EKS cluster with fargate Nodes |
| 2 | VPC |
| 3 | Subnets (2-Private and 2-Public subnet for EKS cluster 2-Private subnets for Document DB) |
| 4 | Application load balancer controller |
| 5 | NAT gateway |
| 6 | Elastic IP |
| 7 | AWS document DB |
Saral AWS reference Architecture
| No | Resource Name | What it hosts | Environment | Resource Type | Configuration | Monthly Cost in USD | Usage Scenario |
|---|---|---|---|---|---|---|---|
| 1 | Saral-Sandbox-Instance | Backend (Saral Node application) | Sandbox | EC2 Instance | Instance Type t3a.medium | Family: t3a | 2 vCPU | 2 GiB Memory Storage GP3: 30GB" | $20.70 | |
| 2 | Saral-Sandbox-DB-Instance | Mongo DB | Sandbox | EC2 Instance | Instance Type t3a.medium | Family: t3a | 2 vCPU | 2 GiB Memory Storage GP3: 30GB" | $20.70 | |
| 3 | Saral-Sandbox-Elastic IP for DB-Instance and Sandbox-Instance | Elastic IP | Sandbox | Public static IP | $7.20 |
| No | Resource Name | What it hosts | Environment | Resource | Configuration | Monthly Cost in USD | Usage Scenario | |
|---|---|---|---|---|---|---|---|---|
| 1 | Amazon EKS | EKS Controle Plane | Production | EKS Cluster | NA | $73.00 | ||
| 2 | AWS Fargate Nodes | Backend (Saral Node application) | Production | Fargate nodes | 6 | $56.79 | 3,000 Users (with peak concurrency of 500-1000 users) can Successfully Login and Submit the Marksheet for 4,50,000 Students at a 1500 students save per second. Test Duration 5 Minutes with average response time of 10-20 Seconds with 100% Success rate | |
| 3 | Network Address Translation (NAT) Gateway | Elastic IP | Production | NAT gateway | 1 | $41.72 | ||
| 4 | Application Load Balancer | Load balancer | Production | Load balancer | 1 | $29.13 | ||
| 5 | Amazon DocumentDB (with MongoDB compatibility) | Mongo DB | Production | Database | 1 | $235.45 |
t3a.Medium | Family: t3a
2vCPU 8 GiB Memory
Storage GP3: 30GB
t3a.Medium | Family: t3a
2vCPU 8 GiB Memory
Storage GP3: 30GB
Ec2 instance with Mongodb ( Compute Savings Plans
automatically applies to all usage on EC2
Reservation term
1 year)
1 (m5a.xlarge)
storage:100gb
Virtual Private Cloud Cost
2xNAT Gateway for Public Subnet with 100GB of data transfer = $92.96
Inbound Data Transfer = 1 TB = $0
Outbound Internet Data Transfer = 100GB = $12.93
Intra Region Data Transfer (Across Availability Zones) = 100GB = $2