# SalesCRM 项目导读

- 项目名称：SalesCRM 销售客户管理系统
- 项目类型：内部 Web CRM 与销售执行协作系统
- 仓库：`https://git.boborobots.com/r/o3hb/sales-crm.git`
- 默认分支：`main`
- 当前版本：`0.1.0` 演示原型
- 当前发布结论：`No-Go`，完成 P0 安全与数据治理前不得作为正式生产系统上线

## 项目目标

建立覆盖客户、跟进、报价、成交、销售订单、生产、库存、物流、应收和权限管理的内部协作系统，并把当前单文件演示原型逐步改造成可维护、可测试、可安全部署的正式应用。

## 当前目录

```text
SalesCRM/
├── AGENTS.md                         Agent 统一入口
├── 项目导读.md                       项目总入口
├── 全局约束.md                       全角色红线
├── outputs/                          当前前端页面
├── work/                             当前 Node.js 后端与本地脚本
├── data/                             当前 JSON 运行数据（待迁出 Git）
├── deploy/                           部署与备份脚本
├── tools/                            数据导入和辅助工具
└── docs/
    ├── 研发体系/                     流程、角色、模板
    ├── 任务/                         统一计划、协作事件、任务档案
    ├── 架构/                         现状和改造路线
    ├── 环境/                         非敏感运行说明
    └── local/                        本机敏感资料，Git 忽略
```

## 核心入口

| 内容 | 入口 |
| --- | --- |
| 项目全局规则 | [全局约束](<./全局约束.md>) |
| 研发体系说明 | [研发体系导读](<./docs/研发体系/导读.md>) |
| 唯一开发流程 | [开发迭代流程](<./docs/研发体系/开发迭代流程.md>) |
| 角色与签字权 | [角色协作宪章](<./docs/研发体系/角色协作宪章.md>) |
| 活跃任务和下一棒 | [统一计划台账](<./docs/任务/统一计划台账.md>) |
| 跨角色责任转移 | [协作事件](<./docs/任务/协作事件.md>) |
| 角色会话串行调度 | [角色会话串行调度规范](<./docs/研发体系/角色会话串行调度规范.md>) |
| 各角色执行队列 | [角色任务队列](<./docs/任务/角色队列/导读.md>) |
| 当前架构风险 | [系统现状与改造路线](<./docs/架构/系统现状与改造路线.md>) |
| 产品基线 | [销售客户管理系统V1需求方案](<./outputs/sales_crm_v1_requirement.md>) |
| 上线待决策 | [上线前待确认事项](<./docs/pre_launch_decisions.md>) |

## 当前技术基线

- 前端：原生 HTML/CSS/JavaScript，主页面约 2361 行。
- 后端：Node.js 原生 `http/fs/path`，主程序约 1063 行。
- 数据：单个 JSON 文件整体读写。
- 鉴权：当前为可逆 Base64 Token 和明文密码，必须整改。
- 部署：Windows 批处理；Linux 使用 Nginx + systemd。
- 测试：只有 JavaScript 语法检查，没有自动化测试体系。

## 阅读顺序

新角色先读 `AGENTS.md`、本导读和全局约束，再读开发迭代流程、自己的职责卡、统一计划台账以及当前任务目录。历史文档只作为事实或背景，不自动成为新任务。