Fcorp Inc

bench get-app https://github.com/Nageshlgowda/fcorp_inc

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=Nageshlgowda%2Ffcorp_inc)](https://frappegems.com/gems/apps/Nageshlgowda/fcorp_inc)

fcorp_inc

HRMS

Installation

You can install this app using the bench CLI:

cd $PATH_TO_YOUR_BENCH
bench get-app $URL_OF_THIS_REPO --branch main
bench install-app fcorp_inc

Contributing

This app uses pre-commit for code formatting and linting. Please install pre-commit and enable it for this repository:

cd apps/fcorp_inc
pre-commit install

Pre-commit is configured to use the following tools for checking and formatting your code:

• ruff
• eslint
• prettier
• pyupgrade

  CI

This app can use GitHub Actions for CI. The following workflows are configured:

• CI: Installs this app and runs unit tests on every push to develop branch.
• Linters: Runs Frappe Semgrep Rules and pip-audit on every pull request.

License

mit

Development Commands

Initial Setup

# Initialize frappe bench
bench init frappe-bench
cd frappe-bench

# Fix MySQL client if needed(MAC)
./env/bin/pip uninstall mysqlclient
./env/bin/pip install --no-cache-dir mysqlclient

# Create new site
bench new-site fidelitus.hrms
bench --site fidelitus.hrms add-to-hosts

# Create new app
bench new-app Fcorp_inc

# Install app to site
bench --site fidelitus.hrms install-app Fcorp_inc

# List installed apps
bench --site fidelitus.hrms list-apps

Console Access

# Access Python console
bench --site fidelitus.hrms console

# Access MariaDB console
bench --site fidelitus.hrms mariadb

App Management

# Start the application
bench start

# Update Frappe (with reset)
bench update --reset

# Run migrations
bench --site fidelitus.hrms migrate

# Export fixtures
bench --site fidelitus.hrms export-fixtures --app fcorp_inc

Testing

# Allow test cases to run
bench --site fidelitus.hrms set-config allow_tests true

# Run test cases for specific doctype
bench --site fidelitus.hrms run-tests --doctype "Billing Employee Salary"

# Run all test cases for the app
bench --site fidelitus.hrms run-tests --app fcorp_inc

Logging & Debugging

# Error logging in code
frappe.log_error("log name",f"log message")
# View from UI "Error Log"

frappe.logger().error("log Name", "log message")
frappe.logger().warning("warning message")

# Log file location
/fedilitus_frappe/frappe-bench/sites/fidelitus.hrms/logs/frappe.log

# Show error dialog in UI
frappe.throw(f"Error creating user account: {str(e)}", title="User Account Creation Error")

todo

make photo mandatory in "Designation Tasks"

billing employee slary and billing employee attendce ---createaccess is given to HR(need to remoe and verify)

Billing Employee Designation Setting - uncomment // grid.df.cannotdeleterows = true;

Billing Employee-- add new form to create OT only add check box to update log and lat in Designation setting and assignment

add "designation_type" in attendace tracker while creating pending

Google OAuth Login (Gmail Login)

1. Create Google OAuth Credentials

Go to Google Cloud Console and:

1. Create a New Project (or select existing)
2. Go to APIs & Services -> OAuth consent screen
   • Choose External (or Internal if Google Workspace)
   • Fill in app name, support email, etc.

3. Go to Credentials -> Create Credentials -> OAuth Client ID

   • Application type: Web Application

   • Add Authorized Redirect URI:

     https://your-frappe-site.com/api/method/frappe.integrations.oauth2_logins.login_via_google
     

     Replace your-frappe-site.com with your actual domain, e.g. fcorptest3.m.frappe.cloud

4. Click Save and copy:

   • Client ID
   • Client Secret

2. Configure in Frappe

1. In Frappe desk, go to Settings -> Integrations -> Social Login Key (or search for Social Login Key)

2. Click New and fill in:

   Field	Value
   Social Login Provider	Google
   Client ID	(from Google Cloud)
   Client Secret	(from Google Cloud)
   Enable Social Login	checked
   Base URL	https://accounts.google.com/o/oauth2/v2/auth
   Token URL	https://oauth2.googleapis.com/token
   API Endpoint	https://www.googleapis.com/oauth2/v3/userinfo
   Redirect URL	https://your-frappe-site.com/api/method/frappe.integrations.oauth2logins.loginvia_google

3. Save - the Login with Google button will now appear on the login page.

Notes

• The Google account email must match an existing Frappe user, OR enable Allow user creation via Social Login in the Social Login Key settings.
• On Frappe Cloud: the redirect URI domain must match the site public domain exactly.