Code-naamgeving Conventies

---

Samenvatting

In WATCH worden projecten, medewerkers, relaties en andere entiteiten geïdentificeerd met een code. Een goede naamgeving maakt het systeem overzichtelijk en voorkomt verwarring. Dit artikel beschrijft aanbevolen conventies.

---

Technische regels

• Maximaal 50 tekens per code
• Toegestaan: letters, cijfers, underscore (_) en koppelteken (-)
• Geen spaties toegestaan
• Codes moeten uniek zijn per entiteit

Vuistregels

1. Kort en leesbaar — maximaal 15-20 tekens in de praktijk
2. Consistent — kies een format en houd je eraan
3. Herkenbaar — gebruik ANWB_FOLDER in plaats van 0034
4. De code = de identiteit — medewerkercode is tevens de inlognaam en verschijnt in alle rapportages

---

Aanbevolen formats per entiteit

Projectcodes

Strategie	Format	Voorbeeld	Geschikt voor
Klant + omschrijving	KLANT_PROJECT	ACME_WEBSITE	Kleine organisaties
Klant + jaar	KLANT_PROJECT_JAAR	ACME_WEBSITE_2026	Jaarlijks terugkerende projecten
Volgnummer + klant	JJJJNNN_KLANT	2026001_ACME	Grote organisaties met veel projecten
Afkorting + type	TYPE_KLANT_NR	ADV_ACME_001	Organisaties met projecttypes

Tip: Begin het projectnummer met een jaartal (bijv. 2026001) zodat projecten automatisch chronologisch sorteren.

Projectonderdeelcodes

Strategie	Voorbeeld	Toelichting
Activiteit	ANALYSE, ONTWERP, BOUW, TEST	Per fase/activiteit
Functioneel	HOMEPAGE, BACKEND, DATABASE	Per deliverable
Tarief	SENIOR_CONSULTANCY, JUNIOR_CONSULTANCY	Bij verschillende uurtarieven
Combinatie	FASE1_ANALYSE, FASE2_BOUW	Bij grote projecten

Medewerkcodes

Strategie	Format	Voorbeeld
Initialen + achternaam	j.jansen	Kleine organisatie
Personeelsnummer	MDW001	Grote organisatie
Voornaam	JAN, MARIEKE	ZZP / zeer klein

Relatiecodes (klanten)

Strategie	Format	Voorbeeld
Bedrijfsnaam	ACME_BV	Standaard
Afkorting	ACM	Bij lange namen
Klantnummer	KL_00234	Grote klantenbestanden

---

Automatische code-generatie (V6.7+)

Sinds versie 6.7 kan WATCH codes automatisch genereren uit namen:

Mechanisme	Wat het doet
Spatie → underscore	Bij plakken van een naam in een codeveld worden spaties automatisch vervangen door underscores
Optioneel: hoofdletters	Tekst wordt automatisch naar hoofdletters geconverteerd

Instelling: Configureerbaar via systeeminstellingen.

Standaardprojecten met jaarlijkse indexering

Gebruik standaardprojecten als sjabloon. Bij jaarlijkse tariefwijziging maak je een nieuw standaardproject:

CONSULTANCY_2026
├── SENIOR_CONSULTANCY_2026    (€150/uur)
├── JUNIOR_CONSULTANCY_2026    (€110/uur)
└── ADMINISTRATIEF_2026        (€70/uur)

CONSULTANCY_2027
├── SENIOR_CONSULTANCY_2027    (€160/uur)
├── JUNIOR_CONSULTANCY_2027    (€115/uur)
└── ADMINISTRATIEF_2027        (€75/uur)

WATCH herkent projectonderdelen met dezelfde naam maar ander jaartal en kan bestaande automatisch sluiten bij het aanmaken van nieuwe.

---

Factuurnummering

WATCH genereert automatisch volgnummers. Aanbevolen format:

2026001, 2026002, 2026003, ...

Begin het jaar met het eerste nummer (bijv. 2026001) en de applicatie genereert de rest automatisch. Dit zorgt voor chronologische en alfabetische ordening.

---

Gerelateerde documentatie

• Beginnen met urenregistratie
• Standaardprojecten en projecten kopiëren
• Projectstructuur-patronen per branche