{"id":15066077,"url":"https://github.com/codebangla/invoicika","last_synced_at":"2025-10-13T05:08:24.544Z","repository":{"id":256080293,"uuid":"853945089","full_name":"codebangla/invoicika","owner":"codebangla","description":"Invoicika is an invoice mangement system software made with .NET 6.0 Web API, Angular 16 and SQL Server","archived":false,"fork":false,"pushed_at":"2024-09-19T00:02:04.000Z","size":2004,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T20:19:57.647Z","etag":null,"topics":["angular","customer","dotnet","dotnet6","entity-framework-core","invoice","invoice-management","invoice-pdf","invoice-software","invoicing","invoicing-software","ngzorro","role-based-access-control","sqlsever"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codebangla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-08T01:16:42.000Z","updated_at":"2025-03-09T07:29:56.000Z","dependencies_parsed_at":"2024-09-13T00:37:08.055Z","dependency_job_id":"345da675-bad3-4249-86a0-07b9bcf2014e","html_url":"https://github.com/codebangla/invoicika","commit_stats":null,"previous_names":["codebangla/invoicika"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codebangla/invoicika","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebangla%2Finvoicika","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebangla%2Finvoicika/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebangla%2Finvoicika/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebangla%2Finvoicika/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codebangla","download_url":"https://codeload.github.com/codebangla/invoicika/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebangla%2Finvoicika/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013693,"owners_count":26085390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","customer","dotnet","dotnet6","entity-framework-core","invoice","invoice-management","invoice-pdf","invoice-software","invoicing","invoicing-software","ngzorro","role-based-access-control","sqlsever"],"created_at":"2024-09-25T01:01:15.219Z","updated_at":"2025-10-13T05:08:24.517Z","avatar_url":"https://github.com/codebangla.png","language":"C#","readme":"![Invoicika](https://i.imgur.com/8AF7yiL.png)\n\n# **Invoicika**\n\nInvoicika is an advanced invoice management system built with Angular 16, ASP.NET Core Web API 6.0, and SQL Server. This system provides full-fledged invoicing capabilities, including unlimited invoice creation, customer management, PDF generation, and more. The frontend is built with Angular and utilizes NG-Zorro UI components for a modern, responsive design.\n\n## Features\n\n- **Create Unlimited Invoices**: Generate invoices without any restrictions.\n- **Email Invoice**: Send invoices directly to customers via email.\n- **PDF Generation**: Export invoices as PDFs for easy sharing and storage.\n- **Customer Management**: Add, edit, and manage customers with multiple shipping addresses.\n- **Authentication \u0026 Roles**: Secure login and role-based access control.\n- **Customer Product Management**: Add products linked to customers for quick access.\n- **Sign Up \u0026 Profile Management**: Users can sign up and manage their profile.\n- **Image Upload**: Upload and manage profile pictures and invoice logos.\n- **VAT Management**: Handle VAT for customer invoices.\n- **Database**: Built to work with SQL Server.\n\n![Description](https://i.imgur.com/uDmUb5U.png)\n\n## Technologies Used\n\n- **Frontend**: Angular with NG-Zorro (Responsive UI components).\n- **Backend**: ASP.NET Core Web API 6.0 (Robust and scalable API layer).\n- **Database**: SQL Server (Code First Migration).\n\n![Description](https://i.imgur.com/0dwmGY1.png)\n\n## How to Install (without Docker)\n\n### Prerequisites\n\n- **Node.js** (For Angular)\n- **SQL Server** (For database)\n- **.NET 6.0 SDK** (For ASP.NET Core)\n\n### Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/codebangla/invoicika.git\n   cd invoicika\n   ```\n\n2. **Frontend (Angular)**:\n\n   ```bash\n   cd frontend\n   npm install\n   ng serve\n   ```\n\n3. **Backend (ASP.NET Core)**:\n\n   ```bash\n   cd backend\n   dotnet restore\n   ```\n\n4. **Database Setup (SQL Server)**:\n\n   - Ensure SQL Server is installed and running.\n   - Update the connection strings in `appsettings.json` to configure your SQL Server database.\n\n     Example:\n\n     ```json\n     \"ConnectionStrings\": {\n       \"SqlServerConnection\": \"Your SQL Server connection string\"\n     }\n     ```\n\n5. **Apply Migrations**:\n   ```bash\n   dotnet ef database update\n   ```\n\n### Running the Application\n\n1. Run the **Angular frontend**:\n\n   ```bash\n   ng serve\n   ```\n\n2. Run the **ASP.NET Core backend**:\n\n   ```bash\n   dotnet run\n   ```\n\n   3. Open your browser and navigate to `http://localhost:4200` for the frontend. Login with `username: admin1, password: admin1` as admin or `username: employee1, password: employee1` as employee. The backend is at `http://localhost:5000/swagger/index.html`\n\n3. To use SMTP with Outlook, you need to generate an app password if two-factor authentication (2FA) is enabled on your Microsoft account. Follow this [guide on how to get an app password](https://support.microsoft.com/en-us/account-billing/how-to-get-and-use-app-passwords-5896ed9b-4263-e681-128a-a6f2979a7944) for detailed steps.\n\n   Make sure to replace the `\"Password\"` field in your `appsettings.js` with your generated app password.\n   In your `appsettings.js` file, use the following format to configure the SMTP server:\n\n```json\n{\n  Email\": {\n    \"SmtpServer\": \"smtp.office365.com\",\n    \"SmtpPort\": 587,\n    \"SenderEmail\": \"your-email@outlook-or-hotmail.com\",\n    \"SenderName\": \"Invoicika Team\",\n    \"SenderPassword\": \"your-app-password\"\n  }\n}\n```\n\n![Description](https://i.imgur.com/wrV0y1L.png)\n\n## How to Install (with Docker)\n\nMake sure you have Docker Desktop installed. Then run\n\n```bash\ndocker-compose up\n```\n\nYou might see the seeder failed in docker compose log. To make the seeder happend, from your Docker Desktop, stop the backend container and run it again from Invoicika.\nOpen your browser and navigate to `http://localhost:4444` for the frontend.\nLogin with `username: admin1, password: admin1` as admin or `username: employee1, password: employee1` as employee. The backend is at `http://localhost:5000/swagger/index.html`\n\n![Description](https://i.imgur.com/vNY5TTM.png)\n\n## Contributing\n\nWe welcome contributions! Please submit a pull request or report issues. Ensure your code follows the project guidelines and passes all tests before submission.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\nLet me know if you'd like any further modifications!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebangla%2Finvoicika","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodebangla%2Finvoicika","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebangla%2Finvoicika/lists"}