inv-fourier-transform/Lekha-Tax-Calculator

🇮🇳 Lekha 税务计算器 (2026-27 财年)

一款注重隐私的、基于浏览器的向导工具，用于比较印度的新旧税制。

框架： React   |   打包工具： Vite   |   语言： TypeScript

Lekha 税务计算器通过一个精美的8步向导，赋能工薪阶层做出明智的财务决策。它能够即时计算、比较并推荐最优税制，且您的敏感财务数据绝不会被发送到服务器。

这是一款设计精美、速度极快的 React 应用程序，能够解析复杂的印度税法——将繁复的计算转化为可操作的、通俗易懂的洞察、假设模拟以及贴近生活的度量指标。 ## 📖 项目说明 ### 🔹 功能介绍 它通过一个直观的8步向导引导用户，收集工资、房租、投资和扣除项等信息。幕后，一个纯数学计算引擎严格按照2026-27财年的规则（包括边际减免和87A条款退税）计算新旧两种税制下的税款，并给出明确的推荐。 ### 🔹 解决的问题 ### 🔹 开发动机 该项目灵感来源于工薪专业人士每年试图解读政府税务通知的挣扎，旨在将消费级的设计、绝对的透明度以及一丝趣味性带入个人财务领域。虽然注册会计师可能更倾向于使用 Winman CA-ERP 或 Relyon 等企业级 SaaS 应用，但本工具面向大众，旨在让税务规划对每个人都触手可及。 ## 🎥 演示视频 [](https://youtu.be/OoaxD3bWJC0) ## 📸 应用截图

The dynamic Results Page highlighting the winning regime and real-world savings.

Comprehensive line-by-line comparison of gross income, deductions, and tax computations.

Interactive What-If Simulation Playground to tweak your salary and investments.

Tangible Lifestyle Equivalents turning tax savings into relatable metrics.

## ✨ 显著特点与增强功能 我们超越了基础计算器的范畴，提供了卓越的用户体验： - **🧪 假设场景模拟：** 无需重新加载或丢失状态，即可即时模拟“额外的80C投资”、“额外的NPS”或“假设的薪资增长”将如何改变最优税制的推荐结果。 - **🎓 像21岁一样解释 (ELI21) 模式：** 全局切换开关，可即时将复杂的税务术语（如 *第80CCD1B条* 或 *第87A条退税*）翻译成简单、通俗的英语，贯穿整个界面。 - **🍿 生活方式等价指标：** 将抽象的税务节省转化为具体的指标——精确显示您的税务节省相当于多少个月的高级流媒体订阅或精品咖啡。 - **📑 逐级税率细分：** 可展开的折叠面板，提供绝对的数学透明度，清晰展示您的收入如何在不同的税率区间被切分和征税。 - **💡 可操作的建议提示：** 动态的项目符号点，分析您的输入数据，建议未使用的节税空间（例如，最大化15万卢比80C额度中的剩余余额）。 - **🎉 愉悦的微交互：** 到达结果页面时，纯CSS制作的五彩纸屑落下效果，配合无缝的“一键分享结果”剪贴板功能。 ## 📂 文件夹结构 ``` TaxAppNewRules/ ├─ src/ │ ├─ components/ │ │ ├─ steps/ # Individual wizard steps (Step1Salary -> Step8OtherIncome) │ │ ├─ LivePreview.tsx # Persistent side-panel showing real-time impact │ │ ├─ Results.tsx # Comprehensive dashboard (Playground, Breakdowns, ELI21) │ │ ├─ Wizard.tsx # Step orchestration and navigation logic │ │ └─ FAQ.tsx # Contextual help module │ │ │ ├─ context/ │ │ └─ TaxContext.tsx # Global state management (useReducer pattern) │ │ │ ├─ utils/ │ │ ├─ formatCurrency.ts # Indian numbering system formatter │ │ ├─ taxCalc.ts # Shared deduction constraint logic (HRA, 80C, etc.) │ │ └─ taxEngine.ts # Pure math engine (Slabs, Age, Marginal Relief, Cess) │ │ │ ├─ App.tsx # App routing (Landing -> Wizard -> Results) │ └─ index.css # Global design tokens and root styles │ ├─ artifacts/ # Screenshots and documentation assets ├─ package.json # Project dependencies and npm scripts └─ vite.config.ts # Vite bundler configuration ``` ## ⚙️ 安装步骤 ``` # 克隆仓库 git clone https://github.com/yourusername/TaxRegimeCalculator.git cd TaxRegimeCalculator # 安装依赖 npm install # 启动开发服务器 npm run dev # 验证启动成功 # 在浏览器中打开 http://localhost:5173/ ``` ## ▶️ 执行与使用 ### 本地运行 ``` # 从项目根目录开始 npm run dev ``` **在应用中：** - 从落地页点击 **"开始计算"**。 - 按照8步向导操作，输入您的工资、奖金、房租和投资信息。观察 **实时预览** 面板如何实时更新您的潜在税负。 - 在第8步，点击 **"查看结果"** 以跳转到综合仪表板。 - 切换 **像21岁一样解释**，在 **假设场景模拟** 中进行实验，并查看详细的逐级细分。 ✅ **隐私保障：** - 该应用程序是100%客户端运行的。数据绝不会被持久化到后端数据库或通过网络请求发送。所有操作均在您的浏览器内存中完成。 ## 🛠️ 使用的技术 - ✅ **React 19**（组件架构与 Context API） - ✅ **TypeScript 6**（为复杂税务结构提供严格类型定义） - ✅ **Vite 8**（超快的热模块替换和构建） - ✅ **原生 CSS Modules**（自定义设计令牌、渐变、动画） - ✅ **ESLint**（严格的代码质量控制） ## 🚀 路线图与未来更新 - 💾 **本地存储持久化**：允许用户将会话安全地保存在 `localStorage` 中，以便稍后继续计算。 - 📉 **可视化图表**：集成 Recharts 或 Chart.js，生成漂亮的饼图来展示收入与税款的比率。 - 📱 **PWA 支持**：将计算器转变为渐进式网络应用，支持在移动设备上离线使用。 - 🖨️ **PDF 导出**：生成格式精美的详细税务对比PDF报告，供报税参考。 ## ⚠️ 免责声明 **“此工具基于公开可用的2026-27财年税务规则提供指示性的税务比较。它不构成税务建议。请就您的实际报税事宜咨询合格的注册会计师 (CA)。”** ## 📌 快速提示 - **使用假设场景滑块：** 决定是否进行最后一刻节税投资的最简单方法，是在结果页面使用模拟场景的滑块。 - **HRA 与新税制：** 请记住，您不能在新税制下申请 HRA（住房租金津贴）。应用会自动计算这一点，但您可以在第4步的实时预览面板中直观地看到其影响！ *通过绝对的透明度，赋能您的个人财务。*

标签：CSS, React, Syscalls, TypeScript, Vite, What-If模拟, 个人理财, 优化推荐, 印度税制, 受薪个人, 向导流程, 安全插件, 新税制, 无障碍访问, 旧税制, 本地计算, 比较工具, 浏览器工具, 税务优化, 税务计算, 税法比较, 网络安全, 自动化攻击, 计算器, 财务决策, 财务分析, 财务规划, 隐私保护