# A-Share Analysis

A read-only A-share market overview and analysis tool.

## 当前阶段

项目正在建立工程基线，首个业务模块为市场综合概览。当前不包含用户体系、订阅与支付。

## Projects

- `web/`: Vue 3 market terminal frontend.
- `server/`: NestJS API, scheduler, and workers. Added in a later module.
- `deploy/`: MySQL, Redis, and RabbitMQ deployment configuration. Added with the backend module.
- `docs/`: Product and implementation specifications.

The first implementation slice is the market overview screen in `web/`.

## 开发入口

- [文档索引](docs/index.md)
- [代码开发规范](docs/governance/code-development-standards.md)
- [开发流程规范](docs/governance/development-workflow.md)
- [系统架构](docs/architecture/system-architecture.md)

开始任何模块前，先阅读根目录 `AGENTS.md`，然后运行：

```bash
npm run governance:start -- FEAT-MO-001 market-overview
```

## 项目仓库

- Gitea：<https://git.foximao.com/FoXiMao/a-share-analysis>
- 远程名：`origin`
- 配置范围：仅当前项目的 `.git/config`，不修改 Git 全局配置。

凭据不写入仓库、文档或远程 URL。首次需要认证时由 Git 调用 macOS Keychain
安全保存；详细规则见 [Git 与 Gitea 规范](docs/governance/version-control-and-gitea.md)。

验证通过的中文提交必须立即同步当前分支到 Gitea；本次创建的版本标签单独同步。远程同步失败时，开发任务保持未完成状态。