CaiWuXiTong/README.md

CaiWuXiTong 财务系统

本项目基于 Akaunting 二次开发，包含统一系统设置、用户和侧边栏管理、多个只读云数据库来源，以及财务业务页面。

开发者快速开始

1. 启动 Docker Desktop。
2. 在仓库根目录执行：

bash deploy/local-init.sh --build

3. 打开 http://127.0.0.1:18088。
4. 首次从脚本提示的本机私有凭据文件读取临时账号并登录；不要把内容发到聊天或提交到 Git。
5. 打开“系统设置 → 数据库管理 → 系统数据库”。
6. 填写负责人提供的财务系统配置数据库并点击“测试并安全切换”。
7. 使用系统数据库中属于自己的账号重新登录。

完成系统数据库配置后，用户、侧边栏、系统设置和云数据库登记会自动统一。不需要再次填写两个云数据库密码，也不要复制生产环境或其他开发者的 APP_KEY、.env。

完整步骤和排错说明见 LOCAL_DEPLOY.md。

数据库边界

• 本机 MySQL 只负责第一次启动和临时登录，不是团队业务数据源。
• 系统数据库统一保存应用用户、系统设置、侧边栏配置和云数据库连接记录。
• 云数据库属于只读上游，业务必须经过固定适配器、允许范围和本地快照读取。
• 系统数据库不代理 SQL Server 网络。每台开发机仍需具备到上游端点的网络连通性。
• 不得把数据库密码、连接串、生产 APP_KEY、Token、SSH 私钥或 runtime/.env 提交到 Git。

开发和发布

• 团队协作与安全规则：AGENTS.md
• 本地测试环境：LOCAL_DEPLOY.md
• 开发和正式部署：docs/开发与部署SOP.md
• 上游业务接入规范：docs/ecommerce-finance-development.md
• 视觉规范：DESIGN.md

正式发布只能使用已经合并的 main，并通过 scripts/deploy-from-workstation.ps1 在开发机构建提交 SHA 镜像。生产服务器只运行镜像，不执行源码构建。

技术基础

• PHP 8.3
• Laravel
• Vue
• Apache
• MySQL / MariaDB
• Docker
• Akaunting

上游 Akaunting 的版权和许可证信息见 LICENSE.txt。