# ACC Services Pipeline Migration - Documentation Index

**Quick Navigation** for all ACC services migration documentation.

---

## 🚀 Getting Started

**New to the migration?** Start here:

1. **[Migration Summary](MIGRATION-SUMMARY.md)** ⭐ **START HERE**
   - Complete overview of the migration project
   - Current state and goals
   - Timeline and effort estimates
   - Quick start instructions

2. **[Quick Start Guide](ACC-MIGRATION-QUICK-START.md)**
   - Get started in 3 steps
   - Clone repositories
   - Analyze services
   - Begin migrating

3. **[Migration Checklist](MIGRATION-CHECKLIST.md)**
   - Per-service checklist
   - 4 key touchpoints
   - Testing and validation steps
   - Completion criteria

---

## 📋 Planning & Tracking

**Track progress and plan your work:**

4. **[Migration Tracker](AIRTABLE-MIGRATION-TRACKER.md)**
   - All 33 services listed
   - Completion status
   - Priority levels
   - Environment breakdown

5. **[Migration Plan](ACC-SERVICES-MIGRATION-PLAN.md)**
   - Detailed workflow per service
   - Batch processing strategy
   - Timeline estimates
   - Reference documentation

6. **[Migration Status Update](ACC-MIGRATION-STATUS-UPDATE.md)**
   - Current findings
   - What exists vs what's needed
   - Investigation checklist
   - Revised strategy

---

## 🔧 Technical Guides

**Detailed technical documentation:**

7. **[Pipeline Migration Guide](PIPELINE-MIGRATION-GUIDE.md)**
   - Step-by-step migration process
   - Discovery phase instructions
   - Testing and validation
   - Rollback procedures
   - Cutover strategy

8. **[Setup Complete - tbi-acc-hotel-mapping-service](SETUP-COMPLETE-tbi-acc-hotel-mapping-service.md)**
   - Reference implementation
   - Complete working example
   - Issues encountered and solutions
   - Use as template for other services

---

## 📊 Generated Reports

**Auto-generated analysis:**

9. **[ACC Services Analysis](ACC-SERVICES-ANALYSIS.md)** (Generated by script)
   - Technology stack detection
   - Framework identification
   - Existing CI/CD status
   - Dependencies and entry points

---

## 🗂️ Document Purpose Summary

| Document | Purpose | When to Use |
|----------|---------|-------------|
| **Migration Summary** | Project overview | First time, big picture |
| **Quick Start Guide** | Get started fast | Ready to begin work |
| **Migration Checklist** | Per-service tasks | During migration |
| **Migration Tracker** | Progress tracking | Daily status updates |
| **Migration Plan** | Detailed workflow | Planning and execution |
| **Status Update** | Current findings | Understanding state |
| **Pipeline Guide** | Technical details | Deep dive, troubleshooting |
| **Setup Complete** | Reference example | Template for new services |
| **Services Analysis** | Tech stack info | Service discovery |

---

## 🔗 Related Documentation

**Other relevant docs in this repository:**

- [Developer Guide](DEVELOPER-GUIDE.md) - General development practices
- [Deployment Script Guide](DEPLOYMENT-SCRIPT-GUIDE.md) - Script documentation
- [Secrets Pipeline Setup](SECRETS-PIPELINE-SETUP.md) - Secrets management
- [Quick Reference](QUICK-REFERENCE.md) - Command reference

---

## 🛠️ Tools & Scripts

**Automation scripts:**

- `../scripts/clone-acc-services.sh` - Clone all ACC service repositories
- `../scripts/analyze-acc-services.sh` - Analyze service technology stacks

**Kiro AI Resources:**

- `../.kiro/agents/circleci-pipeline-deployment-agent.json` - Automated pipeline creation
- `../.kiro/steering/circleci-pipeline-patterns.md` - CircleCI patterns and best practices

---

## 📍 External Resources

**Outside this repository:**

- **Service Inventory**: `/Users/iakpabio/Desktop/git-code/tbi-code/tbi-environments/docs/tbi-acc-services-inventory.md`
- **Values Files**: `/Users/iakpabio/Desktop/git-code/tbi-code/tbi-environments/dev/values/`
- **Secrets Files**: `/Users/iakpabio/Desktop/git-code/tbi-code/tbi-environments/dev/secrets/`
- **Service Repos**: `/Users/iakpabio/Desktop/git-code/tbi-code/tbi-acc-*/`

---

## 🎯 Recommended Reading Order

### For Project Managers
1. Migration Summary
2. Migration Tracker
3. Migration Plan

### For Developers
1. Quick Start Guide
2. Migration Checklist
3. Pipeline Migration Guide
4. Setup Complete (reference)

### For DevOps Engineers
1. Migration Summary
2. Pipeline Migration Guide
3. Setup Complete (reference)
4. Services Analysis

---

## 📞 Need Help?

1. Check the relevant guide above
2. Review the reference service: `../dev/tbi-acc-hotel-mapping-service/`
3. Check patterns guide: `../.kiro/steering/circleci-pipeline-patterns.md`
4. Ask the DevOps team

---

**Last Updated**: 2026-03-05